Prima di poter fare qualsiasi interrogazione ad una applicazione Graphene (identificata dalla relativa api-key) è necessario effettuare il login.
Il prerequisito è che l’amministratore abbia già creato l’applicazione, il gruppo, l’utente ed aver impostato le relative ACL al gruppo
per effettuare il login, fare una chiamata POST al seguente url:
http://domain.ext/auth/login
nell’header inserire la seguente coppia chiave-valore:
api-key 01234567890123456789012345678901234567890123456789
nel body inserire la seguente struttura JSON
{
"User": {
"username": "user@domain.ext",
"password": "123456"
}
}
se username e password sono corrette otterremo il seguente messaggio di risposta:
{
"Session": {
"hostAddress": "188.217.148.113",
"hostAgent": "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.71 Safari/537.36",
"apiKey": "000033e02deba358d55b85914222c5ce2dcd52d400000",
"enabled": true,
"time": "2015-10-21 11:27:31",
"user": "USER000561f9d4e2000",
"accessToken": "0000016cc630391a8dca4f740e696d5a07837661ab32912d71f28af4bb100000",
"id": "SESSION56275a8380000",
"version": 1
}
}
da questo momento siete in possesso dell’access-token che, unitamente alla api-key ed inserite nell’header, vi permetterà di effettuare chiamate al server.
in caso di accesso negato:
{
"error": {
"message": "username or password invalid",
"errorCode": 403
}
}
Per effettuare il logout è sufficiente effettuare una chiamata GET all’indirizzo
http://domain.ext/auth/logout
il parametro access-token presente nell’header contiene la sessione di cui fare il logout.
Se il logout avviene con successo, il messaggio di risposta sarà il seguente:
{
"message": {
"message": "Logout successful"
}
}
Per scaricare Graphene Framework, vai all’indirizzo https://github.com/marcomag89/Graphene