メインコンテンツへスキップ
このページでは、SCIM APIPython SDK API を使用して、ユーザーとチームの管理を自動化する方法を説明します。

SCIM API

Okta や Microsoft Entra などのアイデンティティプロバイダー (IdP) を利用して、W&B SCIM API により W&B 組織のユーザーとチームを大規模に管理できます。
W&B の実装には、ロールの割り当て用エンドポイントに加え、カスタムロールの作成と管理、さらに組み込みロールおよびカスタムロールの割り当て用エンドポイントが含まれます。ロール関連のエンドポイントは公式の SCIM スキーマの一部ではありません。W&B は、カスタムロールの自動管理をサポートするためにロール用エンドポイントを追加しています。
次のセクションでは、SCIM API の各カテゴリについて説明します。

ユーザー SCIM API

ユーザー SCIM API を使用すると、W&B 組織内のユーザーを作成、無効化、取得、一覧表示し、あらかじめ定義されたロールまたはカスタムロールを割り当てることができます。リクエスト/レスポンスの完全な例については、詳細な SCIM リファレンス を参照してください。
PATCH /scim/Users/{id} でユーザーを無効化し、{"active": false} を設定します。結果はホスティングオプションによって異なります。Dedicated Cloud および Self-Managed のデプロイメントではユーザーレコードが保持されますが、Multi-tenant Cloud では組織からユーザーが削除されます。Multi-tenant Cloud では再有効化はできないため、代わりにユーザーを再度追加してください。Deactivate user および Reactivate user も参照してください。

Group SCIM API

Group SCIM API を使用すると、W&B Teams のチームを管理できます。これには、組織内でチームを作成または削除する操作が含まれます。既存のチームにユーザーを追加または削除するには、PATCH Group を使用します。
W&B には、同じロールを持つユーザーのグループ という概念は存在しません。W&B Teams のチームはグループに非常によく似ており、異なるロールを持つ多様なペルソナが、一連の関連したプロジェクトで共同作業できるようにします。1 つのチームは、異なるユーザーのグループで構成できます。チーム内の各ユーザーには、team admin、member、viewer、またはカスタムロールのいずれかのロールを割り当ててください。W&B は、グループと W&B Teams のチームの類似性により、Group SCIM API エンドポイントを W&B Teams のチームにマッピングしています。

カスタムロール API

Custom Role SCIM API を使用すると、組織内のカスタムロールの作成、一覧表示、更新などの管理ができます。
カスタムロールを削除する際は注意してください。DELETE Role エンドポイントを使用して、W&B 組織内のカスタムロールを削除します。削除操作の前に、そのカスタムロールが継承している事前定義ロールが、そのカスタムロールを割り当てられているすべてのユーザーに割り当てられます。PUT Role エンドポイントを使用して、カスタムロールの継承元ロールを更新します。この操作は、既存のカスタム権限(継承されていない権限)には影響しません。

W&B Python SDK API

W&B Python SDK API を使用すると、組織のユーザー、Teams、およびチーム メンバーシップを管理できます。