API Rest - Autenticazione su Digital Archive
L'invio di una richiesta di autenticazione è documentata via SWAGGER al link
/swagger/ui/index#!/UserAuthentication/UserAuthentication_BasicAuthentication
L'autenticazione può essere effettuata attraverso la chiamata al servizio
Durante il processo di autenticazione devono essere fornite le informazioni di accesso (utente e password) di Digital Archive
Header
Non sono richiesti.
Il Content-Type deve essere application/json
Body
Il body della richiesta deve avere il seguente formato:
{
"UserName": "string",
"Password": "string",
"Options": [
{
"Name": "string",
"Value": "string"
}
]
}- Username: contiene username dell'utenza che deve effettuare il login.
- Password: contiente la password dell'utenza scelta per il login.
- Options: non sono necessari, previsti per future implementazioni
Risposte
L'operazione è avvenuta con successo se e solo se il codice HTTP della risposta è 200. Ogni altro codice di risposta indica uno stato di errore.
HTTP 200
L'operazione è avvenuta con successo e viene rilasciato il SecurityToken da utilizzare per l'autenticazione nelle chiamate alle API rest. Da considerare anche il PasswordExpirationDate che rappresenta la data di scadenza della password.
E' fondamentale valutare PasswordExpirationDate in quanto se rappresenta una data precedente alla data corrente implica che il token rilasciato è valido solo per effettuare il cambio password. In tal caso affidarsi al portale e alle pagine del front end per effettuare il cambio password. Tutte le chiamate effettuate con un token rilasciato da password scaduta andranno in errore.
Body della risposta:
{
"UserIdentity": {
"SecurityToken": "string",
"PasswordExpirationDate": "2022-02-14T08:48:20.753Z"
},
"ServiceInfo": {
"ServiceVersion": "string",
"Info": [
{
"Name": "string",
"Value": "string"
}
]
}
}HTTP 400
Uno o più parametri forniti nella richiesta sono errati, o mancano dei parametri obbligatori.
{
"code": 400,
"status": "BADREQUEST",
"error": "BadRequest",
"message": "I parametri username e password sono obbligatori",
"timestamp": "2022-02-14T12:20:47.9466829+01:00"
}HTTP 401
Le credenziali fornite non sono corrette.
{
"code": 401,
"status": "UNAUTHORIZED",
"error": "Unauthorized",
"message": "Username o password errati.",
"timestamp": "2022-02-14T10:45:44.1219662+01:00"
}HTTP 500
Il server ha riscontrato un errore inaspettato nell'esecuzione della richiesta di creazione item. Nel caso il problema si ripeta contattare l'assistenza.