Obtenir la transaction de connexion en cours
GET /fapi/v1/transactions/current · appelé depuis l'hôte de connexion de l'environnement
Renvoie la transaction vers laquelle pointe le cookie __Host-idp_ltx, y compris son état et les étapes qui peuvent être exécutées ensuite.
Utilisez-la pour reprendre une page de connexion après un rechargement.
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK, <package>/<version> (<runtime>/<version>). |
Le cookie de transaction est envoyé automatiquement par le navigateur.
Réponse
200 OK avec l'objet de transaction (schema_version, state, next_steps, csrf_token, expires_at). Chaque réponse
contient Cache-Control: no-store.
Une transaction qui demande à l'utilisateur de lier une connexion d'entreprise à un compte existant contient également account_link
(connection_name, organization_name) ; voir Exécuter une étape de connexion. La page hébergée
l'utilise avec resume=1 et la poursuit au lieu de créer une nouvelle transaction. Elle procède de la même manière après une
connexion d'entreprise qui nécessite encore un second facteur (second_factor_pending) ou une inscription (enrollment_pending).
Transactions sans interface liées à DPoP
Pour une transaction démarrée avec un en-tête DPoP, envoyez une nouvelle preuve avec la même clé (htm GET, htu cette URL) ; le
serveur renvoie la transaction non expirée la plus récente liée à cette clé. Le code d'autorisation n'est jamais renvoyé ici.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 400 | malformed_request |
Idp-Client est absent. |
| 410 | transaction_expired |
Il n'existe aucun cookie, le cookie est invalide ou la transaction est terminée. |
| 401 | invalid_dpop_proof |
La preuve DPoP est invalide ou réutilisée. |
Exemple
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Données personnelles
Ce point de terminaison contient des données personnelles : profil de l'utilisateur final. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.