연결의 IdP 서명 인증서 목록 조회

GET /v1/connections/{connection_id}/certificates · 권한 connections:read

엔터프라이즈 SAML 연결의 IdP 활성 서명 인증서를 반환합니다. 각 항목은 ID, SHA-256 지문, 유효 기간, 출처를 포함합니다. 인증서 자체와 주체(사람의 이름이나 이메일 주소를 담을 수 있음)는 반환되지 않습니다. 연결당 활성 인증서는 최대 3개이므로 목록은 페이지로 나뉘지 않습니다. limit, after, before, order 매개변수가 없으며 list_metadata에는 커서가 없습니다. 삭제된 인증서는 나열되지 않습니다. 조회는 감사되지 않습니다.

요청

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

응답

200 OK. SAML 설정이 없는 SAML 연결은 빈 목록을 반환합니다.

{
  "data": [
    {"id": "conncert_01j9xq2m4n6p8r0s2t4v6w8y0a", "sha256_fingerprint": "3b0c…", "not_before": "2026-01-01T00:00:00Z", "not_after": "2028-01-01T00:00:00Z", "source": "metadata"}
  ],
  "list_metadata": {"before": null, "after": null}
}

필드	설명
`id`	인증서 ID(`conncert_…`). 인증서를 삭제할 때 사용합니다.
`sha256_fingerprint`	DER 인코딩의 소문자 16진수 SHA-256. IdP가 표시하는 지문과 비교하세요.
`not_before`, `not_after`	유효 기간. 이 기간 밖의 인증서는 어떤 서명도 검증하지 않습니다.
`source`	`metadata`: 메타데이터 URL 새로 고침으로 추가됨. `manual`: 직접 업로드했거나 가져온 메타데이터 문서에서 얻음.

오류

HTTP	code	발생 조건
404	`not_found`	이 환경에 연결이 없거나 엔터프라이즈 SAML 연결이 아닙니다.
409	`conflict`	연결이 SAML 연결이 아닙니다.
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/certificates" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections certificates list conn_01j9xp6q0r1s5t7v9w1x3y5z7b