조직(Organization) API (V2)

조직은 전용 보안 표지와 연결된 접근 통제 단위입니다. 사용자 모델에서 기본 조직은 하나이며 여러 조직의 게스트가 될 수 있습니다. User API에서는 타사 애플리케이션의 서비스 사용자에게 organization 필드가 비어 있는 응답 조건도 적용됩니다.

프로젝트의 조직 접근 조건

조직 표지는 프로젝트 수준에만 적용합니다. 개별 리소스에 조직 표지를 직접 적용하지 않습니다.

프로젝트에 여러 조직이 지정되어 있다면 사용자는 그중 하나의 조직에 속하는 것으로 조직 접근 조건을 충족합니다. 리소스의 역할과 다른 보안 표지 조건은 별도로 확인합니다.

게스트 접근은 조직의 기반 보안 표지 구성원으로 관리합니다. Get Organization이 반환하는 markingId를 Marking Member API에 사용합니다. 조직 RID를 이 표지 ID 자리에 넣지 않습니다.

필드	자료형	조건
`rid`	`string`	필수, 조직 리소스 RID
`name`	`string`	필수, 조직 이름
`description`	`string`	선택, 설명
`markingId`	`string`	필수, 게스트 접근 관리에 사용하는 기반 보안 표지 ID
`host`	`string`	선택, 조직 사용자의 URL 구성에 사용하는 기본 호스트 이름

API	용도와 조건
Create Organization	플랫폼 인스턴스 RID와 이름으로 생성, 초기 관리자 주체 최소 하나 필요. 미리보기 기능으로 `preview=true` 지정
Get Organization	조직 RID로 정보 조회
Replace Organization	이름, 호스트와 설명 교체
List Available Roles Organization	해당 조직에 할당 가능한 역할 정의 조회

호스트는 유효한 도메인 이름이어야 합니다. 사용자 URL을 만들 때 조직의 기본 호스트 값을 사용합니다.

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

조직 관리자 등 실제 역할의 할당과 제거는 Organization Role Assignment API를 사용합니다.