보안 표지 범주(MarkingCategory) API (V2)

보안 표지 범주는 보안 표지를 논리적인 그룹으로 정리합니다. 범주 권한은 범주 및 표지 정보의 가시성과 범주 관리를 다룹니다. 범주 권한을 받았다고 개별 표지의 관리 권한이나 그 표지가 보호하는 데이터의 조회 및 관리 권한까지 생기지는 않습니다.

범주 모델

필드	자료형과 조건
`id`	필수 string. 사용자 생성 범주는 UUID, 조직 표지의 범주는 `Organization`
`name`, `description`	필수 string
`categoryType`	필수, `CONJUNCTIVE` 또는 `DISJUNCTIVE`
`markingType`	필수, `MANDATORY` 또는 `CBAC`
`priority`	선택 long. CBAC 범주에서만 사용하며 큰 값이 높은 우선순위
`markings`	선택 `list<MarkingId>`
`deleted`	필수 boolean, 삭제 여부
`createdTime`	필수 date-time 문자열, 생성 시각
`createdBy`	선택 string, 생성한 Foundry 사용자

범주를 만들 때 initialPermissions를 지정합니다. 조직 목록에는 최소 한 조직이, 역할 목록에는 최소 한 ADMINISTER가 있어야 합니다.

설정	동작
`organizationRids`	역할과 관계없이 이 조직 중 하나 이상에 속해야 범주 안의 표지 정보를 볼 수 있음
`roles`의 `ADMINISTER`	범주 메타데이터와 권한 변경
`roles`의 `VIEW`	범주 및 그 안의 표지 정보 조회
`isPublic=true`	지정한 조직 중 하나 이상에 속한 사용자에게 범주 안의 표지 정보 공개
`isPublic=false`	명시적으로 `VIEW`를 받은 사용자에게 표지 정보 표시

isPublic은 인터넷 공개나 모든 조직에 대한 공개를 뜻하지 않습니다. 지정 조직 소속 조건은 유지됩니다.

자신 또는 자신이 속한 그룹의 주체 ID를 ADMINISTER로 지정하지 않으면 생성한 범주를 직접 관리할 수 없습니다. 초기 권한은 이후 범주 권한 관리 작업으로 변경할 수 있습니다.

작업	조건
Create Marking Category	이름, 설명과 초기 권한으로 생성. 미리보기 기능으로 `preview=true` 필요
List Marking Categories	최대 페이지 크기 100. 삭제된 범주 포함이 기본값이며 표지 유형을 생략하면 전체 유형 조회
Get Marking Category	범주 ID로 조회
Replace Marking Category	이름과 설명 교체. 미리보기 기능으로 `preview=true` 필요

생성과 교체는 api:admin-write, 조회는 api:admin-read OAuth 권한 범위를 요청합니다. 미리보기 엔드포인트는 언제든 변경되거나 제거될 수 있습니다.