조직 역할(OrganizationRoleAssignment) API (V2)
OrganizationRoleAssignment는 사용자 또는 그룹, 역할과 조직의 관계입니다. 이 관계가 해당 조직에서 주체에게 부여한 권한을 정합니다.
조회 항목에는 필수 principalType, principalId, roleId가 있습니다. principalType은 USER 또는 GROUP입니다. 변경 요청의 RoleAssignmentUpdate에는 principalId와 roleId를 전달합니다.
사용할 역할 ID 확인
할당 가능한 역할 조회로 해당 조직의 역할을 먼저 확인합니다.
| Role 필드 | 의미 |
|---|---|
id | 할당 요청에 사용할 고유 역할 ID |
roleSetId | 역할 집합 ID |
name, description | 역할의 이름과 설명 |
isDefault | Palantir가 제공한 기본 역할 여부. 기본 역할의 정의는 관리자가 변경할 수 없음 |
type | 적용할 리소스 유형. 이 조회에서는 ORGANIZATION |
operations | 해당 리소스에서 수행할 수 있는 작업 목록, 일반적으로 service:action 형식 |
역할의 표시 이름이나 보안 표지 역할 열거값을 고유 역할 ID 대신 사용하지 않습니다. 조직 관리자 역할도 실제 조회된 정의와 ID로 선택합니다.
할당 조회와 변경
- List Organization Role Assignments는 현재 할당을 조회합니다.
api:admin-read가 필요합니다. - Add Organization Role Assignments는 한 요청에 최대 100개 할당을 추가합니다.
api:admin-write가 필요합니다. - Remove Organization Role Assignments는 한 요청에 최대 100개 할당을 제거합니다.
api:admin-write가 필요합니다.
100개는 역할 할당 항목의 수입니다. 사용자 또는 그룹의 리소스 자체를 생성하거나 삭제하는 요청과 구분합니다.
조직 표지의 관리자는 이 조직 역할 경로로 관리합니다. 일반 보안 표지 역할 API에서 조직 표지의 ADMINISTER를 추가하거나 제거할 수는 없습니다. 조직의 게스트 접근은 조직 정보의 markingId를 사용하는 별도 구성원 관리 작업입니다.