디렉터리 프로비저닝 로그 조회

GET /v1/directories/{directory_id}/provisioning-logs · 권한 directories:read

SCIM 디렉터리의 프로비저닝 로그를 최신순으로 조회합니다. 아이덴티티 공급자가 보낸 인증된 SCIM 요청 하나가 레코드 하나에 해당하며, 메서드, 경로 템플릿(실제 ID는 경로에 포함되지 않음), 리소스 유형과 ID, 값 없이 요약한 작업 내용, 무시된 속성 이름, HTTP 상태, scim_type, 처리 시간, 클라이언트 주소 접두사(IPv4 /24, IPv6 /48), 클라이언트 분류, 대량 비활성화 보류로 요청이 중단되었는지 여부를 포함합니다. 요청 및 응답 본문, 속성 값, 전체 IP 주소, User-Agent, 토큰 값은 저장되지 않으며 반환되지도 않습니다.

레코드는 요금제의 로그 보관 기간 동안 보관됩니다(Free 7일, Startup 14일, Business 30일, Enterprise 90일). 정렬은 항상 최신순이며 order 매개변수는 없습니다. 삭제된 디렉터리의 레코드는 GET /v1/logs?type=scim.request로 계속 조회할 수 있습니다.

요청

필드	유형	필수	설명
`directory_id`	path	예	SCIM 디렉터리 ID(`dir_…`)입니다.
`limit`	query	아니요	1~100, 기본값 20입니다.
`after`	query	아니요	`list_metadata.after`의 커서입니다(더 오래된 레코드).
`before`	query	아니요	`list_metadata.before`의 커서입니다(더 새로운 레코드).
`from`	query	아니요	포함하는 하한(RFC 3339)입니다.
`to`	query	아니요	제외하는 상한(RFC 3339)입니다.

요청 본문은 없습니다.

응답

레코드 페이지와 함께 200 OK를 반환합니다.

{
  "data": [
    {
      "id": "evt_01j9xp4q6r8s0t2v4w6x8y0z2b",
      "occurred_at": "2026-10-20T12:00:00Z",
      "outcome": "success",
      "organization_id": "org_01j9xk1m3n5p7q9r1s3t5v7w9x",
      "token_id": "dst_01j9xn2p4q6r8s0t2v4w6x8y0z",
      "method": "PATCH",
      "path_template": "PATCH /Users/{id}",
      "resource_type": "User",
      "resource_id": "dsu_01j9xq5r7s9t1v3w5x7y9z1a3c",
      "operation_summary": ["replace:active"],
      "ignored_attributes": [],
      "status": 200,
      "scim_type": null,
      "duration_ms": 12,
      "client_ip_prefix": "203.0.113.0/24",
      "client_class": "okta",
      "held": false,
      "request_id": "0192f5e0-0000-7000-8000-000000000001",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

오류

HTTP	code	발생 조건
400	`invalid_cursor`	커서의 형식이 잘못되었거나 다른 요청에 속합니다.
400	`range_outside_retention`	`from`이 요금제의 보관 기간보다 이전입니다.
404	`not_found`	이 환경에 디렉터리가 존재하지 않습니다.
422	`validation_failed`	`limit`이 범위를 벗어나거나, `from` 또는 `to`가 RFC 3339 형식이 아니거나, `to`가 `from`보다 뒤가 아니거나, `order`가 전달되었습니다(`unsupported`).
401	`unauthenticated`	자격 증명이 없거나, 잘못되었거나, 폐기되었습니다.
403	`insufficient_permissions`	자격 증명에 필요한 권한이 없습니다.
429	`rate_limited`	요청 한도를 초과했습니다. `Retry-After` 기간이 지난 후 다시 시도하십시오.
503	`service_unavailable`	디렉터리 동기화 또는 로그 검색을 일시적으로 사용할 수 없거나 이 배포에서 구성되지 않았습니다. `Retry-After` 기간이 지난 후 다시 시도하십시오.

예시

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/provisioning-logs?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth directories provisioning-logs list dir_01j9xm2n4p6q8r0s2t4v6w8y0z --from 2026-10-01T00:00:00Z

개인정보

이 엔드포인트에는 개인정보, 즉 디렉터리(SCIM) 사용자 정보가 포함됩니다. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 민감한 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.