Annuler la transaction de connexion en cours

POST /fapi/v1/transactions/current:cancel · appelé depuis l'hôte de connexion de l'environnement

Annule la transaction en cours. La transaction passe à l'état failed et le cookie de transaction est supprimé.

Requête

En-têtes :

En-tête Obligatoire Description
Idp-Client oui Identifiant du SDK.
Origin oui Doit être exactement https://<hôte de connexion>.
Idp-Csrf-Token oui Le csrf_token de l'objet transaction.

Aucun corps.

Réponse

200 OK avec la transaction annulée.

Transactions headless 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 POST, htu cette URL) au lieu de Idp-Csrf-Token.

Erreurs

Statut Code Quand
403 origin_not_allowed Origin ou Idp-Csrf-Token est absent ou incorrect.
409 transaction_state_conflict La transaction ne peut plus être annulée.
410 transaction_expired La transaction est terminée.
401 invalid_dpop_proof La preuve DPoP est invalide ou réutilisée.

Exemple

curl -X POST https://example.keenauth.app/fapi/v1/transactions/current:cancel \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Idp-Csrf-Token: $CSRF_TOKEN" \
  -b cookies.txt