관리
관리자 API
관리자 API를 사용하면 조직 구성원, 워크스페이스, API 키를 포함한 조직의 리소스를 프로그래밍 방식으로 관리할 수 있습니다. 이를 통해 Anthropic Console에서 수동으로 구성해야 하는 관리 작업을 프로그래밍 방식으로 제어할 수 있습니다.
관리자 API는 특별한 접근 권한이 필요합니다
관리자 API는 표준 API 키와 다른 특별한 관리자 API 키(sk-ant-admin...로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만이 Anthropic Console을 통해 관리자 API 키를 발급할 수 있습니다.
관리자 API 작동 방식
관리자 API를 사용할 때:
x-api-key헤더에 관리자 API 키를 사용하여 요청을 합니다- API를 통해 다음을 관리할 수 있습니다:
- 조직 구성원과 그들의 역할
- 조직 구성원 초대
- 워크스페이스와 그 구성원
- API 키
이는 다음과 같은 용도로 유용합니다:
- 사용자 온보딩/오프보딩 자동화
- 프로그래밍 방식의 워크스페이스 접근 관리
- API 키 사용량 모니터링 및 관리
조직 역할과 권한
조직 수준에는 네 가지 역할이 있습니다.
| 역할 | 권한 |
|---|---|
| user | Workbench를 사용할 수 있음 |
| developer | Workbench를 사용하고 API 키를 관리할 수 있음 |
| billing | Workbench를 사용하고 결제 정보를 관리할 수 있음 |
| admin | 위의 모든 작업과 사용자 관리가 가능함 |
주요 개념
조직 구성원
조직 구성원을 나열하고, 구성원 역할을 업데이트하고, 구성원을 제거할 수 있습니다.
조직 초대
사용자를 조직에 초대하고 해당 초대를 관리할 수 있습니다.
워크스페이스
리소스를 구성하기 위한 워크스페이스를 생성하고 관리합니다:
워크스페이스 구성원
특정 워크스페이스에 대한 사용자 접근을 관리합니다:
API 키
API 키를 모니터링하고 관리합니다:
모범 사례
관리자 API를 효과적으로 사용하기 위해:
- 워크스페이스와 API 키에 의미 있는 이름과 설명을 사용하세요
- 실패한 작업에 대한 적절한 오류 처리를 구현하세요
- 정기적으로 구성원 역할과 권한을 감사하세요
- 사용하지 않는 워크스페이스와 만료된 초대를 정리하세요
- API 키 사용량을 모니터링하고 주기적으로 키를 교체하세요