Prima di utilizzare le API di BFC, si deve creare una sessione di autenticazione. Si crea una sessione pubblicando un nome utente e una password per la risorsa di accesso per la versione dell'API di BFC desiderata. Se il nome utente e la password sono validi, viene restituito un ID di sessione che deve essere trasmesso per ciascuna chiamata dell'API di BFC nell'intestazione Autorizzazione. Le sessioni rimangono valide per 30 minuti senza attività. Ciascuna richiesta a BFC ripristinerà il timeout di sessione a meno che l'intestazione X-CA-FC-runningClock non sia inclusa e abbia un valore true. Ciò è utile per client con chiamate di polling senza risposta a BFC. Un client può terminare una sessione pubblicando l'ID di sessione nella risorsa di disconnessione.
POST BFC/1.0/login
Tipo di contenuto:application/json
Il payload è un oggetto JSON con due campi: nome utente e password.
nome utente
Se il nome utente non è qualificato per il tenant, viene considerato il tenant principale. Attualmente, l'unico tenant disponibile in BFC è il tenant principale.
ad es. joe (o core/joe)
password
La password per l'utente.
ad es. MyPassword
{"username":"joe","password":"MyPassword"}
Il payload restituito è una stringa JSON che rappresenta l'ID di sessione. Ad esempio:
"2f9b84766cdacd376125c7d57aaf6aa7"
POST/BFC//logout
Tipo di contenuto:application/json
Autorizzazione:ID di sessione
ID di sessione
| Copyright © 2012 CA. Tutti i diritti riservati. |
|