> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 사용자 및 팀 관리 자동화

> SCIM API와 Python SDK API를 사용하여 W&B에서 사용자 및 팀 관리를 대규모로 자동화합니다.

이 페이지에서는 [SCIM API](/ko/products/wandb/platform/hosting/iam/scim)와 [Python SDK API](/ko/products/wandb/ref/python/public-api)를 사용하여 사용자 및 팀 관리를 대규모로 자동화하는 방법을 설명합니다.

<h2 id="scim-api">
  SCIM API
</h2>

W\&B SCIM API를 사용하면 Okta, Microsoft Entra 등의 ID 공급자(IdP)를 통해 W\&B 조직의 사용자와 팀을 대규모로 관리할 수 있습니다.

자세한 내용은 SCIM 레퍼런스 페이지의 [인증](/ko/products/wandb/platform/hosting/iam/scim#authentication)을 참조하세요.

<Tip>
  W\&B의 SCIM 구현에는 커스텀 역할을 생성 및 관리하는 엔드포인트와 기본 제공 역할 및 커스텀 역할을 부여하는 엔드포인트가 포함되어 있습니다. 역할 엔드포인트는 공식 SCIM 스키마에 속하지 않으며, W\&B가 커스텀 역할 관리를 자동화할 수 있도록 별도로 추가한 것입니다.
</Tip>

다음 섹션에서는 SCIM API의 각 범주를 설명합니다.

<h3 id="user-scim-api">
  User SCIM API
</h3>

[User SCIM API](/ko/products/wandb/platform/hosting/iam/scim#user-resource)를 사용하면 W\&B 조직의 사용자를 생성, 비활성화, 조회하고 사용자 목록을 확인할 수 있으며, 사전 정의된 역할이나 커스텀 역할을 부여할 수 있습니다. 전체 요청 및 응답 예시는 [SCIM 레퍼런스](/ko/products/wandb/platform/hosting/iam/scim#user-management)를 참조하세요.

<Note>
  사용자를 비활성화하려면 `{"active": false}`를 포함하여 `PATCH /scim/Users/{id}` 요청을 보내세요. 결과는 호스팅 옵션에 따라 다릅니다. Dedicated Cloud 및 Self-Managed 배포에서는 사용자 레코드가 유지되지만, Multi-tenant Cloud에서는 사용자가 조직에서 제거됩니다. Multi-tenant Cloud에서는 재활성화를 지원하지 않으므로 사용자를 다시 추가해야 합니다. 자세한 내용은 [사용자 비활성화](/ko/products/wandb/platform/hosting/iam/scim#deactivate-user) 및 [사용자 재활성화](/ko/products/wandb/platform/hosting/iam/scim#reactivate-user)를 참조하세요.
</Note>

<h3 id="group-scim-api">
  Group SCIM API
</h3>

[Group SCIM API](/ko/products/wandb/platform/hosting/iam/scim#group-resource)를 사용하면 조직 내 팀 생성 및 제거를 포함해 W\&B 팀을 관리할 수 있습니다. 기존 팀에 사용자를 추가하거나 팀에서 제거하려면 `PATCH Group`을 사용하세요.

<Note>
  W\&B에는 "동일한 역할을 가진 사용자 그룹"이라는 개념이 없습니다. W\&B 팀은 그룹과 매우 비슷하며, 서로 다른 역할을 가진 사용자들이 관련 프로젝트에서 함께 협업할 수 있게 해 줍니다. 하나의 팀은 여러 사용자 그룹으로 구성될 수 있습니다. 팀의 각 사용자에게 team admin, member, viewer 또는 커스텀 역할 중 하나를 부여하세요.

  W\&B는 그룹과 W\&B 팀이 서로 비슷하므로 Group SCIM API 엔드포인트를 W\&B 팀에 매핑합니다.
</Note>

<h3 id="custom-role-scim-api">
  커스텀 역할 SCIM API
</h3>

[Custom Role SCIM API](/ko/products/wandb/platform/hosting/iam/scim#role-resource)를 사용하면 조직의 커스텀 역할을 생성, 목록 조회, 업데이트하는 등 커스텀 역할을 관리할 수 있습니다.

<Warning>
  커스텀 역할은 신중하게 삭제하세요.

  W\&B 조직에서 커스텀 역할을 삭제하려면 `DELETE Role` 엔드포인트를 사용하세요. 삭제 시 W\&B는 해당 커스텀 역할이 있던 모든 사용자에게 그 역할이 상속하던 사전 정의된 역할을 부여합니다.

  커스텀 역할이 상속하는 역할을 업데이트하려면 `PUT Role` 엔드포인트를 사용하세요. 이 오퍼레이션은 커스텀 역할에 포함된 기존의 상속되지 않은 커스텀 권한에는 영향을 주지 않습니다.
</Warning>

<h2 id="wb-python-sdk-api">
  W\&B Python SDK API
</h2>

[W\&B Python SDK API](/ko/products/wandb/ref/python/public-api/api)의 다음 클래스를 사용하여 조직 사용자, 팀, 팀 멤버십을 관리하세요.

* [`User`](/ko/products/wandb/ref/python/public-api/user)
* [`Team`](/ko/products/wandb/ref/python/public-api/team)
* [`Member`](/ko/products/wandb/ref/python/public-api/member)