연결의 최신 테스트 결과 가져오기

GET /v1/connections/{connection_id}/test-results/latest · 권한 connections:write

지난 24시간 안에 실행된 엔터프라이즈 연결의 가장 최근 테스트 로그인 결과를 반환합니다. 상태, 실패 사유, IdP가 보낸 속성 또는 클레임의 이름, 그룹 수, 속성 매핑을 통해 값을 받은 사용자 필드를 포함합니다. 속성 값, 원본 SAML 어설션, ID 토큰은 저장되거나 반환되지 않습니다. 테스트 결과는 24시간 동안 보관됩니다. 조회는 감사되지 않습니다.

요청

필드 유형 필수 설명
connection_id 경로 예 엔터프라이즈 연결 ID(conn_…).

응답

200 OK:

{
  "test_id": "conntest_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "status": "passed",
  "failure_reason": null,
  "attribute_names": ["email", "given_name", "groups"],
  "group_count": 2,
  "mapped_fields": ["email", "given_name"],
  "started_at": "2026-10-20T10:00:00Z",
  "completed_at": "2026-10-20T10:01:12Z"
}
필드 설명
status pending(URL을 아직 열지 않았거나 IdP가 아직 응답하지 않음), passed 또는 failed.
failure_reason 실패한 테스트의 기계가 읽을 수 있는 사유(예: 테스트 중 연결이 변경되면 configuration_changed). 그 밖에는 null.
attribute_names IdP가 보낸 속성 또는 클레임의 이름(값은 아님).
group_count 받은 그룹 수.
mapped_fields 속성 매핑을 통해 값을 받은 사용자 필드(값은 아님).
started_at, completed_at 테스트 시작 시각과 IdP 응답 처리 완료 시각. pending 상태에서는 completed_at이 null입니다.

오류

HTTP code 발생 조건
404 not_found 이 환경에 연결이 없거나, 엔터프라이즈 연결이 아니거나, 지난 24시간 안의 테스트 결과가 없습니다.
401 unauthenticated 자격 증명이 없거나, 잘못되었거나, 취소되었습니다.
403 insufficient_permissions 자격 증명에 필요한 권한이 없습니다.
429 rate_limited 요청 한도를 초과했습니다. Retry-After 기간이 지난 후 다시 시도하세요.
503 service_unavailable 종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간이 지난 후 다시 시도하세요.

예시

curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/test-results/latest" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections test-results latest conn_01j9xp6q0r1s5t7v9w1x3y5z7b