현재 로그인 트랜잭션 조회
GET /fapi/v1/transactions/current · 환경의 로그인 호스트에서 호출됩니다
__Host-idp_ltx 쿠키가 가리키는 트랜잭션을 반환합니다. 여기에는 트랜잭션의 상태와 다음에 실행할 수 있는 단계가 포함됩니다.
새로고침 후 로그인 페이지를 다시 시작하려면 이 API를 사용하십시오.
요청
헤더:
| 헤더 | 필수 | 설명 |
|---|---|---|
Idp-Client |
예 | SDK 식별자, <package>/<version> (<runtime>/<version>). |
트랜잭션 쿠키는 브라우저가 자동으로 전송합니다.
응답
트랜잭션 객체(schema_version, state, next_steps, csrf_token, expires_at)와 함께 200 OK 응답을 반환합니다. 모든 응답에는 Cache-Control: no-store가 포함됩니다.
사용자에게 엔터프라이즈 연결을 기존 계정에 연결하도록 요청하는 트랜잭션에는 account_link(connection_name, organization_name)도 포함됩니다. 자세한 내용은 로그인 단계 실행을 참조하십시오. 호스팅 페이지는 resume=1로 이 트랜잭션에 접근하며, 새 트랜잭션을 만들지 않고 이를 계속 진행합니다. 엔터프라이즈 로그인 후에도 두 번째 인증 요소(second_factor_pending) 또는 등록(enrollment_pending)이 필요한 경우에도 같은 방식으로 처리됩니다.
DPoP 바인딩 헤드리스 트랜잭션
DPoP 헤더로 시작한 트랜잭션의 경우, 같은 키에서 새 증명을 전송하십시오(htm GET, htu 이 URL). 서버는 해당 키에 바인딩된 가장 최근의 만료되지 않은 트랜잭션을 반환합니다. 이 엔드포인트에서는 인가 코드를 반환하지 않습니다.
오류
| 상태 | 코드 | 발생 조건 |
|---|---|---|
| 400 | malformed_request |
Idp-Client가 없습니다. |
| 410 | transaction_expired |
쿠키가 없거나, 쿠키가 유효하지 않거나, 트랜잭션이 종료되었습니다. |
| 401 | invalid_dpop_proof |
DPoP 증명이 유효하지 않거나 재사용되었습니다. |
예시
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
개인 데이터
이 엔드포인트는 개인 데이터(최종 사용자 프로필)를 포함합니다. KeenAuth API의 개인 데이터에서는 저장되는 정보, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인 데이터(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 전송하지 마십시오.