Ottieni la transazione di accesso corrente
GET /fapi/v1/transactions/current · chiamato dall'host di accesso dell'ambiente
Restituisce la transazione a cui punta il cookie __Host-idp_ltx, incluso il suo stato e i passaggi che possono essere eseguiti successivamente.
Usalo per riprendere una pagina di accesso dopo un ricaricamento.
Richiesta
Header:
| Header | Obbligatorio | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK, <package>/<version> (<runtime>/<version>). |
Il cookie della transazione viene inviato automaticamente dal browser.
Risposta
200 OK con l'oggetto transazione (schema_version, state, next_steps, csrf_token, expires_at). Ogni risposta
contiene Cache-Control: no-store.
Una transazione che chiede all'utente di collegare una connessione enterprise a un account esistente contiene anche account_link
(connection_name, organization_name); vedi Esegui un passaggio di accesso. La pagina ospitata
lo raggiunge con resume=1 e lo continua invece di creare una nuova transazione. Lo stesso accade dopo un accesso enterprise
che richiede ancora un secondo fattore (second_factor_pending) o la registrazione (enrollment_pending).
Transazioni headless vincolate a DPoP
Per una transazione avviata con un header DPoP, invia una nuova prova dalla stessa chiave (htm GET, htu questo URL); il
server restituisce la transazione non scaduta più recente vincolata a quella chiave. Il codice di autorizzazione non viene mai restituito qui.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 400 | malformed_request |
Idp-Client manca. |
| 410 | transaction_expired |
Non c'è cookie, il cookie non è valido o la transazione è terminata. |
| 401 | invalid_dpop_proof |
La prova DPoP non è valida o è stata riutilizzata. |
Esempio
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Dati personali
Questo endpoint contiene dati personali: profilo dell'utente finale. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene eliminato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in alcun campo.