Users と Teams の管理を自動化

SCIM API と Python SDK API を使用して、W&B で大規模な Users と Teams の管理を自動化します。

このページでは、SCIM API と Python SDK API を使用して、大規模な Users と Teams の管理を自動化する方法を説明します。

​

SCIM API

Okta や Microsoft Entra などのアイデンティティ プロバイダ (IdP) を介して、W&B 組織の Users と Teams を大規模に管理するには、W&B SCIM API を使用します。

詳細は、SCIM リファレンス ページの Authentication を参照してください。

W&B の実装には、カスタム ロールの作成と管理、および組み込みロールおよびカスタム ロールの割り当てのためのエンドポイントが含まれます。ロール エンドポイントは、公式な SCIM スキーマの一部ではありません。W&B では、カスタム ロールの自動管理をサポートするために、ロール エンドポイントを追加しています。

以下のセクションでは、SCIM API の各カテゴリについて説明します。

​

User SCIM API

User SCIM API を使用すると、W&B 組織内のUsersを作成、無効化、取得、一覧表示し、事前定義ロールまたはカスタムのロールを割り当てられます。リクエストとレスポンスの完全な例については、SCIM リファレンス を参照してください。

ユーザーを無効化するには、PATCH /scim/Users/{id} を {"active": false} とともに送信します。結果はホスティングオプションによって異なります。専用クラウドおよびセルフマネージドのデプロイではユーザーレコードが保持されますが、Multi-tenant Cloud ではユーザーは組織から削除されます。Multi-tenant Cloud では再有効化できないため、代わりにユーザーを再追加してください。Deactivate user と Reactivate user を参照してください。

​

Group SCIM API

Group SCIM API を使用すると、組織内で Teams を作成または削除する操作を含め、W&B Teams を管理できます。既存のチームにユーザーを追加または削除するには、PATCH Group を使用します。

W&B には、同じロールを持つUsersのグループ という概念はありません。W&B チーム はグループに近い概念で、異なるロールを持つユーザーが、関連する一連の Projects で共同作業できるようになっています。Teams には、異なるユーザーグループを含めることができます。チーム内の各ユーザーには、team admin、member、viewer、または custom role のいずれかのロールを割り当てます。

W&B では、グループと W&B Teams の類似性に基づき、Group SCIM API の endpoints を W&B Teams に対応付けています。

​

カスタムロール SCIM API

Custom Role SCIM API を使用すると、組織内のカスタムロールの作成、一覧表示、更新など、カスタムロールを管理できます。

カスタムロールの削除は慎重に行ってください。

W&B 組織内のカスタムロールを削除するには、DELETE Role エンドポイントを使用します。削除前にそのカスタムロールを割り当てられていたすべてのユーザーには、継承元の事前定義ロールが W&B によって割り当てられます。

カスタムロールの継承ロールを更新するには、PUT Role エンドポイントを使用します。この操作は、カスタムロール内の既存の継承されていないカスタム権限には影響しません。

​

W&B Python SDK API

組織のUsers、Teams、およびチームのメンバーシップを次のクラスを通じて管理するには、W&B Python SDK APIを使用します。

• User
• Team
• Member