이 페이지에서는 SCIM API와 Python SDK API를 사용하여 사용자 및 팀 관리를 대규모로 자동화하는 방법을 설명합니다.
SCIM API
W&B SCIM API를 사용하면 Okta, Microsoft Entra 등의 ID 공급자(IdP)를 통해 W&B 조직의 사용자와 팀을 대규모로 관리할 수 있습니다.
자세한 내용은 SCIM 레퍼런스 페이지의 인증을 참조하세요.
W&B의 SCIM 구현에는 커스텀 역할을 생성 및 관리하는 엔드포인트와 기본 제공 역할 및 커스텀 역할을 부여하는 엔드포인트가 포함되어 있습니다. 역할 엔드포인트는 공식 SCIM 스키마에 속하지 않으며, W&B가 커스텀 역할 관리를 자동화할 수 있도록 별도로 추가한 것입니다.
다음 섹션에서는 SCIM API의 각 범주를 설명합니다.
User SCIM API
User SCIM API를 사용하면 W&B 조직의 사용자를 생성, 비활성화, 조회하고 사용자 목록을 확인할 수 있으며, 사전 정의된 역할이나 커스텀 역할을 부여할 수 있습니다. 전체 요청 및 응답 예시는 SCIM 레퍼런스를 참조하세요.
사용자를 비활성화하려면 {"active": false}를 포함하여 PATCH /scim/Users/{id} 요청을 보내세요. 결과는 호스팅 옵션에 따라 다릅니다. Dedicated Cloud 및 Self-Managed 배포에서는 사용자 레코드가 유지되지만, Multi-tenant Cloud에서는 사용자가 조직에서 제거됩니다. Multi-tenant Cloud에서는 재활성화를 지원하지 않으므로 사용자를 다시 추가해야 합니다. 자세한 내용은 사용자 비활성화 및 사용자 재활성화를 참조하세요.
Group SCIM API
Group SCIM API를 사용하면 조직 내 팀 생성 및 제거를 포함해 W&B 팀을 관리할 수 있습니다. 기존 팀에 사용자를 추가하거나 팀에서 제거하려면 PATCH Group을 사용하세요.
W&B에는 “동일한 역할을 가진 사용자 그룹”이라는 개념이 없습니다. W&B 팀은 그룹과 매우 비슷하며, 서로 다른 역할을 가진 사용자들이 관련 프로젝트에서 함께 협업할 수 있게 해 줍니다. 하나의 팀은 여러 사용자 그룹으로 구성될 수 있습니다. 팀의 각 사용자에게 team admin, member, viewer 또는 커스텀 역할 중 하나를 부여하세요.W&B는 그룹과 W&B 팀이 서로 비슷하므로 Group SCIM API 엔드포인트를 W&B 팀에 매핑합니다.
커스텀 역할 SCIM API
Custom Role SCIM API를 사용하면 조직의 커스텀 역할을 생성, 목록 조회, 업데이트하는 등 커스텀 역할을 관리할 수 있습니다.
커스텀 역할은 신중하게 삭제하세요.W&B 조직에서 커스텀 역할을 삭제하려면 DELETE Role 엔드포인트를 사용하세요. 삭제 시 W&B는 해당 커스텀 역할이 있던 모든 사용자에게 그 역할이 상속하던 사전 정의된 역할을 부여합니다.커스텀 역할이 상속하는 역할을 업데이트하려면 PUT Role 엔드포인트를 사용하세요. 이 오퍼레이션은 커스텀 역할에 포함된 기존의 상속되지 않은 커스텀 권한에는 영향을 주지 않습니다.
W&B Python SDK API
W&B Python SDK API의 다음 클래스를 사용하여 조직 사용자, 팀, 팀 멤버십을 관리하세요.