現在のサインイントランザクションをキャンセル
POST /fapi/v1/transactions/current:cancel · 環境のサインインホストから呼び出します
現在のトランザクションをキャンセルします。トランザクションは failed 状態に移行し、トランザクション Cookie は削除されます。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK 識別子。 |
Origin |
はい | https://<sign-in host> と完全に一致する必要があります。 |
Idp-Csrf-Token |
はい | トランザクションオブジェクトの csrf_token。 |
本文はありません。
レスポンス
キャンセルされたトランザクションを含む 200 OK を返します。
DPoP バインドのヘッドレストランザクション
DPoP ヘッダーを付けて開始したトランザクションの場合は、Idp-Csrf-Token の代わりに、同じキーから新しい証明(htm は POST、htu はこの URL)を送信してください。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 403 | origin_not_allowed |
Origin または Idp-Csrf-Token がないか、不正です。 |
| 409 | transaction_state_conflict |
トランザクションはもうキャンセルできません。 |
| 410 | transaction_expired |
トランザクションは終了しています。 |
| 401 | invalid_dpop_proof |
DPoP 証明が無効、または再利用されています。 |
例
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