flexideo

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.

syntax 
<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:

syntax 
<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).

Požadavek get-userPožadavek change-passwordPožadavek actionPožadavek send-requestPožadavek send-messagePožadavek confirm-messagePožadavek get-messagesPožadavek tranformPožadavek set-tempPožadavek get-tempPožadavek general-lockPožadavek encryptPožadavek decryptPožadavek max-keyPožadavek reload-sslPožadavek get-versionsPožadavek uuidPožadavek cnthashPožadavek rand