Automatiser la gestion des Users et des équipes

Automatisez à grande échelle la gestion des Users et des équipes dans W&B à l’aide de l’API SCIM et de l’API du SDK Python.

Cette page explique comment automatiser à grande échelle la gestion des Users et des équipes à l’aide de l’API SCIM et de l’API du SDK Python.

​

SCIM API

Utilisez l’API SCIM de W&B pour gérer à grande échelle les Users et les Teams de votre organisation W&B par l’intermédiaire d’un fournisseur d’identité (IdP) comme Okta ou Microsoft Entra.

Pour plus d’informations, voir Authentification sur la page de référence SCIM.

L’implémentation de W&B comprend des points de terminaison permettant de créer et gérer des rôles personnalisés, et d’attribuer des rôles intégrés et personnalisés. Les points de terminaison de rôles ne font pas partie du schéma SCIM officiel. W&B ajoute ces points de terminaison pour permettre la gestion automatisée des rôles personnalisés.

Les sections suivantes décrivent chaque catégorie de l’API SCIM.

​

API SCIM des Users

L’API SCIM des Users vous permet de créer, désactiver, récupérer et lister des Users dans une organisation W&B, ainsi que d’attribuer des rôles prédéfinis ou personnalisés. Pour des exemples complets de requête et de réponse, consultez la référence SCIM.

Pour désactiver un utilisateur, envoyez PATCH /scim/Users/{id} avec {"active": false}. L’option d’hébergement détermine le résultat : les déploiements Cloud dédié et Autogéré conservent l’enregistrement de l’utilisateur, tandis que le Cloud mutualisé supprime l’utilisateur de l’organisation. La réactivation n’est pas disponible dans le Cloud mutualisé. Rajoutez plutôt l’utilisateur. Voir Désactiver un utilisateur et Réactiver un utilisateur.

​

API SCIM des groupes

L’API SCIM des groupes permet de gérer les Teams W&B, notamment de créer ou de supprimer des Teams dans une organisation. Pour ajouter ou supprimer des Users dans une équipe existante, utilisez PATCH Group.

Il n’existe pas dans W&B de notion de groupe d'Users ayant le même rôle. Une équipe W&B ressemble beaucoup à un groupe et permet à différents profils, avec des rôles variés, de collaborer sur un ensemble de projets liés. Les Teams peuvent être composées de différents groupes d’Users. Attribuez à chaque utilisateur d’une équipe un rôle : administrateur d’équipe, membre, observateur ou rôle personnalisé.

W&B associe les points de terminaison de l’API Group SCIM aux Teams W&B en raison de la similarité entre les groupes et les Teams W&B.

​

API SCIM des rôles personnalisés

L’API SCIM des rôles personnalisés permet de gérer les rôles personnalisés, notamment de créer, lister ou mettre à jour des rôles personnalisés au sein d’une organisation.

Supprimez un rôle personnalisé avec prudence.

Pour supprimer un rôle personnalisé dans une organisation W&B, utilisez l’endpoint DELETE Role. W&B attribue le rôle prédéfini hérité à tous les utilisateurs qui disposaient du rôle personnalisé avant sa suppression.

Pour mettre à jour le rôle hérité d’un rôle personnalisé, utilisez l’endpoint PUT Role. Cette opération n’affecte aucune des autorisations personnalisées non héritées existantes dans le rôle personnalisé.

​

API du SDK Python

Utilisez la API du SDK Python pour gérer les Users et les Teams d’une organisation, ainsi que les appartenances aux Teams, via les classes suivantes :

• User
• Team
• Member