Azure Databricks 그룹 관리

Azure Databricks 계정과 작업 공간에 대한 접근 권한을 제어하기 위해 그룹을 생성, 동기화, 관리하세요. 관리자는 그룹 멤버십, 작업 공간 할당, Assume 권한과 같은 권한을 관리할 수 있습니다.

그룹에 대한 개요는 그룹을 참조하세요.

Note

이 페이지에서는 작업 영역에 ID 페더레이션이 사용하도록 설정되어 있다고 가정합니다. 이는 대부분의 작업 영역에 대한 기본값입니다. ID 페더레이션이 없는 레거시 작업 영역에 대한 자세한 내용은 ID 페더레이션 이 없는 레거시 작업 영역을 참조하세요.

Microsoft Entra ID 테넌트에서 Azure Databricks 계정에 그룹 동기화

Microsoft Entra ID 테넌트에서 Azure Databricks 계정으로 그룹을 자동으로 동기화하거나 SCIM 프로비저닝 커넥터를 사용할 수 있습니다.

자동 ID 관리를 사용하면 Microsoft Entra ID에서 애플리케이션을 구성하지 않고도 Microsoft Entra ID의 사용자, 서비스 주체 및 그룹을 Azure Databricks에 추가할 수 있습니다. Databricks는 Microsoft Entra ID를 레코드의 원본으로 사용하므로 사용자 또는 그룹 멤버 자격에 대한 변경 내용은 Azure Databricks에서 적용됩니다. 자동 ID 관리는 중첩된 그룹을 지원합니다. 자동 ID 관리는 2025년 8월 1일 이후에 만든 계정에 대해 기본적으로 사용하도록 설정됩니다. 자세한 내용은 자동 ID 관리를 참조하세요.

SCIM 프로비저닝 을 사용하면 Microsoft Entra ID에서 엔터프라이즈 애플리케이션을 구성하여 사용자 및 그룹을 Microsoft Entra ID와 동기화할 수 있습니다. SCIM 프로비전은 중첩된 그룹을 지원하지 않습니다. 자세한 내용은 SCIM을 사용하여 Microsoft Entra ID에서 사용자 및 그룹 동기화를 참조하세요.

계정에 그룹 추가

계정 관리자 및 작업 영역 관리자는 계정 콘솔 또는 작업 영역 관리자 설정 페이지를 사용하여 Azure Databricks 계정에 그룹을 추가할 수 있습니다.

계정 콘솔

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 그룹 추가를 클릭합니다.
  4. 그룹의 이름을 입력합니다.
  5. 확인을 클릭합니다.
  6. 메시지가 표시되면 그룹에 사용자, 서비스 주체 및 그룹을 추가합니다.

작업 영역 관리자 설정

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 그룹 추가를 클릭합니다.
  6. 새로 추가를 클릭합니다.
  7. 그룹의 이름을 입력하고 자격을 선택합니다.
  8. 추가를 클릭합니다.

Note

새 그룹이 워크스페이스 관리자 그룹 페이지의 검색 결과에 바로 나타나지 않을 수도 있습니다. 검색 상자를 지우면 필터링되지 않은 목록에서 볼 수 있습니다. 지연은 그룹의 권한에 영향을 미치지 않습니다.

그룹에 구성원 추가

계정 관리자 및 작업 영역 관리자는 계정 콘솔 또는 작업 영역 관리자 설정 페이지를 사용하여 Azure Databricks 계정에 그룹을 추가할 수 있습니다. 작업 영역 관리자가 아닌 그룹 관리자는 계정 그룹 API를 사용하여 그룹 멤버 자격을 관리해야 합니다.

Note

외부 그룹을 Microsoft Entra ID와 동기화하려면 기본적으로 계정 콘솔에서 외부 그룹의 멤버 자격을 관리할 수 없습니다. Azure Databricks UI에서 외부 그룹 멤버 자격을 업데이트하기 위해 계정 관리자는 계정 콘솔 미리 보기 페이지에서 변경할 수 없는 외부 그룹 미리 보기 사용하지 않도록 설정할 수 있습니다. 자동 신원 관리로 관리되는 외부 그룹은 변경 불가능한 외부 그룹 미리보기가 비활성화되어 있어도 Azure Databricks에서 업데이트할 수 없습니다.

계정 콘솔

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 업데이트할 그룹을 선택합니다.
  4. 구성원 추가를 클릭합니다.
  5. 추가하려는 사용자, 그룹 또는 서비스 주체를 검색하여 선택합니다.
  6. 추가를 클릭합니다.

그룹 업데이트와 그룹 멤버 자격이 모든 시스템에 완전히 전파되는 사이에 몇 분 정도 지연됩니다.

작업 영역 관리자 설정

Note

admins 그룹의 멤버로 그룹을 추가하려면 해당 그룹이 워크스페이스에 직접 할당되어 있어야 하며 워크스페이스에서 신원 연합이 활성화되어 있어야 합니다. ID 페더레이션을 참조하세요. workspace-local 그룹 또는 시스템 그룹을 계정 그룹의 구성원으로 추가할 수 없습니다.

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 업데이트할 그룹을 선택합니다. 업데이트하려면 그룹에 대한 관리 권한이 있어야 합니다.
  6. 구성원 탭에서 구성원 추가를 클릭합니다.
  7. 대화 상자에서 추가하려는 사용자, 서비스 주체 및 그룹을 찾아보거나 검색하여 선택합니다.
  8. 확인을 클릭합니다.

그룹 생성 및 관리 databricks_pii_access

SQL 문장과 정의에는 고객 이름, 이메일 주소 또는 기타 개인 식별 정보(PII)와 같은 민감한 정보가 포함될 수 있습니다. 계정 수준 그룹은 databricks_pii_access 다음 장소에서 마스크드 해제된 쿼리 텍스트 접근을 통제합니다:

Important

Lakebase 시스템 테이블은 베타 버전입니다. 이 기능을 사용하려면 Lakebase 프로젝트와 시스템 테이블의 Lakebase Observability 미리보기가 필요하며, 작업 공간 관리자는 Previews 페이지에서 이를 활성화할 수 있습니다. Lakebase 시스템 테이블 참조를 참조하세요.

그룹은 또한 이 system.lakebase 열에서 마스킹되지 않은 값에 대한 접근을 통제합니다. 계정 관리자나 그룹 멤버가 아닌 사용자에게는 다음이 반환됩니다: <REDACTED>

  • ddl_history: query_text, ddl_json
  • pg_stat_statements_counters: query
  • plan_history: query_textparameters, plan_json
  • postgres_logs: statement

칼럼 설명은 Masked statement text를 참조하세요.

계정 관리자와 그룹 구성원은 전체 값, 즉 마스킹되지 않은 값을 읽을 수 있습니다.

이 그룹은 databricks_pii_access 당신을 위해 만들어진 것이 아닙니다. 계정 관리자가 직접 만들어야 합니다. 그룹 이름은 대문자 구분입니다.

그룹 생성과 회원 관리 방법은 다음과 같습니다:

Important

계정 콘솔에서 생성 databricks_pii_access 하거나, 신원 제공자에서 계정 관리자로 설정하세요. 작업 공간 관리자 설정에서 이 그룹을 만들지 마세요. 그룹을 생성한 워크스페이스 관리자는 자동으로 해당 그룹의 관리 권한을 받고, 누가 마스크 없는 쿼리 텍스트를 볼 수 있는지 변경할 수 있습니다.

작업 공간 관리자 설정에서 생성된 경우 databricks_pii_access , 계정 관리자가 그룹의 작업 공간 관리자 관리 권한을 취소할 수 있습니다:

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 databricks_pii_access을 클릭합니다.
  4. 권한 탭을 클릭합니다.
  5. 워크스페이스 관리자에서 Manage 를 제거하세요. 그룹에 대한 권한 관리를 참조하세요.

멤버를 추가한 후 databricks_pii_access의 주체는 마스킹 해제된 쿼리 텍스트를 읽을 수 있습니다. 쿼리 텍스트를 읽는 대시보드, 알림, 작업을 검토하고 각 워크로드를 실행하는 주체가 그룹 내에 있는지 확인하세요.

Note

작업 영역 관리자는 자동으로 databricks_pii_access의 구성원이 되지는 않습니다.

그룹의 이름 변경

계정 관리자는 계정 콘솔을 사용하여 그룹의 이름을 업데이트할 수 있으며 그룹 관리자는 계정 그룹 API를 사용하여 그룹의 이름을 업데이트할 수 있습니다. 외부 그룹을 Microsoft Entra ID와 동기화하려면 기본적으로 계정 콘솔에서 외부 그룹의 이름을 업데이트할 수 없습니다.

계정 콘솔

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 업데이트할 그룹을 선택합니다.
  4. 그룹 정보를 클릭합니다.
  5. 이름 아래에서 이름을 업데이트합니다.
  6. 저장을 클릭합니다.

계정 그룹 API

curl --netrc -X PATCH \
https://${DATABRICKS_HOST}/api/2.1/accounts/{account_id}/scim/v2/Groups/{id} \
--header 'Content-type: application/scim+json' \
--data @update-group.json \
| jq .

update-group.json:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "replace",
      "path": "displayName",
      "value": "<updated-name>"
    }
  ]
}

계정 그룹 API에 인증하는 방법에 대한 자세한 내용은 Azure Databricks 리소스에 대한 액세스 권한 부여를 참조하세요.

작업 영역에 그룹 할당

계정 관리자 및 작업 영역 관리자는 계정 콘솔 또는 작업 영역 관리자 설정 페이지를 사용하여 Azure Databricks 작업 영역에 그룹을 할당할 수 있습니다.

또한 구성원이 없는 그룹을 워크스페이스에 할당하고 그 그룹에 대해 사용자에게 Assume 권한을 부여할 수도 있습니다. 워크스페이스에 다른 방식으로 할당되지 않은 사용자는 워크스페이스에 들어가기 위해 그룹 역할을 맡아야 합니다. 튜토리얼: 작업 공간 액세스를 위해 사용자가 역할을 맡도록 요구를 참조하세요.

계정 콘솔

작업 영역-로컬 그룹은 계정 콘솔을 사용하여 작업 영역에 할당할 수 없습니다.

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 작업 영역을 클릭합니다.
  3. 작업 영역 이름을 클릭합니다.
  4. 사용 권한 탭에서 사용 권한 추가를 클릭합니다.
  5. 그룹을 검색하여 선택하고 작업 영역 자격을 할당한 다음 저장을 클릭합니다.

작업 영역 관리자 설정

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 그룹 추가를 클릭합니다.
  6. 작업 영역에 할당할 기존 그룹을 선택합니다.
  7. 그룹에 대한 자격을 선택합니다.
  8. 추가를 클릭합니다.

작업 영역에서 그룹 제거

작업 공간에서 계정 그룹을 제거하면 그 구성원이 해당 그룹을 통해 가진 작업 공간 접근은 사라지지만, 직접 할당이나 다른 그룹을 통한 접근은 제거되지 않습니다. 남아 있는 작업 공간 할당이 없는 멤버도 권한이 있다면 해당 작업 공간에 할당된 역할을 수임하여 여전히 들어갈 수 있습니다. 작업 공간에 들어가기 위해 역할을 맡아야 할 때를 참조하세요.

그룹을 워크스페이스에서 제거한다고 해서 객체에 부여된 권한이 취소되는 것은 아닙니다. 그룹을 다시 작업 공간에 할당하면, 그 구성원들은 해당 작업 공간에서 그 권한을 다시 사용할 수 있습니다.

Note

예정된 릴리스에서 계정 그룹 멤버 자격은 작업 영역 개체 권한에도 영향을 줍니다. 구성원은 해당 그룹이 작업 영역에 할당되었는지 여부에 관계없이 구성원인 모든 계정 그룹에서 작업, 전자 필기장 및 폴더와 같은 작업 영역 개체에 대한 권한을 상속합니다. 분리된 권한 분석 Notebook을 사용하여 작업 영역에서 사용 권한 부여를 검토합니다. 모든 계정 그룹에서 곧 상속될 작업 영역 개체 권한을 참조하세요.

계정 관리자 및 작업 영역 관리자는 계정 콘솔 또는 작업 영역 관리자 설정 페이지를 사용하여 Azure Databricks 작업 영역에서 그룹을 제거할 수 있습니다.

계정 콘솔

계정 콘솔을 사용하여 작업 영역에서 작업 영역-로컬 그룹을 제거할 수 없습니다.

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 작업 영역을 클릭합니다.
  3. 작업 영역 이름을 클릭합니다.
  4. 권한 탭에서 그룹을 찾습니다.
  5. Kebab 메뉴 아이콘 을 클릭합니다. 그룹 행의 맨 오른쪽에 있는 kebab 메뉴에서 제거를 선택합니다.
  6. 확인 대화 상자에서 제거를 클릭합니다.

작업 영역 관리자 설정

Note

다른 그룹의 멤버 자격을 통해 작업 영역에 간접적으로 할당된 그룹은 제거할 수 없습니다. 이러한 그룹을 제거하려면 부모 그룹에서 그룹을 제거하거나 계정 수준에서 제거해야 합니다.

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 그룹을 선택하고 x 삭제를 클릭합니다.
  6. 삭제를 클릭하여 확인합니다.

그룹에 대한 권한 관리

계정 관리자는 계정 콘솔의 그룹에 대한 권한을 부여할 수 있으며, 작업 영역 관리자는 작업 영역 관리자 설정 페이지를 사용하여 그룹 권한을 관리할 수 있습니다. 작업 영역 관리자가 아닌 그룹 관리자는 계정 Access Control API를 사용하여 그룹 권한을 관리할 수 있습니다.

그룹에 대해 다음 권한을 부여할 수 있습니다.

  • Assume: 사용자, 서비스 프린시펄 또는 다른 그룹이 역할을 수임할 수 있습니다. Azure Databricks에서는 역할이 그룹으로 구현되고, 그룹에 대해 Assume 권한을 부여합니다. 이것이 RBAC(역할 기반 액세스 제어)의 기초입니다. 자세한 내용은 RBAC(역할 기반 액세스 제어)를 참조하세요.
  • 관리: 사용자, 서비스 주체 또는 다른 그룹이 그룹 구성원을 관리하고, 그룹을 삭제하며, 다른 주체에게 그룹에 대한 관리 권한과 Assume 권한을 할당할 수 있게 합니다.

계정 콘솔

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 그룹 이름을 찾아 클릭합니다.
  4. 권한 탭을 클릭합니다.
  5. 액세스 권한 부여를 클릭합니다.
  6. 사용자, 서비스 주체 또는 그룹을 검색하여 선택하고 사용 권한을 선택합니다.
  7. 저장을 클릭합니다.

작업 영역 관리자 설정

계정 그룹에 workspace-local 그룹 또는 시스템 그룹 역할을 할당할 수 없습니다.

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 업데이트할 그룹을 선택합니다. 업데이트하려면 그룹에 대한 관리 권한이 있어야 합니다.
  6. 권한 탭을 클릭합니다.
  7. 액세스 권한 부여를 클릭합니다.
  8. 사용자, 서비스 주체 또는 그룹을 검색하여 선택하고 사용 권한을 선택합니다.
  9. 저장을 클릭합니다.

그룹에 계정 관리자 역할 할당

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 그룹 이름을 찾아 클릭합니다.
  4. 역할 탭을 클릭합니다.
  5. 계정 관리자를 선택합니다.

계정 콘솔을 사용하여 그룹에 청구 관리자 또는 Marketplace 관리자 역할을 할당할 수 없습니다. 이러한 역할을 그룹에 할당하려면 다음 역할 식별자와 함께 계정 액세스 제어 API 를 사용합니다.

  • roles/billing.admin 대금 청구 관리자용
  • roles/marketplace.admin Marketplace 관리자용

부모 그룹 보기

  1. 작업 영역 관리자로 Azure Databricks 작업 영역에 로그인합니다.
  2. Azure Databricks 작업 영역의 상단 표시줄에서 사용자 이름을 클릭하고 설정을 선택합니다.
  3. ID 및 액세스 탭을 클릭합니다.
  4. 그룹 옆에 있는 관리를 클릭합니다.
  5. 보려는 그룹을 선택합니다.
  6. 부모 그룹 탭에서 그룹의 부모 그룹을 봅니다.

Azure Databricks 계정에서 그룹 제거

계정 관리자는 Azure Databricks 계정에서 그룹을 제거할 수 있습니다. 그룹 관리자는 계정 그룹 API를 사용하여 계정에서 그룹을 제거할 수도 있습니다. API를 사용하여 그룹 관리를 참조하세요. 계정 콘솔을 사용하여 그룹을 제거하는 경우 계정에 대해 설정된 SCIM 프로비저닝 커넥터 또는 SCIM API 애플리케이션을 사용하여 그룹을 또 다시 제거해야 합니다. 그렇지 않은 경우 SCIM 프로비저닝은 다음에 동기화할 때 그룹과 해당 멤버를 다시 추가하기만 합니다. SCIM을 사용하여 Microsoft Entra ID에서 사용자 및 그룹 동기화를 참조하세요.

Important

그룹을 제거하면 해당 그룹의 사용자가 다른 그룹의 구성원이거나 계정 또는 작업 영역에 대한 액세스 권한이 직접 부여되지 않은 한, 해당 그룹의 모든 사용자가 계정에서 삭제되고 작업 영역에 대한 기존 액세스 권한이 사라집니다. Databricks에서 계정 수준 그룹이 계정의 모든 작업 영역에 대한 액세스 권한을 잃지 않게 하려면 삭제하지 않는 것이 좋습니다. 사용자를 삭제하면 다음과 같은 결과가 발생할 수 있습니다.

  • 사용자가 생성한 토큰을 사용하는 애플리케이션 또는 스크립트는 더 이상 Databricks API에 액세스할 수 없습니다.
  • 사용자가 소유한 작업이 실패합니다.
  • 사용자가 소유한 클러스터가 중지됩니다.
  • 해당 사용자가 설치한 라이브러리는 유효하지 않으며 다시 설치해야 합니다.
  • 공유가 실패하지 않도록 하려면 사용자가 만들고 소유자 자격 증명으로 실행으로 공유한 쿼리 또는 대시보드를 새 소유자에게 할당해야 합니다.

계정 콘솔을 사용하여 그룹을 제거하려면 다음을 수행합니다.

  1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.
  2. 사이드바에서 사용자 관리를 클릭합니다.
  3. 그룹 탭에서 제거할 그룹을 찾습니다.
  4. Kebab 메뉴 아이콘 을 클릭합니다. 사용자 행의 맨 오른쪽에 있는 kebab 메뉴에서 삭제를 선택합니다.
  5. 확인 대화 상자에서 삭제 확인을 클릭합니다.

Note

자동 ID 관리를 사용하도록 설정하면 ID 공급자의 그룹이 계정 콘솔에 표시됩니다. 그룹은 비활성 으로 표시됩니다. 작업 영역에 추가되지 않은 경우 사용하지 않습니다. 이러한 그룹은 그룹 목록에서 제거할 수 없습니다. 그들은 그룹 제한에 포함되지 않습니다.

API를 사용하여 그룹 관리

계정 관리자, 작업 영역 관리자, 그룹 관리자는 계정 그룹 API를 사용하여 Azure Databricks 계정에서 그룹을 추가, 삭제, 관리할 수 있습니다. 계정 관리자, 작업 영역 관리자, 그룹 관리자는 다른 엔드포인트 URL을 사용하여 API를 호출해야 합니다.

  • 계정 관리자는 {account-domain}/api/2.1/accounts/{account_id}/scim/v2/를 사용합니다.
  • 작업 영역 관리자와 그룹 관리자는 {workspace-domain}/api/2.0/account/scim/v2/를 사용합니다.

자세한 내용은 계정 그룹 API를 참조하세요.

계정 및 작업 영역 관리자는 작업 영역 할당 API를 사용하여 작업 영역에 그룹을 할당할 수 있습니다. 작업 영역 할당 API는 Azure Databricks 계정 및 작업 영역을 통해 지원됩니다.

  • 계정 관리자는 {account-domain}/api/2.0/accounts/{account_id}/workspaces/{workspace_id}/permissionassignments를 사용합니다.
  • 작업 영역 관리자는 {workspace-domain}/api/2.0/preview/permissionassignments/principals/{group_id}를 사용합니다.

작업 영역 할당 API를 참조하세요.

API를 사용하여 그룹에 대한 권한 관리

그룹 관리자는 계정 Access Control API를 사용하여 그룹 권한을 관리할 수 있습니다. 계정 관리자, 작업 영역 관리자 및 그룹 관리자는 다른 엔드포인트 URL을 사용하여 API를 호출해야 합니다.

  • 계정 관리자는 {account-domain}/api/2.0/preview/accounts/{account_id}/access-control/assignable-roles를 사용합니다.
  • 작업 영역 관리자와 그룹 관리자는 {workspace-domain}/api/2.0/preview/accounts/access-control/assignable-roles를 사용합니다.

계정 액세스 제어 API 및 계정 액세스 제어 작업 영역 프록시 API를 참조하세요.

그룹에 대한 Assume 권한 부여 또는 해지

Account Access Control API를 사용해 그룹의 현재 규칙 세트를 가져온 다음 이를 Assume 권한으로 업데이트하세요.

규칙 집합 작업은 두 개의 동등한 엔드포인트에서 사용할 수 있습니다. 코드가 실행되는 위치와 일치하는 항목을 선택합니다.

  • 작업 영역 URL로부터: {workspace-url}/api/2.0/preview/accounts/access-control/rule-sets. 계정 ID는 작업 영역 컨텍스트에서 유추됩니다. 작업 영역 OAuth 토큰을 사용하여 인증합니다.
  • 계정 URL로부터: {account-domain}/api/2.0/preview/accounts/{account-id}/access-control/rule-sets. 계정 수준 스크립트 또는 CI 파이프라인과 같은 작업 영역 컨텍스트 외부에서 실행되는 자동화에 이 양식을 사용합니다. 계정 OAuth 토큰으로 인증합니다.

name 요청 본문의 필드는 두 경우 모두 동일합니다. accounts/{account-id}/groups/{group-id}/ruleSets/default 다음 예제에서는 작업 영역 URL 양식을 사용합니다.

먼저 현재 규칙 집합을 가져옵니다. etag PUT 요청에 포함해야 하므로 응답에서 값을 저장합니다.

curl --request GET \
  --location '{workspace-url}/api/2.0/preview/accounts/access-control/rule-sets' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "accounts/{account-id}/groups/{group-id}/ruleSets/default",
    "etag": ""
  }'

그런 다음, roles/group.assumer 역할을 부여하도록 규칙 집합을 업데이트합니다.

Important

전체 규칙 집합을 대체하는 PUT 작업입니다. 기존의 Manage 권한이 제거되지 않도록 roles/group.manager 요청에서 반환된 기존 GET 권한 부여 항목을 항상 포함하세요.

curl --request PUT \
  --location '{workspace-url}/api/2.0/preview/accounts/access-control/rule-sets' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "accounts/{account-id}/groups/{group-id}/ruleSets/default",
    "rule_set": {
      "name": "accounts/{account-id}/groups/{group-id}/ruleSets/default",
      "grant_rules": [
        {
          "role": "roles/group.assumer",
          "principals": [
            "users/{user-name}",
            "groups/{group-name}",
            "servicePrincipals/{application-id}"
          ]
        },
        {
          "role": "roles/group.manager",
          "principals": [
            "users/{manager-user-name}"
          ]
        }
      ],
      "etag": "{etag-from-get-response}"
    }
  }'

배열을 principals 각 역할에 부여하려는 ID로 바꿉니다. users/{user-name}, groups/{group-name} 또는 servicePrincipals/{application-id} 형식을 사용하세요.

가정 권한을 취소하려면 제거하려는 ID를 생략하는 업데이트 grant_rules 된 배열을 사용하여 PUT 요청을 제출합니다.

그룹을 관리하기 위한 API 예제

다음 예제에서는 작업 영역 관리자가 계정 그룹 API 및 작업 영역 할당 API 를 사용하여 그룹을 관리하는 방법을 보여 줍니다. 작업 영역 관리자는 API 토큰을 사용하여 작업 영역에 인증합니다.

계정 그룹 만들기

curl --request POST \
  --location '{workspace-domain}/api/2.0/account/scim/v2/Groups' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "displayName": "<group-name>"
  }'

새 계정 그룹의 그룹 ID를 반환합니다. 다음 API 예제에서 참조용으로 저장합니다.

작업 영역에 그룹 추가

다음 예제에서는 작업 영역 사용자 권한이 있는 그룹을 작업 영역에 추가합니다. ["ADMIN"]으로 설정 permissions 하여 그룹에 작업 영역 관리자 역할을 부여할 수도 있습니다.

curl --location --request PUT '{workspace-domain}/api/2.0/preview/permissionassignments/principals/{group-id}' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "permissions": ["USER"]
  }'

작업 영역에서 그룹 제거

다음 예제에서는 작업 영역에서 그룹을 제거합니다. 작업 영역에서 그룹을 제거해도 계정에서 그룹이 삭제되지는 않습니다.

Note

다른 그룹의 멤버 자격을 통해 작업 영역에 간접적으로 할당된 그룹은 제거할 수 없습니다. 이러한 그룹을 제거하려면 부모 그룹에서 그룹을 제거하거나 계정 수준에서 제거해야 합니다.

curl --location --request PUT '{workspace-domain}/api/2.0/preview/permissionassignments/principals/{group-id}' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "permissions": []
  }'

그룹에 멤버 추가

curl --location --request PATCH '{workspace-domain}/api/2.0/account/scim/v2/Groups/{group-id}' \
  --header 'Authorization: Bearer $OAUTH_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "schemas": [
      "urn:ietf:params:scim:api:messages:2.0:PatchOp"
    ],
    "Operations": [
      {
        "op": "add",
        "value": {
          "members": [
            {
              "value": "{user-id}"
            }
          ]
        }
      }
    ]
  }'