Skip to main content

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