Požadavek change-password
Změna hesla uživatele
Požadavek pro změnu přístupového hesla uživatele do systému. Slouží především pro potřeby změny hesla samotným uživatelem.
<request>
<change-password
id="{number}"
old="{string}"
new="{string}"
hash="{boolean}"
/>
</request>
Atributy
id - číslo uživatele - User ID pro správnou identifikaci souboru nastavení (statistiky).(typ: number)
old - Původní heslo - Znění původního hesla pro potvrzení oprávněnosti změny.(typ: string) TYP HODNOTY: string;
new - Nové heslo - Zadání nového hesla pro další přístupy.(typ: string) TYP HODNOTY: string;
hash - Převod vstupních dat - Funkce pro převod vstupních dat do malého čísla(typ: boolean) TYP HODNOTY: boolean;
Potomci
Požadavek change-password neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.
Poznámka k request
Není=li uveden atribut id, pak dojde ke změně vlastního hesla. Pokud je atribut id uveden (bez ohledu na jeho hodnotu) pak se jedná o pokus o administrátorskou změnu hesla. Jak už sám název napovídá, tuto změnu může provést pouze uživatel s oprávněním administrátora.
Je-li atribut "hash" uveden a ma hodnotu true, pak v attributu "new" (nove heslo) je ocekavan hash hesla, nikoli textove heslo.
Hash hesla je ocekavan hexadecimalnim tvaru a je kontrolovan. Kontrolovana je jednak prevoditelnost z hexa do bin a jednak delka. Delka musi presne odpovidat delce pouzivaneho hash.
Odpověď
Struktura odpovědi na požadavek change-password vrácená v obálce response:
<response>
<change-password
type="ok|error"
detail="{string}"
/>
</response>
Atributy
type - Obsahuje hodnoty ok nebo error (možnosti obsahu: ok | error)
detail - Upřesnění - Bližší popis vzniklé chyby. Je k dispozici při odpovědi typu 'error'.(typ: string)
Potomci
Odpověď change-password neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.
Výraz pro identifikaci chyb v odpovědi serveru: user-details[@type='error'] (odkaz na popis detailu: @detail).