Požadavek cnthash
Požadavek hash funkcí
Požadavek provede nad vstupními daty zvolenou hash funkci.
Typ formátu unicode:
Hodnota unicode v atributu input a output má vliv na to, jestli se na vstupu s řetězcem pracuje jako s UTF-8, nebo UTF-16. Jeho změna nepovede k chybné unicode interpretaci textu, ale povede k vytvoření jiného výstupu. V případě porovnávání platí, že na obou stranách musí být použit stejný způsob práce s řetězcem. A to je význam této volby. Zajistit, aby obě strany pracovaly s textem stejně.
Výstupní formát:
Požadavek umožňuje provést několik po sobě jdoucích konverzí výstupu, lze si tak připravit výstup přímo pro svou potřebu. Nastavením atributu output na hodnotu "base64 url" například dojde k převodu výstupu do base64 a následné úpravy do URL kódování.
Atributy požadavku cnthash
Jde o uzel obsahující text TYP HODNOTY: string;
<request>
<cnthash
hash="sha256|sha384|sha512"
input="plain|base64|unicode|hex|url"
data="plain|base64|unicode|hex|url"
>
{string}
</cnthash>
</request>
Atributy
hash - Určuje, jaká hash funkce bude provedena, výchozí hodnotou je SHA256.(typ: string) TYP HODNOTY: string; (možnosti obsahu: sha256 | sha384 | sha512)
input - Určuje, v jakém formátu jsou dodána data pro provedení požadavku, výchozí hodnotou je plain.(typ: string) TYP HODNOTY: string; (možnosti obsahu: plain | base64 | unicode | hex | url)
data - Vstupní data pro provedení operace.(typ: string) TYP HODNOTY: string; (možnosti obsahu: plain | base64 | unicode | hex | url)
Potomci
Požadavek cnthash neobsahuje žádné další elementy. Uzel může obsahovat prostý text.
Odpověď
Jde o uzel obsahující text TYP HODNOTY: string;
Struktura odpovědi na požadavek cnthash vrácená v obálce response:
<response>
<element
type="ok|error"
>
{string}
</element>
</response>
Atributy
type - Obsahuje hodnoty ok nebo error (možnosti obsahu: ok | error)
Potomci
Odpověď element neobsahuje žádné další elementy. Uzel může obsahovat prostý text.
Výraz pro identifikaci chyb v odpovědi serveru: cnthash[@type='error'] (odkaz na popis detailu: @detail>).
Další info
Podporované hash funkce:
Požadavek podporuje kompletní seznam hash funkcí podporovaných knihovnou OpenSLL. Pro bližší informace spusťte openssl help. Níže jsou uvedeny hash funkce podporované v době vzniku dokementace, pro aktuální informace navštivte dokumentaci OpenSSL.
CRC funkce:
Nad rámec hash funkcí obsažených v knihovně OpenSSL jsou podporovány kontrolnní součty CRC32 a CRC64. Pro tyto funkce uveďte jako název hash funkce crc32, respektive crc64.