Autenticazione
Sono stati implementati in WEBESSE3 i seguenti servizi per agevolare la gestione degli account da parte applicativi di terze parti.
Verifica credenziali
URL: /checkLogonService.do
metodo: POST
input: le credenziali utente passate tramite header http "Authorization: Basic ...."
output:
- codice 200: esecuzione ok
output nel body codificato in formato JSON, ad esempio: {"ok":true, "changePassword":false}- ok: indica se l'autenticazione è andata a buon fine
- changePassword: presente solo se ok vale true; indica se la password dell'utente va modificata (ad esempio se è scaduta)
- codice 401: qualora l'header "Authorization" non sia presente o contenga dati non validi
- codice 404: il metodo utilizzato non è corretto (i.e. GET invece che POST)
Modifica password utente
URL: /passwordService.do
metodo: POST
input:
- le credenziali di un utenza tecnica passate tramite header http "Authorization: Basic ...."
NB: l'utente deve poter utilizzare il tipo client WEB ed avere abilitato l'accesso alla funzione SI_18_008 - parametri codificati in formato JSON nel body, ad esempio
{
"username": "pluto",
"oldPassword": "p1pp0",
"newPassword": "Cineca2020!"
}:- user: utente per cui modificare la password
- password: password da impostare per l'utente
- old_password: (facoltativo) password attuale dell'utente; se il parametro non è presente è necessario che il parametro di configurazione PWD_CHANGE_LOW_SECURITY sia impostato nel sistema con VAL_NUM=1
output:
- codice 200: esecuzione ok
output nel body codificato in formato JSON, ad esempio: {"result":"OK"}- result: indica il risultato dell'operazione, in particolare può valere:
- OK - operazione andata a buon fine
- NO_PERMISSIONS - l'utenza tecnica non ha i diritti per la funzione SI_18_008
- EMPTY_PARAM - la password fornita è vuota
- AUTH_FAILURE - la password passata nel parametro old_password non è corretta, oppure old_password non è fornito ed il parametro PWD_CHANGE_LOW_SECURITY non è popolato correttamente
- INVALID_NEW_PASSWORD - la password non soddisfa i requisiti minimi configurati nel sistema
- ERR_1118 - la password coincide con la password precedentemente inserita nel sistema
- ERR_1003 - l'utente specificato non è presenete nel sistema
- result: indica il risultato dell'operazione, in particolare può valere:
- codice 401: qualora l'header "Authorization" non sia presente o contenga dati non validi o credenziali errate
- codice 404: il metodo utilizzato non è corretto (i.e. GET invece che POST)