보안 표지 역할(MarkingRoleAssignment) API (V2)
MarkingRoleAssignment는 사용자 또는 그룹에 부여한 보안 표지 역할을 나타냅니다. 표지의 접근 조건을 충족하는 구성원 지정과 구분합니다.
| 역할 | 허용하는 작업 |
|---|---|
ADMINISTER | 표지 구성원 추가 및 제거, 역할 할당 변경, 표지 메타데이터 변경 |
DECLASSIFY | 리소스에서 표지 제거, 변환 중 표지 전파 중지 |
USE | 리소스에 표지 적용 |
조회 결과에는 필수 principalType, principalId, role이 있습니다. principalType은 USER 또는 GROUP입니다. 추가 및 제거 요청의 MarkingRoleUpdate 항목에는 필수 principalId와 role을 전달합니다.
API 선택
- List Marking Role Assignments는 역할 할당을 조회합니다.
api:admin-read가 필요하며pageSize는 무시합니다. - Add Marking Role Assignments는 지정한 역할을 추가합니다.
api:admin-write가 필요합니다. - Remove Marking Role Assignments는 지정한 역할을 제거합니다.
api:admin-write가 필요합니다.
목록 응답에 다음 페이지 토큰이 있으면 후속 요청에 전달합니다. 보안 표지 구성원 목록 조회는 별도로 api:admin-write를 요구하므로 두 조회 API의 권한 범위를 혼동하지 않습니다.
조직 표지와 마지막 관리자
조직 표지에는 이 역할 API로 USE와 DECLASSIFY만 관리할 수 있습니다. 조직의 ADMINISTER는 Organization Role Assignment API로 관리합니다. 조직 표지의 관리자를 이 경로로 변경하려 하면 OrganizationMarkingAdministerRoleNotSupported가 발생합니다.
일반 표지에서도 관리자를 모두 제거할 수는 없습니다. ADMINISTER 제거 전 다른 관리자가 남는지 확인합니다. 유일한 관리자를 제거하는 요청은 RemoveMarkingRoleAssignmentsRemoveAllAdministratorsNotAllowed로 거부됩니다.