API

신원 API

디렉터리에서 에이전트 신원을 생성, 조회, 스폰서 지정, 취소하세요.

신원 생성하기

POST /v1/identities에 이름, 스폰서 이메일, 그리고 신원이 요청할 수 있는 범위 상한을 담아 호출하세요. 응답은 신원 id, 상태, 확정된 스폰서를 반환합니다.

이름은 사람을 위한 것이며 고유할 필요가 없습니다. id는 다른 모든 곳에서 사용되는 안정적이고 표준적인 참조입니다.

GET /v1/identities/{id}는 스폰서, 범위 상한, 상태와 함께 단일 신원을 반환합니다. GET /v1/identities는 커서 페이지네이션과 스폰서·상태 필터로 목록을 반환합니다.

목록 조회는 읽기 전용이며 폴링해도 안전합니다. 취소와 스폰서 변경을 즉시 반영합니다.

PATCH /v1/identities/{id}는 스폰서를 변경하거나 범위 상한을 조정합니다. 이전 값은 감사 로그에 보존되므로, 언제든 누가 책임졌고 무엇이 허용되었는지 기록이 항상 보여줍니다.

POST /v1/identities/{id}/revoke는 모든 연결된 시스템에 걸쳐 해당 신원의 모든 자격 증명과 범위를 동기적으로 무효화합니다. 호출은 봉쇄가 완료되면 반환되고 이벤트는 감사 로그에 기록됩니다.