Gérer les utilisateurs, les groupes et les rôles avec SCIM

Regardez une vidéo de démonstration de SCIM (12 min)

Aperçu

Cette page explique comment les administrateurs d’instance et les administrateurs de l’organisation utilisent l’API System for Cross-domain Identity Management (SCIM) pour automatiser la gestion des identités dans W&B. L’API SCIM vous permet de provisionner et de déprovisionner des utilisateurs, de gérer l’appartenance aux équipes et de définir des rôles personnalisés par programmation, via un fournisseur d’identité ou un pipeline CI/CD, sans avoir à passer par l’interface de la W&B App. Les groupes SCIM correspondent aux équipes W&B. L’API SCIM de W&B est compatible avec des fournisseurs d’identité tels qu’Okta et Microsoft Entra. Pour configurer le SSO avec Okta, Microsoft Entra ou d’autres fournisseurs d’identité, consultez la documentation SSO. Pour des exemples pratiques en Python illustrant l’utilisation de l’API SCIM, consultez le dépôt wandb-scim.

Fonctionnalités prises en charge

L’API SCIM prend en charge les fonctionnalités suivantes :

Filtrage : l’API prend en charge le filtrage sur les points de terminaison /Users et /Groups.
Opérations PATCH : prise en charge de PATCH pour la mise à jour partielle des ressources.
Prise en charge des ETags : mises à jour conditionnelles basées sur les ETags pour détecter les conflits.
Authentification par compte de service : les comptes de service de l’organisation peuvent accéder à l’API.
Cycle de vie des comptes de service : provisionnez et déprovisionnez des comptes de service à portée d’équipe ou limités à l’organisation. Pris en charge sur le Cloud mutualisé, ainsi que sur le Cloud dédié et les déploiements autogérés à partir de la version v0.81.0.

Si vous êtes administrateur de plusieurs organisations Enterprise en Cloud mutualisé, configurez l’organisation destinataire des requêtes API SCIM afin que les requêtes effectuées avec votre clé API s’appliquent à la bonne organisation. Cliquez sur votre image de profil, puis sur Paramètres utilisateur, et vérifiez le paramètre Default API organization.La valeur de l’espace réservé [HOST-URL] utilisé dans les exemples de cette page dépend de l’option d’hébergement choisie.Les exemples utilisent des ID d’utilisateur tels que abc et def. Dans les requêtes et réponses réelles, les ID d’utilisateur sont des valeurs hachées.

Authentification

Chaque requête SCIM doit être authentifiée par un principal administrateur. Les administrateurs de l’organisation peuvent s’authentifier à l’aide d’un jeton Bearer ou d’identifiants d’authentification HTTP Basic. Dans les deux cas, c’est la même chaîne de clé API qui est utilisée lorsqu’une clé est requise. Consultez les principales différences présentées dans la section suivante, puis choisissez une identité d’utilisateur ou un compte de service limité à l’organisation.

Principales différences

La liste suivante compare les identifiants d’authentification d’utilisateur et ceux de compte de service pour l’authentification SCIM :

Cas d’usage : les utilisateurs sont plus adaptés aux actions d’administration interactives et ponctuelles. Les comptes de service sont plus adaptés à l’automatisation et aux intégrations (CI/CD, outils de provisionnement).
Identifiants d’authentification : les utilisateurs envoient un nom d’utilisateur et une clé API pour l’authentification Basic. Les comptes de service envoient uniquement une clé API (sans nom d’utilisateur) pour l’authentification Basic. Pour l’authentification Bearer, envoyez uniquement la clé API dans l’en-tête (sans nom d’utilisateur).
Bearer ou Basic : Bearer utilise Authorization: Bearer [API-KEY] avec la clé telle quelle. Basic utilise Authorization: Basic <base64(...)> (les utilisateurs encodent username:API-KEY, et les comptes de service encodent :API-KEY, précédé du caractère deux-points et avec un nom d’utilisateur vide).
Portée et autorisations : utilisez la clé API d’un utilisateur administrateur de l’instance ou administrateur de l’organisation, ou celle d’un compte de service limité à l’organisation. Les clés des comptes de service à portée d’équipe ne permettent pas de s’authentifier auprès de l’API SCIM. Les comptes de service qui utilisent SCIM sont limités à l’organisation et fonctionnent sans interface, ce qui permet d’obtenir des pistes d’audit plus claires pour l’automatisation.
Où obtenir les identifiants d’authentification : les utilisateurs copient leur clé API depuis les Paramètres utilisateur. Les clés des comptes de service limités à l’organisation se trouvent dans le tableau de bord de l’organisation, sous l’onglet Service account.
Cloud mutualisé : si vous avez accès à plusieurs organisations Cloud mutualisé, vous devez définir l’organisation API par défaut afin que les appels d’API SCIM soient acheminés vers la bonne organisation.

Jeton Bearer

Envoyez la clé API sous forme de jeton Bearer :

Authorization: Bearer [API-KEY]

La valeur [API-KEY] correspond à la même chaîne que celle que vous utiliseriez comme mot de passe pour ce principal dans l’authentification HTTP Basic. N’encodez pas la clé en Base64 pour les requêtes Bearer.

L’authentification Bearer pour l’API SCIM est disponible dans le Cloud mutualisé W&B, ainsi que dans le Cloud dédié et les déploiements autogérés à partir de la version v0.79.0.

Les exemples suivants utilisent [API-KEY] comme espace réservé. Remplacez-le par une clé réelle appartenant à un utilisateur administrateur ou à un compte de service limité à l’organisation. Lister les utilisateurs

curl -s -S \
  -H "Authorization: Bearer [API-KEY]" \
  -H "Content-Type: application/scim+json" \
  "[HOST-URL]/scim/Users"

Créer un utilisateur

curl -s -S -X POST \
  -H "Authorization: Bearer [API-KEY]" \
  -H "Content-Type: application/scim+json" \
  "[HOST-URL]/scim/Users" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "dev-user2",
    "emails": [{"primary": true, "value": "dev-user2@example.com"}]
  }'

Pour plus d’informations, voir Créer un utilisateur.

Users

Utilisez vos identifiants d’administration personnels pour effectuer des tâches d’administration interactives. Construisez l’en-tête HTTP Authorization sous la forme Basic <base64(username:API-KEY)>. Par exemple, pour vous authentifier en tant que demo:p@55w0rd :

Authorization: Basic ZGVtbzpwQDU1dzByZA==

Comptes de service

Utilisez un compte de service limité à l’organisation pour les automatisations ou les intégrations. Construisez l’en-tête HTTP Authorization sous la forme Basic <base64(:API-KEY)> (notez le deux-points initial et le nom d’utilisateur vide). Vous trouverez les clés API des comptes de service dans le tableau de bord de l’organisation, sous l’onglet Service account. Reportez-vous à Comptes de service limités à l’organisation. Par exemple, pour vous authentifier avec la clé API sa-p@55w0rd :

Authorization: Basic OnNhLXBANTV3MHJk

Configuration de Microsoft Entra ID

Utilisez cette section pour configurer le provisionnement automatique des utilisateurs et des groupes depuis Microsoft Entra ID vers W&B via l’API SCIM. Pour configurer le SSO avec Entra, voir Configurer le SSO avec Entra.

URL du locataire

Dans les paramètres d’approvisionnement de votre application d’entreprise Entra, définissez Tenant URL sur votre URL de base SCIM W&B, en y ajoutant le paramètre de requête aadOptscim062020, qui correspond à l’indicateur de fonctionnalité Entra :

[HOST-URL]/scim?aadOptscim062020

Par exemple, si votre instance se trouve à l’adresse https://wandb.example.com, définissez l’URL du locataire sur https://wandb.example.com/scim?aadOptscim062020. Le paramètre aadOptscim062020 active une gestion propre à Entra dans l’API SCIM de W&B. Sans ce paramètre, Entra peut envoyer des requêtes de désactivation d’utilisateur contenant des valeurs booléennes sous forme de chaînes ("False" ou "True") au lieu de booléens JSON (false ou true), ce qui peut faire échouer la désactivation. Dans le champ Secret Token, saisissez la clé API d’un utilisateur administrateur de l’organisation ou d’un compte de service limité à l’organisation. Voir Authentification.

Lorsque vous ajoutez aadOptscim062020 à l’URL du locataire, la désactivation d’utilisateurs depuis l’interface Provision on demand d’Entra, dans le centre d’administration Microsoft Entra, risque de ne pas fonctionner, car cette interface envoie toujours des valeurs booléennes sous forme de chaînes. Pour tester la désactivation manuellement, envoyez une requête SCIM PATCH au format PatchOp Operations qui remplace la valeur de active par false (voir Désactiver un utilisateur).

Noms des équipes

Nommez les groupes Entra associés aux équipes W&B en utilisant des lettres minuscules et des traits d’union, par exemple ml-platform ou data-science. Évitez les espaces, les caractères de soulignement et tout autre caractère spécial dans les noms d’affichage des groupes que vous synchronisez avec W&B.

Mappages d’attributs utilisateur

Configurez les mappages d’attributs suivants dans Entra pour le provisionnement SCIM des utilisateurs :

Attribut de l’application personnalisée W&B	Attribut source (Entra)	Appliquer ce mappage	Faire correspondre les objets à l’aide de cet attribut
`emails[type eq "work"].value`	`mail`	Toujours	Oui
`active`	`Not([IsSoftDeleted])`	Toujours
`displayName`	`displayName`	Toujours
`userName`	`displayName`	Uniquement lors de la création de l’objet

Sur le Cloud mutualisé, le compte d’un utilisateur n’est pas géré par l’organisation. W&B ne prend pas en charge la mise à jour de displayName via SCIM sur le Cloud mutualisé. Voir Mettre à jour le nom d’affichage d’un utilisateur.

Mappages d’attributs de groupe

Configurez les mappages d’attributs suivants dans Entra pour le provisionnement des groupes SCIM (équipes) :

Attribut de l’application personnalisée W&B	Attribut source (Entra)	Appliquer ce mappage	Faire correspondre les objets à l’aide de cet attribut
`displayName`	`displayName`	Uniquement lors de la création de l’objet	Oui
`members`	`members`	Toujours

Gestion des utilisateurs

La ressource utilisateur SCIM correspond aux utilisateurs et aux comptes de service W&B. Utilisez les points de terminaison de cette section pour provisionner, mettre à jour et supprimer des utilisateurs et des comptes de service dans votre organisation, par exemple lors de l’arrivée de nouveaux employés, pour faire pivoter les identifiants d’authentification des services ou pour révoquer l’accès des utilisateurs qui quittent l’organisation. Pour en savoir plus sur les concepts relatifs aux comptes de service et les flux de travail dans l’interface utilisateur, consultez Utiliser des comptes de service pour automatiser les flux de travail.

Changement incompatible pour les intégrations qui analysent le JSON SCIM User

Dans le Cloud dédié et les déploiements autogérés v0.80.1+, ainsi que dans les déploiements Cloud mutualisé après le 30 avril 2026, les réponses de /scim/Users (y compris les réponses GET d’un utilisateur, GET des utilisateurs et PATCH qui renvoient un User) sérialisent emails sous forme de tableau JSON d’objets dont les noms de champs sont en minuscules (value, primary et, de manière facultative, type ou display), conformément à SCIM 2.0.
Les déploiements sur des versions antérieures renvoient emails sous forme d’un objet JSON unique dont les clés sont en PascalCase (Value, Primary, etc.).

Si votre code lit emails dans les réponses SCIM, traitez emails comme un tableau et lisez l’entrée principale (ou le premier élément).Les corps de requête de création ou de mise à jour d’utilisateurs utilisaient déjà la forme tableau et restent inchangés. Le filtre list-users emails.value eq "..." reste également inchangé.

Obtenir un utilisateur

Récupère les informations d’un utilisateur ou d’un compte de service spécifique de votre organisation à partir de son ID utilisateur, ou celles d’un utilisateur à partir de son adresse e-mail. Les réponses concernant les comptes de service incluent accountType (SERVICE pour les comptes de service à portée d’équipe, ORG_SERVICE pour les comptes de service limités à l’organisation). Les comptes de service ne comportent pas de champ emails.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : GET

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur

Exemple

Requête Get User
Réponse Get User

GET /scim/Users/abc

(Status 200)

{
    "active": true,
    "daysActive": 42,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "lastActiveAt": "2023-10-15T14:32:10Z",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1"
}

La réponse fournit des informations sur l’activité de l’utilisateur au sein de l’organisation :

daysActive : nombre total de jours pendant lesquels l’utilisateur a été actif au sein de l’organisation.
lastActiveAt : horodatage ISO 8601 de la dernière activité de l’utilisateur. Renvoie null si l’utilisateur n’a jamais été actif.

La définition d’« actif » varie selon le type de déploiement :

Cloud dédié / autogéré : un utilisateur est considéré comme actif s’il se connecte, ouvre une page quelconque de la W&B App, journalise des runs, utilise le SDK ou interagit de quelque manière que ce soit avec le serveur W&B.
Cloud mutualisé : un utilisateur est considéré comme actif s’il effectue, après le 8 mai 2025, une action auditable limitée à l’organisation. Pour la liste complète, voir Actions de journalisation d’audit.

Lister les utilisateurs

Récupère la liste de tous les utilisateurs et comptes de service de votre organisation. Chaque ressource comporte un champ accountType (USER, SERVICE ou ORG_SERVICE).

Filtrer les utilisateurs

Le point de terminaison /Users permet de filtrer les utilisateurs par nom d’utilisateur ou par adresse e-mail :

userName eq "value" : filtrer par nom d’utilisateur.
emails.value eq "value" : filtrer par adresse e-mail.

GET /scim/Users?filter=userName eq "john.doe"
GET /scim/Users?filter=emails.value eq "john@example.com"

Point de terminaison

URL : [HOST-URL]/scim/Users
Méthode : GET

Exemple

Requête de liste des utilisateurs
Réponse de liste des utilisateurs

GET /scim/Users

(Status 200)

{
    "Resources": [
        {
            "active": true,
            "daysActive": 42,
            "displayName": "Dev User 1",
            "emails": [
                {
                    "primary": true,
                    "value": "dev-user1@example.com"
                }
            ],
            "id": "abc",
            "lastActiveAt": "2023-10-15T14:32:10Z",
            "meta": {
                "resourceType": "User",
                "created": "2023-10-01T00:00:00Z",
                "lastModified": "2023-10-01T00:00:00Z",
                "location": "Users/abc"
            },
            "schemas": [
                "urn:ietf:params:scim:schemas:core:2.0:User"
            ],
            "userName": "dev-user1"
        }
    ],
    "itemsPerPage": 9999,
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "startIndex": 1,
    "totalResults": 1
}

La réponse fournit des informations sur l’activité de chaque utilisateur au sein de l’organisation :

daysActive : nombre total de jours pendant lesquels l’utilisateur a été actif au sein de l’organisation.
lastActiveAt : horodatage ISO 8601 de la dernière activité de l’utilisateur. Renvoie null si l’utilisateur n’a jamais été actif.

La définition d’« actif » varie selon le type de déploiement :

Cloud dédié / autogéré : un utilisateur est considéré comme actif s’il se connecte, ouvre une page de la W&B App, journalise des runs, utilise le SDK ou interagit de quelque manière que ce soit avec le serveur W&B.
Cloud mutualisé : un utilisateur est considéré comme actif s’il effectue, après le 8 mai 2025, une action auditable limitée à l’organisation. Consultez Actions de journalisation d’audit pour la liste complète.

Créer un utilisateur

Crée un nouvel utilisateur dans votre organisation.

Point de terminaison

URL : [HOST-URL]/scim/Users
Méthode : POST

Paramètres

Paramètre	Type	Requis	Description
`emails`	array	Oui	Tableau d’objets e-mail. Doit inclure une adresse e-mail principale
`userName`	string	Oui	Le nom d’utilisateur du nouvel utilisateur
`modelsSeat`	string	Non	Niveau de licence Models. Valeurs possibles : `full`, `viewer` ou `none`. Valeur par défaut : `full`.
`weaveRole`	string	Non	Niveau de rôle Weave. Valeurs possibles : `full`, `viewer` ou `none`. Valeur par défaut : `full`.
`registryAccess`	string	Non	Droit d’accès au registre. Valeurs possibles : `enabled` ou `none`. Si ce paramètre est omis, l’accès effectif est déduit de `modelsSeat` et `weaveRole` au moment de la lecture. Disponible dans le Cloud mutualisé, ainsi que dans le Cloud dédié et en déploiement autogéré à partir de la v0.83.0.

Exemple

Requête de création d’utilisateur (Cloud dédié/autogéré)
Requête de création d’utilisateur (Cloud mutualisé)

POST /scim/Users

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "emails": [
        {
            "primary": true,
            "value": "dev-user2@example.com"
        }
    ],
    "userName": "dev-user2",
    "modelsSeat": "full",
    "weaveRole": "full"
}

POST /scim/Users

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:teams:2.0:User"
    ],
    "emails": [
        {
            "primary": true,
            "value": "dev-user2@example.com"
        }
    ],
    "userName": "dev-user2",
    "modelsSeat": "full",
    "weaveRole": "full",
    "urn:ietf:params:scim:schemas:extension:teams:2.0:User": {
        "teams": ["my-team"]
    }
}

Réponse

Réponse de création d’utilisateur (Cloud dédié/autogéré)
Réponse de création d’utilisateur (Cloud mutualisé)

(Status 201)

{
    "active": true,
    "displayName": "Dev User 2",
    "emails": [
        {
            "primary": true,
            "value": "dev-user2@example.com"
        }
    ],
    "id": "def",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "location": "Users/def"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "modelsSeat": "full",
    "weaveRole": "full",
    "userName": "dev-user2"
}

(Status 201)

{
    "active": true,
    "displayName": "Dev User 2",
    "emails": [
        {
            "primary": true,
            "value": "dev-user2@example.com"
        }
    ],
    "id": "def",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "location": "Users/def"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:teams:2.0:User"
    ],
    "userName": "dev-user2",
    "organizationRole": "member",
    "modelsSeat": "full",
    "weaveRole": "full",
    "teamRoles": [
        {
            "teamName": "my-team",
            "roleName": "member"
        }
    ],
    "groups": [
        {
            "value": "my-team-id"
        }
    ]
}

Provisionner un compte de service

Crée un compte de service à portée d’équipe ou limité à l’organisation. Utilisez ce point de terminaison pour créer des identités sans interface destinées à l’automatisation, à la CI/CD ou aux intégrations qui ne doivent pas être liées à un utilisateur humain. Pour créer un utilisateur standard, omettez accountType. Voir Créer un utilisateur.

Disponible dans le Cloud dédié et en mode autogéré v0.81.0+, ainsi que dans le Cloud mutualisé.

Définissez userName sur le nom du compte de service. L’API utilise userName comme nom d’affichage du compte. Le champ displayName du corps de requête est ignoré.
Les emails ne sont pas requis pour les comptes de service.
modelsSeat et weaveRole ne sont pas pris en charge lors de la création et renvoient 400 Bad Request s’ils sont présents.
Les comptes de service ne peuvent pas être mis à jour avec PATCH ou PUT ni être désactivés, et aucun rôle d’organisation, d’équipe ou de registre ne peut leur être attribué via SCIM. Après le provisionnement, créez des clés API dans la W&B App.

Point de terminaison

URL : [HOST-URL]/scim/Users
Méthode : POST

Paramètres

Paramètre	Type	Requis	Description
`userName`	string	Oui	Nom unique du compte de service.
`accountType`	string	Oui	`SERVICE` pour un compte de service à portée d’équipe, ou `ORG_SERVICE` pour un compte de service limité à l’organisation.
`urn:ietf:params:scim:schemas:extension:teams:2.0:User`	object	Oui	Objet d’extension Teams.
`defaultTeam`	string	Oui	Sous-champ de l’extension Teams. Nom d’une équipe W&B existante. Le compte de service est créé en tant que membre de cette équipe. Pour les comptes de service à portée d’équipe, il s’agit de la seule équipe qu’ils rejoignent. Les comptes de service limités à l’organisation sont également ajoutés automatiquement aux équipes créées ultérieurement via SCIM.
`teams`	array	Non	Cloud mutualisé uniquement. Noms des équipes auxquelles ajouter le compte. Si vous utilisez ce champ, incluez-y également l’équipe indiquée dans `defaultTeam`.

Exemple

Requête de provisionnement d’un compte de service d’équipe
Requête de provisionnement d’un compte de service d’organisation

POST /scim/Users

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:teams:2.0:User"
    ],
    "userName": "sa-deploy-bot",
    "accountType": "SERVICE",
    "urn:ietf:params:scim:schemas:extension:teams:2.0:User": {
        "defaultTeam": "ml-platform"
    }
}

POST /scim/Users

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:teams:2.0:User"
    ],
    "userName": "sa-ci-runner",
    "accountType": "ORG_SERVICE",
    "urn:ietf:params:scim:schemas:extension:teams:2.0:User": {
        "defaultTeam": "ml-platform"
    }
}

Réponse

Réponse du provisionnement d’un compte de service d’équipe
Réponse du provisionnement d’un compte de service d’organisation

(Status 201)

{
    "accountType": "SERVICE",
    "active": true,
    "displayName": "sa-deploy-bot",
    "id": "xyz",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "location": "Users/xyz"
    },
    "organizationRole": "member",
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:wandb:2.0:User"
    ],
    "teamRoles": [
        {
            "teamName": "ml-platform",
            "roleName": "member"
        }
    ],
    "urn:ietf:params:scim:schemas:extension:wandb:2.0:User": {
        "organizationRole": "member"
    },
    "userName": "sa-deploy-bot"
}

(Status 201)

{
    "accountType": "ORG_SERVICE",
    "active": true,
    "displayName": "sa-ci-runner",
    "id": "xyz",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "location": "Users/xyz"
    },
    "organizationRole": "member",
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:wandb:2.0:User"
    ],
    "teamRoles": [
        {
            "teamName": "ml-platform",
            "roleName": "member"
        }
    ],
    "urn:ietf:params:scim:schemas:extension:wandb:2.0:User": {
        "organizationRole": "member"
    },
    "userName": "sa-ci-runner"
}

Pour un compte de service limité à l’organisation, accountType vaut ORG_SERVICE. Dans les déploiements autogérés, organizationRole vaut service ou org_service au lieu de member, selon le type de compte. Si l’une des erreurs suivantes est renvoyée, vérifiez que la requête ne présente pas l’un de ces problèmes courants :

409 Conflict : la requête contient des clés userName en double pour le même compte de service.
400 Bad Request : la requête ne contient pas defaultTeam ou lui attribue une valeur non valide.

Déprovisionner un compte de service

Supprime définitivement un compte de service ainsi que son appartenance à l’organisation. Utilisez ce point de terminaison lorsqu’un compte de service n’est plus nécessaire (par exemple, après la mise hors service d’un pipeline d’automatisation). Cette suppression est définitive : le compte ne peut pas être réactivé via SCIM.

Disponible dans le Cloud dédié et en autogéré à partir de la v0.81.0, ainsi que dans le Cloud mutualisé. Utilisez l’id d’utilisateur SCIM du compte de service, obtenu dans la réponse de provisionnement ou via Get user. Le déprovisionnement ne supprime pas les clés API déjà émises. Si nécessaire, révoquez-les séparément dans la W&B App.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : DELETE

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique du compte de service.

Exemple

Requête de déprovisionnement d’un compte de service
Réponse de déprovisionnement d’un compte de service

DELETE /scim/Users/xyz

(Status 204)

Supprimer un utilisateur

Conserver l’accès administrateurVeillez à ce qu’il existe toujours au moins un utilisateur administrateur dans votre instance ou votre organisation. Sinon, aucun utilisateur ne pourra configurer ni gérer le compte W&B de votre organisation. Si une organisation utilise SCIM ou un autre processus automatisé pour déprovisionner des utilisateurs de W&B, une opération de déprovisionnement risque de supprimer par inadvertance le dernier administrateur de l’instance ou de l’organisation.Pour obtenir de l’aide dans l’élaboration de procédures opérationnelles, ou pour restaurer l’accès administrateur, contactez l’assistance.

Supprime complètement un utilisateur de votre organisation. Pour supprimer un compte de service, voir Déprovisionner un compte de service.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : DELETE

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur à supprimer

Exemple

Requête de suppression d’utilisateur
Réponse de suppression d’utilisateur

DELETE /scim/Users/abc

(Status 204)

Pour désactiver temporairement l’utilisateur, reportez-vous à l’API Désactiver un utilisateur, qui utilise le point de terminaison PATCH.

Mettre à jour l’adresse e-mail d’un utilisateur

Met à jour l’adresse e-mail principale d’un utilisateur. Non pris en charge dans le Cloud multilocataire, où le compte de l’utilisateur n’est pas géré par l’organisation.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`emails`
`value`	array	Oui	Tableau contenant le nouvel objet e-mail

Exemple

Requête de mise à jour de l’adresse e-mail
Réponse de mise à jour de l’adresse e-mail

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "emails",
            "value": [
                {
                    "value": "newemail@example.com",
                    "primary": true
                }
            ]
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "newemail@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1"
}

Mettre à jour le nom d’affichage d’un utilisateur

Met à jour le nom d’affichage d’un utilisateur. Non pris en charge dans le Cloud multilocataire, où le compte des utilisateurs n’est pas géré par l’organisation.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`displayName`
`value`	string	Oui	Nouveau nom d’affichage

Exemple

Requête de mise à jour du nom d’affichage
Réponse à la mise à jour du nom d’affichage

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "displayName",
            "value": "John Doe"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "John Doe",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2025-7-01T00:00:00Z",
        "lastModified": "2025-7-01T00:00:00Z",
        "location": "users/dev-user1"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1"
}

Désactiver un utilisateur

Désactive un utilisateur de votre organisation. Le résultat varie selon le type de déploiement :

Cloud dédié / Autogéré : définit le champ active de l’utilisateur sur false. Pour rétablir l’accès d’un utilisateur désactivé à votre organisation, voir Réactiver un utilisateur.
Cloud multilocataire : retire l’utilisateur de l’organisation. Pour lui rendre l’accès, ajoutez-le de nouveau à votre organisation. Voir Créer un utilisateur. Dans le Cloud multilocataire, le compte de l’utilisateur n’est pas géré par l’organisation.

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. La désactivation d’un compte de service n’est pas prise en charge. Gérez les comptes de service d’équipe dans les paramètres de l’équipe W&B.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	ID unique de l’utilisateur à désactiver
`op`	string	Oui	`replace`
`value`	object	Oui	Objet contenant `{"active": false}`

Exemple

Requête Deactivate User (Cloud dédié/autogéré)
Requête Deactivate User (Cloud multilocataire)

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "value": {"active": false}
        }
    ]
}

PATCH /scim/Users

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "value": {"active": false}
        }
    ]
}

Réponse

Réponse de Deactivate User (Cloud dédié/autogéré)
Réponse de Deactivate User (Cloud mutualisé)

(Status 200)

{
    "active": false,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1"
}

(Status 200)

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "value": {"active": true}
        }
    ]
}

Réactiver un utilisateur

Réactive un utilisateur précédemment désactivé dans votre organisation.

La réactivation s’applique uniquement aux utilisateurs, et non aux comptes de service. Elle n’est pas prise en charge pour les comptes de service. Gérez les comptes de service dans les paramètres de l’équipe W&B.
La réactivation des utilisateurs n’est pas prise en charge dans le Cloud multilocataire. Pour rétablir l’accès de l’utilisateur, ajoutez-le de nouveau à votre organisation. Voir Créer un utilisateur. Dans le Cloud multilocataire, le compte d’un utilisateur n’est pas géré par l’organisation. Toute tentative de réactivation d’un utilisateur renvoie une erreur HTTP 400. Le champ detail du corps de la réponse est renvoyé tel quel par l’API et peut encore employer l’ancienne dénomination du produit :
{ "schemas": [ "urn:ietf:params:scim:api:messages:2.0:Error" ], "detail": "User reactivation operations are not supported in SaaS Cloud", "status": "400" }

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	ID unique de l’utilisateur à réactiver
`op`	string	Oui	`replace`
`value`	object	Oui	Objet contenant `{"active": true}`

Exemple

Requête de réactivation d'un utilisateur
Réponse de réactivation d'un utilisateur

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "value": {"active": true}
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1"
}

Attribuer un rôle d’organisation

Attribue un rôle au niveau de l’organisation à un utilisateur.

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. Les rôles personnalisés ne sont pas pris en charge pour les comptes de service.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`organizationRole`
`value`	string	Oui	Nom du rôle (`admin` ou `member`)

Le rôle viewer limité à l’organisation est obsolète et ne peut plus être attribué dans l’interface utilisateur. Si vous utilisez SCIM pour attribuer le rôle viewer à un utilisateur :

Il se voit attribuer le rôle member dans l’organisation.
Son modelsSeat est défini sur viewer au lieu de full, ce qui lui donne un accès en lecture seule à Models et un accès complet au registre. Si aucune licence Models n’est disponible, une erreur Seat limit reached est renvoyée. Ce paramètre peut être mis à jour ultérieurement lorsqu’une licence se libère.
Son weaveRole est défini sur viewer au lieu de full, ce qui lui donne un accès en lecture seule à Weave.
Tous ses rôles d’équipe et de projet existants sont définis sur viewer.
Il se voit attribuer le rôle registre viewer dans les registres visibles au niveau de l’organisation.

L’attribution du rôle d’organisation member ou admin ne modifie ni le modelsSeat ni le weaveRole de l’utilisateur.

Exemple

Requête d’attribution de rôle d’organisation
Réponse d’attribution de rôle d’organisation

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "organizationRole",
            "value": "admin"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "teamRoles": [
        {
            "teamName": "team1",
            "roleName": "admin"
        }
    ],
    "organizationRole": "admin"
}

Mettre à jour la licence Models

Met à jour la licence Models d’un utilisateur.

Sur Cloud multilocataire, ainsi que sur Cloud dédié et en autogéré à partir de la v0.83.0, l’accès au registre est dissocié des licences Models. Définir modelsSeat sur none ne révoque plus l’accès au registre lorsque le weaveRole de l’utilisateur est différent de none. Pour révoquer l’accès au registre sur ces déploiements, utilisez Mettre à jour l’accès au registre et définissez registryAccess sur none.Sur Cloud dédié et en autogéré v0.82.0 et versions antérieures, l’accès au registre reste lié à modelsSeat. Sur ces versions, définissez modelsSeat sur none pour révoquer l’accès au registre.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`modelsSeat`
`value`	string	Oui	Niveau de licence (`full`, `viewer` ou `none`)

Exemple

Requête de mise à jour de la licence Models
Réponse de mise à jour de la licence Models

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "modelsSeat",
            "value": "full"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "organizationRole": "member",
    "modelsSeat": "full",
    "weaveRole": "full"
}

Mettre à jour le rôle Weave

Met à jour le rôle Weave d’un utilisateur.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`weaveRole`
`value`	string	Oui	Niveau du rôle (`full`, `viewer` ou `none`)

Exemple

Requête de mise à jour du rôle Weave
Réponse de mise à jour du rôle Weave

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "weaveRole",
            "value": "full"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "organizationRole": "member",
    "modelsSeat": "full",
    "weaveRole": "full"
}

Mettre à jour l’accès au registre

Accorde ou révoque l’accès au registre au niveau de l’organisation pour un utilisateur. Ce droit est distinct des rôles du registre (registryRoles), qui contrôlent les autorisations propres à chaque registre une fois que l’utilisateur dispose de ce droit. Sur Cloud mutualisé, ainsi que sur Cloud dédié et autogéré v0.83.0 ou version ultérieure, les utilisateurs dont la valeur de modelsSeat ou de weaveRole est différente de none ont accès au registre par défaut. Définissez registryAccess sur none pour révoquer l’accès au registre sans modifier leur licence Models ni leur rôle Weave. Sur Cloud dédié et autogéré v0.82.0 ou version antérieure, utilisez Mettre à jour la licence Models et définissez modelsSeat sur none pour révoquer l’accès au registre. L’attribut registryAccess n’est pas disponible dans ces versions. Si vous omettez registryAccess lors de la création, l’API déduit l’accès effectif à partir des valeurs modelsSeat et weaveRole de l’utilisateur lorsque vous lisez celui-ci. Une valeur registryAccess explicite prévaut sur cette déduction. Les utilisateurs disposant du rôle d’organisation limité à la facturation n’obtiennent pas d’accès au registre par cette déduction.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`registryAccess`
`value`	string	Oui	Droit d’accès au registre (`enabled` ou `none`)

Exemple

Requête de révocation de l’accès au registre
Réponse de révocation de l’accès au registre

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "registryAccess",
            "value": "none"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "organizationRole": "member",
    "modelsSeat": "none",
    "weaveRole": "full",
    "registryAccess": "none"
}

Attribuer un rôle d’équipe

Attribue un rôle d’équipe à un utilisateur.

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. Les rôles personnalisés ne sont pas pris en charge pour les comptes de service.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`replace`
`path`	string	Oui	`teamRoles`
`value`	array	Oui	Tableau d’objets contenant `teamName` et `roleName`

Exemple

Requête d’attribution d’un rôle d’équipe
Réponse à l’attribution d’un rôle d’équipe

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "teamRoles",
            "value": [
                {
                    "roleName": "admin",
                    "teamName": "team1"
                }
            ]
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "teamRoles": [
        {
            "teamName": "team1",
            "roleName": "admin"
        }
    ],
    "organizationRole": "admin"
}

Ajouter au registre

Ajoute un utilisateur à un registre en lui attribuant un rôle au niveau du registre.

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. Les rôles personnalisés ne sont pas pris en charge pour les comptes de service.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`add`
`path`	string	Oui	`registryRoles`
`value`	array	Oui	Tableau d’objets contenant `registryName` et `roleName`

Exemple

Requête d’ajout au registre
Réponse d’ajout au registre

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "registryRoles",
            "value": [
                {
                    "roleName": "admin",
                    "registryName": "hello-registry"
                }
            ]
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "registryRoles": [
        {
            "registryName": "hello-registry",
            "roleName": "admin"
        }
    ],
    "organizationRole": "admin"
}

Retirer d’un registre

Retire un utilisateur d’un registre.

Cette opération retire un utilisateur d’un registre spécifique. Elle ne révoque pas l’accès au registre à l’échelle de l’organisation. Pour révoquer entièrement l’accès au registre, utilisez Mettre à jour l’accès au registre.

Les opérations de retrait respectent les spécifications du protocole SCIM définies par la RFC 7644. Utilisez la syntaxe de filtre "registryRoles[registryName eq \"{registry_name}\"]" pour retirer un utilisateur d’un registre spécifique, ou "registryRoles" pour le retirer de tous les registres.
Cette opération ne s’applique qu’aux utilisateurs, pas aux comptes de service. Pour retirer des comptes de service d’un registre, passez par les paramètres de l’équipe W&B.

Point de terminaison

URL : [HOST-URL]/scim/Users/{id}
Méthode : PATCH

Paramètres

Paramètre	Type	Requis	Description
`id`	string	Oui	L’ID unique de l’utilisateur
`op`	string	Oui	`remove`
`path`	string	Oui	`"registryRoles[registryName eq \"{registry_name}\"]"` ou `"registryRoles"`

Exemple

Requête de retrait du registre
Réponse de retrait du registre

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "registryRoles[registryName eq \"goodbye-registry\"]"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "registryRoles": [
        {
            "registryName": "hello-registry",
            "roleName": "admin"
        }
    ],
    "organizationRole": "admin"
}

Requête de retrait de TOUS les registres
Réponse de retrait de TOUS les registres

PATCH /scim/Users/abc

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "registryRoles"
        }
    ]
}

(Status 200)

{
    "active": true,
    "displayName": "Dev User 1",
    "emails": [
        {
            "primary": true,
            "value": "dev-user1@example.com"
        }
    ],
    "id": "abc",
    "meta": {
        "resourceType": "User",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Users/abc"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "dev-user1",
    "organizationRole": "admin"
}

Ressource Group

La ressource de groupe SCIM correspond à une équipe W&B. Les points de terminaison de cette section vous permettent de créer des équipes, de gérer leurs membres et, si vous le souhaitez, de configurer le stockage au niveau de l’équipe depuis votre fournisseur d’identité ou vos outils d’automatisation. Lorsque vous créez un groupe SCIM dans votre IAM, une équipe W&B est créée et associée à ce groupe. Les autres opérations sur le groupe SCIM s’appliquent ensuite à cette équipe. Pour configurer un stockage personnalisé lors de la création de l’équipe, incluez storageBucket dans la requête.

Comptes de service

Lorsque vous créez une équipe W&B à l’aide de SCIM, tous les comptes de service au niveau de l’organisation sont automatiquement ajoutés à l’équipe, afin qu’ils conservent leur accès aux ressources de l’équipe.

Filtrer les groupes

Le point de terminaison /Groups prend en charge le filtrage, ce qui permet de rechercher des équipes précises.

Filtres pris en charge

Le point de terminaison /Groups prend en charge le filtre suivant :

displayName eq "value" : filtre par nom d’affichage de l’équipe.

Exemple

GET /scim/Groups?filter=displayName eq "engineering-team"

Obtenir une équipe

Récupérez les informations d’une équipe en fournissant son ID unique.

Point de terminaison

URL : [HOST-URL]/scim/Groups/{id}
Méthode : GET

Exemple

Requête
Réponse

GET /scim/Groups/ghi

(Status 200)

{
    "displayName": "acme-devs",
    "id": "ghi",
    "members": [
        {
            "Value": "abc",
            "Ref": "",
            "Type": "",
            "Display": "dev-user1"
        }
    ],
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Groups/ghi"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Lister les équipes

Récupérer la liste des équipes.

Point de terminaison

URL : [HOST-URL]/scim/Groups
Méthode : GET

Exemple

Requête
Réponse

GET /scim/Groups

(Status 200)

{
    "Resources": [
        {
            "displayName": "acme-devs",
            "id": "ghi",
            "members": [
                {
                    "Value": "abc",
                    "Ref": "",
                    "Type": "",
                    "Display": "dev-user1"
                }
            ],
            "meta": {
                "resourceType": "Group",
                "created": "2023-10-01T00:00:00Z",
                "lastModified": "2023-10-01T00:00:00Z",
                "location": "Groups/ghi"
            },
            "schemas": [
                "urn:ietf:params:scim:schemas:core:2.0:Group"
            ]
        }
    ],
    "itemsPerPage": 9999,
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "startIndex": 1,
    "totalResults": 1
}

Créer une équipe

Crée une nouvelle ressource d’équipe.

Point de terminaison

URL : [HOST-URL]/scim/Groups
Méthode : POST

Champs pris en charge

Champ	Type	Requis
`displayName`	String	Oui
`members`	Multi-Valued Array	Oui (le sous-champ `value` est requis et correspond à un ID d’utilisateur)
`storageBucket`	Object	Non

Vous pouvez configurer un Bring your own bucket (BYOB) au niveau de l’équipe lors de sa création en incluant un objet storageBucket. En l’absence de cet objet, l’équipe utilise le stockage par défaut ou celui de l’instance. Provisionnez le bucket (stratégie, CORS, identifiants d’authentification) et déterminez le format de l’adresse de stockage propre à chaque fournisseur à l’aide du guide BYOB. L’objet storageBucket comporte les sous-champs suivants :

Requis : name (nom du bucket), provider (l’une des valeurs COREWEAVE, AWS, AZURE, GCP ou MINIO). La valeur est sensible à la casse : utilisez les majuscules comme indiqué.
Facultatif : path (préfixe de chemin dans le bucket), kmsKeyId (clé KMS utilisée pour le chiffrement, par exemple sur AWS), awsExternalId (accès intercomptes AWS), azureTenantId (ID de locataire Azure), azureClientId (ID client de l’identité managée Azure).

Avant de créer l’équipe, W&B vérifie que le bucket existe et qu’il est accessible. En cas d’échec de cette validation, la requête SCIM échoue et l’équipe n’est pas créée. Une valeur provider non valide renvoie 400 Bad Request avec une erreur SCIM qui indique les valeurs autorisées.

Exemples

Ces exemples montrent comment créer une équipe sans stockage personnalisé, puis avec un stockage BYOB chez un fournisseur donné. Sélectionnez l’onglet correspondant à la configuration de stockage souhaitée pour afficher un exemple de requête, puis sélectionnez l’onglet Réponse pour afficher un exemple de réponse.

POST /scim/Groups

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
    "displayName": "wandb-support",
    "members": [
        {
            "value": "def"
        }
    ]
}

POST /scim/Groups
Content-Type: application/scim+json

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "displayName": "ml-training-team",
  "members": [
    {
      "value": "user@example.com",
      "display": "user@example.com"
    }
  ],
  "storageBucket": {
    "name": "wandb-coreweave-bucket",
    "provider": "COREWEAVE",
    "path": "ml-training/experiments"
  }
}

POST /scim/Groups
Content-Type: application/scim+json

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "displayName": "ml-team",
  "members": [
    {
      "value": "user@example.com",
      "display": "user@example.com"
    }
  ],
  "storageBucket": {
    "name": "my-company-wandb-data",
    "provider": "AWS",
    "path": "ml-team/experiments",
    "kmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012",
    "awsExternalId": "wandb-external-id-abc123"
  }
}

POST /scim/Groups
Content-Type: application/scim+json

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "displayName": "research-team",
  "members": [],
  "storageBucket": {
    "name": "wandbstorage",
    "provider": "AZURE",
    "path": "research/artifacts",
    "azureTenantId": "12345678-1234-1234-1234-123456789012",
    "azureClientId": "87654321-4321-4321-4321-210987654321"
  }
}

POST /scim/Groups
Content-Type: application/scim+json

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "displayName": "data-science-team",
  "members": [
    {
      "value": "VXNlcjox",
      "display": "jane.doe@example.com"
    },
    {
      "value": "VXNlcjoy",
      "display": "john.smith@example.com"
    }
  ],
  "storageBucket": {
    "name": "my-gcs-bucket",
    "provider": "GCP",
    "path": "data-science/runs"
  }
}

(Status 201)

{
    "displayName": "wandb-support",
    "id": "jkl",
    "members": [
        {
            "Value": "def",
            "Ref": "",
            "Type": "",
            "Display": "dev-user2"
        }
    ],
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:00:00Z",
        "location": "Groups/jkl"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Mettre à jour une équipe

Met à jour la liste des membres d’une équipe existante.

Point de terminaison

URL : [HOST-URL]/scim/Groups/{id}
Méthode : PATCH
Opérations prises en charge : add (ajout d’un membre), remove (suppression d’un membre), replace (remplacement des membres).

Les opérations de suppression respectent les spécifications du protocole SCIM définies dans la RFC 7644. Utilisez la syntaxe de filtre members[value eq "{user_id}"] pour supprimer un utilisateur précis, ou members pour supprimer tous les utilisateurs de l’équipe. Identification de l’utilisateur : dans les opérations sur les membres, {user_id} peut correspondre à l’un des éléments suivants :
- Un ID d’utilisateur W&B.
- Une adresse e-mail (par exemple, « user@example.com »).
Ces opérations s’appliquent uniquement aux utilisateurs, et non aux comptes de service. Pour modifier les comptes de service d’une équipe, accédez aux paramètres de l’équipe W&B.

Dans vos requêtes, remplacez {team_id} par l’ID réel de l’équipe et {user_id} par l’ID réel de l’utilisateur ou par son adresse e-mail.

Remplacer les membres de l’équipe

Remplace tous les membres d’une équipe par une nouvelle liste.

Cette opération s’applique uniquement aux utilisateurs, pas aux comptes de service. Gérez les comptes de service dans les paramètres de l’équipe W&B.

Point de terminaison

URL : [HOST-URL]/scim/Groups/{id}
Méthode : PUT

Requête
Réponse

PUT /scim/Groups/{team_id}

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
    "displayName": "acme-devs",
    "members": [
        {
            "value": "{user_id_1}"
        },
        {
            "value": "{user_id_2}"
        }
    ]
}

(Status 200)

{
    "displayName": "acme-devs",
    "id": "ghi",
    "members": [
        {
            "Value": "user_id_1",
            "Ref": "",
            "Type": "",
            "Display": "user1"
        },
        {
            "Value": "user_id_2",
            "Ref": "",
            "Type": "",
            "Display": "user2"
        }
    ],
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:01:00Z",
        "location": "Groups/ghi"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Ajouter un utilisateur à une équipe

Ajoute dev-user2 à acme-devs :

Cette opération ne fonctionne que pour les utilisateurs, pas pour les comptes de service. Gérez les comptes de service dans les paramètres de l’équipe W&B.

Requête
Réponse

PATCH /scim/Groups/{team_id}

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "add",
            "path": "members",
            "value": [
                {
                    "value": "{user_id}"
                }
            ]
        }
    ]
}

(Status 200)

{
    "displayName": "acme-devs",
    "id": "ghi",
    "members": [
        {
            "Value": "abc",
            "Ref": "",
            "Type": "",
            "Display": "dev-user1"
        },
        {
            "Value": "def",
            "Ref": "",
            "Type": "",
            "Display": "dev-user2"
        }
    ],
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:01:00Z",
        "location": "Groups/ghi"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Retirer un utilisateur spécifique d’une équipe

Retire dev-user2 de acme-devs :

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. Gérez les comptes de service dans les paramètres de l’équipe W&B.

Requête
Réponse

PATCH /scim/Groups/{team_id}

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "remove",
            "path": "members[value eq \"{user_id}\"]"
        }
    ]
}

(Statut 200)

{
    "displayName": "acme-devs",
    "id": "ghi",
    "members": [
        {
            "Value": "abc",
            "Display": "dev-user1"
        }
    ],
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:01:00Z",
        "location": "Groups/ghi"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Supprimer tous les utilisateurs d’une équipe

Supprime tous les utilisateurs de acme-devs :

Cette opération s’applique uniquement aux utilisateurs, et non aux comptes de service. Gérez les comptes de service dans les paramètres de l’équipe W&B.

Requête
Réponse

PATCH /scim/Groups/{team_id}

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "remove",
            "path": "members"
        }
    ]
}

(Status 200)

{
    "displayName": "acme-devs",
    "id": "ghi",
    "members": null,
    "meta": {
        "resourceType": "Group",
        "created": "2023-10-01T00:00:00Z",
        "lastModified": "2023-10-01T00:01:00Z",
        "location": "Groups/ghi"
    },
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
}

Supprimer une équipe

L’API SCIM ne permet pas de supprimer des équipes, car d’autres données leur sont liées. Supprimez les équipes depuis la W&B App, ce qui vous permet de confirmer que vous souhaitez bien tout supprimer.

Ressource Role

La ressource Role de SCIM correspond aux rôles personnalisés de W&B. Utilisez les points de terminaison de cette section pour créer et gérer les rôles personnalisés par programmation (par exemple, pour que les définitions de rôles restent synchronisées avec vos politiques d’accès). Les points de terminaison /Roles ne font pas partie du schéma SCIM officiel. W&B les ajoute afin de permettre la gestion automatisée des rôles personnalisés dans les organisations W&B.

Obtenir un rôle personnalisé

Récupérez les informations d’un rôle personnalisé à partir de son ID unique.

Point de terminaison

URL : [HOST-URL]/scim/Roles/{id}
Méthode : GET

Exemple

Requête
Réponse

GET /scim/Roles/abc

(Status 200)

{
    "description": "A sample custom role for example",
    "id": "Um9sZTo3",
    "inheritedFrom": "member", // indique le rôle prédéfini
    "meta": {
        "resourceType": "Role",
        "created": "2023-11-20T23:10:14Z",
        "lastModified": "2023-11-20T23:31:23Z",
        "location": "Roles/Um9sZTo3"
    },
    "name": "Sample custom role",
    "organizationID": "T3JnYW5pemF0aW9uOjE0ODQ1OA==",
    "permissions": [
        {
            "name": "artifact:read",
            "isInherited": true // héritée du rôle prédéfini member
        },
        ...
        ...
        {
            "name": "project:update",
            "isInherited": false // autorisation personnalisée ajoutée par un administrateur
        }
    ],
    "schemas": [
        ""
    ]
}

Lister les rôles personnalisés

Récupère les informations de tous les rôles personnalisés de l’organisation W&B.

Point de terminaison

URL : [HOST-URL]/scim/Roles
Méthode : GET

Exemple

Requête
Réponse

GET /scim/Roles

(Status 200)

{
   "Resources": [
        {
            "description": "A sample custom role for example",
            "id": "Um9sZTo3",
            "inheritedFrom": "member", // indique le rôle prédéfini dont hérite le rôle personnalisé
            "meta": {
                "resourceType": "Role",
                "created": "2023-11-20T23:10:14Z",
                "lastModified": "2023-11-20T23:31:23Z",
                "location": "Roles/Um9sZTo3"
            },
            "name": "Sample custom role",
            "organizationID": "T3JnYW5pemF0aW9uOjE0ODQ1OA==",
            "permissions": [
                {
                    "name": "artifact:read",
                    "isInherited": true // héritée du rôle prédéfini member
                },
                ...
                ...
                {
                    "name": "project:update",
                    "isInherited": false // permission personnalisée ajoutée par l’administrateur
                }
            ],
            "schemas": [
                ""
            ]
        },
        {
            "description": "Another sample custom role for example",
            "id": "Um9sZToxMg==",
            "inheritedFrom": "viewer", // indique le rôle prédéfini dont hérite le rôle personnalisé
            "meta": {
                "resourceType": "Role",
                "created": "2023-11-21T01:07:50Z",
                "location": "Roles/Um9sZToxMg=="
            },
            "name": "Sample custom role 2",
            "organizationID": "T3JnYW5pemF0aW9uOjE0ODQ1OA==",
            "permissions": [
                {
                    "name": "launchagent:read",
                    "isInherited": true // héritée du rôle prédéfini viewer
                },
                ...
                ...
                {
                    "name": "run:stop",
                    "isInherited": false // permission personnalisée ajoutée par l’administrateur
                }
            ],
            "schemas": [
                ""
            ]
        }
    ],
    "itemsPerPage": 9999,
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "startIndex": 1,
    "totalResults": 2
}

Créer un rôle personnalisé

Crée un nouveau rôle personnalisé dans l’organisation W&B.

Point de terminaison

URL : [HOST-URL]/scim/Roles
Méthode : POST

Champs pris en charge

Champ	Type	Requis
`name`	String	Nom du rôle personnalisé
`description`	String	Description du rôle personnalisé
`permissions`	Tableau d’objets	Tableau d’objets d’autorisation, chacun comprenant un champ `name` de type string dont la valeur a la forme `w&bobject:operation`. Par exemple, un objet d’autorisation pour l’opération de suppression sur les runs W&B aurait pour valeur de `name` `run:delete`.
`inheritedFrom`	String	Le rôle prédéfini dont hérite le rôle personnalisé. Il peut s’agir de `member` ou de `viewer`.

Exemple

Requête
Réponse

POST /scim/Roles

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Role"],
    "name": "Sample custom role",
    "description": "A sample custom role for example",
    "permissions": [
        {
            "name": "project:update"
        }
    ],
    "inheritedFrom": "member"
}

(Status 201)

{
    "description": "A sample custom role for example",
    "id": "Um9sZTo3",
    "inheritedFrom": "member", // indique le rôle prédéfini
    "meta": {
        "resourceType": "Role",
        "created": "2023-11-20T23:10:14Z",
        "lastModified": "2023-11-20T23:31:23Z",
        "location": "Roles/Um9sZTo3"
    },
    "name": "Sample custom role",
    "organizationID": "T3JnYW5pemF0aW9uOjE0ODQ1OA==",
    "permissions": [
        {
            "name": "artifact:read",
            "isInherited": true // héritée du rôle prédéfini member
        },
        ...
        ...
        {
            "name": "project:update",
            "isInherited": false // permission personnalisée ajoutée par un administrateur
        }
    ],
    "schemas": [
        ""
    ]
}

Mettre à jour un rôle personnalisé

Les sections suivantes expliquent comment ajouter des autorisations à un rôle personnalisé existant ou lui en retirer.

Ajouter des autorisations à un rôle

Ajoute des autorisations à un rôle personnalisé existant.

URL : [HOST-URL]/scim/Roles/{id}
Méthode : PATCH

Requête
Réponse

PATCH /scim/Roles/{role_id}

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "add",
            "path": "permissions",
            "value": [
                {
                    "name": "project:delete"
                },
                {
                    "name": "run:stop"
                }
            ]
        }
    ]
}

(Status 200)

Renvoie le rôle mis à jour, avec les nouvelles autorisations ajoutées.

Retirer une autorisation d’un rôle

Retire des autorisations d’un rôle personnalisé existant.

URL : [HOST-URL]/scim/Roles/{id}
Méthode : PATCH

Requête
Réponse

PATCH /scim/Roles/{role_id}

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "remove",
            "path": "permissions",
            "value": [
                {
                    "name": "project:update"
                }
            ]
        }
    ]
}

(Status 200)

Renvoie le rôle mis à jour, sans les autorisations spécifiées.

Remplacer un rôle personnalisé

Remplace l’intégralité de la définition d’un rôle personnalisé.

Point de terminaison

URL : [HOST-URL]/scim/Roles/{id}
Méthode : PUT

Requête
Réponse

PUT /scim/Roles/{role_id}

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Role"],
    "name": "Updated custom role",
    "description": "Updated description for the custom role",
    "permissions": [
        {
            "name": "project:read"
        },
        {
            "name": "run:read"
        },
        {
            "name": "artifact:read"
        }
    ],
    "inheritedFrom": "viewer"
}

(Status 200)

Renvoie la définition de rôle remplacée.

Supprimer un rôle personnalisé

Supprimez un rôle personnalisé de l’organisation W&B. Utilisez cette opération avec prudence. Le rôle prédéfini dont héritait le rôle personnalisé est réattribué à tous les utilisateurs qui disposaient de ce rôle personnalisé avant sa suppression.

Point de terminaison

URL : [HOST-URL]/scim/Roles/{id}
Méthode : DELETE

Exemple

Requête
Réponse

DELETE /scim/Roles/abc

(Status 204 No Content)

Fonctionnalités avancées

Les sections suivantes décrivent des fonctionnalités facultatives (contrôle de concurrence basé sur les ETag et réponses d’erreur standard) qui permettent aux intégrations SCIM de fonctionner en toute sécurité en production.

Prise en charge des ETags

L’API SCIM prend en charge les ETags pour les mises à jour conditionnelles, afin d’éviter les conflits liés aux modifications simultanées. C’est essentiel lorsque plusieurs administrateurs ou systèmes automatisés modifient la même ressource, car cela garantit qu’une mise à jour n’en écrase pas silencieusement une autre. Les ETags sont renvoyés dans l’en-tête de réponse ETag et dans le champ meta.version.

ETags

Pour utiliser les ETags, suivez ces étapes :

Obtenir l’ETag actuel : lorsque vous effectuez une requête GET sur une ressource, relevez l’en-tête ETag dans la réponse.
Mise à jour conditionnelle : incluez l’ETag dans l’en-tête If-Match lorsque vous mettez à jour la ressource.

Exemple

# Obtenir l’utilisateur et noter l’ETag
GET /scim/Users/abc
# La réponse contient : ETag: W/"xyz123"

# Mettre à jour avec l’ETag
PATCH /scim/Users/abc
If-Match: W/"xyz123"

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
        {
            "op": "replace",
            "path": "organizationRole",
            "value": "admin"
        }
    ]
}

Une réponse d’erreur 412 Precondition Failed indique que la ressource a été modifiée depuis que vous l’avez récupérée.

Gestion des erreurs

L’API SCIM renvoie des réponses d’erreur SCIM standard :

Code de statut	Description
`200`	Succès
`201`	Créé
`204`	Aucun contenu (suppression réussie)
`400`	Requête incorrecte : paramètres ou corps de requête non valides
`401`	Non autorisé : échec de l’authentification
`403`	Interdit : autorisations insuffisantes
`404`	Introuvable : la ressource n’existe pas
`409`	Conflit : la ressource existe déjà
`412`	Échec de la condition préalable : l’ETag ne correspond pas
`500`	Erreur interne du serveur

Différences d’implémentation selon le type de déploiement

W&B maintient deux implémentations distinctes de l’API SCIM, dont les fonctionnalités diffèrent. Avant d’intégrer SCIM, consultez le tableau suivant pour vérifier que les opérations sur lesquelles vous vous appuyez sont disponibles pour votre type de déploiement.

Fonctionnalité	Cloud mutualisé	Cloud dédié et autogéré
Mettre à jour l’adresse e-mail de l’utilisateur	-	✓
Mettre à jour le nom d’affichage de l’utilisateur	-	✓
Désactivation de l’utilisateur	✓	✓
Réactivation de l’utilisateur	-	✓
Plusieurs adresses e-mail par utilisateur	✓	-
Définir `modelsSeat` lors de la création ou de la mise à jour	✓	✓
Définir `weaveRole` lors de la création ou de la mise à jour	✓	✓
Définir `registryAccess` lors de la création ou de la mise à jour	✓	✓
Révoquer l’accès au registre avec `modelsSeat: none`	-	✓
Révoquer l’accès au registre avec `registryAccess: none`	✓	✓

Limitations

Tenez compte des contraintes suivantes lorsque vous concevez des intégrations SCIM :

Nombre maximum de résultats : 9 999 éléments par requête.
Cloud dédié et autogéré : une seule adresse e-mail par utilisateur est prise en charge.
Suppression d’équipe : non prise en charge via SCIM (utilisez l’interface web de W&B).
Réactivation d’utilisateur : non prise en charge dans les environnements Cloud mutualisé.
Limites de licences : les opérations peuvent échouer si l’organisation a atteint sa limite de licences.

Dernière modification le 30 septembre 2026

​Aperçu

​Fonctionnalités prises en charge

​Authentification

​Principales différences

​Jeton Bearer

​Users

​Comptes de service

​Configuration de Microsoft Entra ID

​URL du locataire

​Noms des équipes

​Mappages d’attributs utilisateur

​Mappages d’attributs de groupe

​Gestion des utilisateurs

​Obtenir un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Lister les utilisateurs

​Filtrer les utilisateurs

​Point de terminaison

​Exemple

​Créer un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Réponse

​Provisionner un compte de service

​Point de terminaison

​Paramètres

​Exemple

​Réponse

​Déprovisionner un compte de service

​Point de terminaison

​Paramètres

​Exemple

​Supprimer un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Mettre à jour l’adresse e-mail d’un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Mettre à jour le nom d’affichage d’un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Désactiver un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Réponse

​Réactiver un utilisateur

​Point de terminaison

​Paramètres

​Exemple

​Attribuer un rôle d’organisation

​Point de terminaison

​Paramètres

​Exemple

​Mettre à jour la licence Models

​Point de terminaison

​Paramètres

​Exemple

​Mettre à jour le rôle Weave

​Point de terminaison

​Paramètres

​Exemple

​Mettre à jour l’accès au registre

​Point de terminaison

​Paramètres

​Exemple

​Attribuer un rôle d’équipe

​Point de terminaison

​Paramètres

​Exemple

​Ajouter au registre

​Point de terminaison

​Paramètres

​Exemple

Aperçu

Fonctionnalités prises en charge

Authentification

Principales différences

Jeton Bearer

Users

Comptes de service

Configuration de Microsoft Entra ID

URL du locataire

Noms des équipes

Mappages d’attributs utilisateur

Mappages d’attributs de groupe

Gestion des utilisateurs

Obtenir un utilisateur

Point de terminaison

Paramètres

Exemple

Lister les utilisateurs

Filtrer les utilisateurs

Point de terminaison

Exemple

Créer un utilisateur

Point de terminaison

Paramètres

Exemple

Réponse

Provisionner un compte de service

Point de terminaison

Paramètres

Exemple

Réponse

Déprovisionner un compte de service

Point de terminaison

Paramètres

Exemple

Supprimer un utilisateur

Point de terminaison

Paramètres

Exemple

Mettre à jour l’adresse e-mail d’un utilisateur

Point de terminaison

Paramètres

Exemple

Mettre à jour le nom d’affichage d’un utilisateur

Point de terminaison

Paramètres

Exemple

Désactiver un utilisateur

Point de terminaison

Paramètres

Exemple

Réponse

Réactiver un utilisateur

Point de terminaison

Paramètres

Exemple

Attribuer un rôle d’organisation

Point de terminaison

Paramètres

Exemple

Mettre à jour la licence Models

Point de terminaison

Paramètres

Exemple

Mettre à jour le rôle Weave

Point de terminaison

Paramètres

Exemple

Mettre à jour l’accès au registre

Point de terminaison

Paramètres

Exemple

Attribuer un rôle d’équipe

Point de terminaison

Paramètres

Exemple

Ajouter au registre

Point de terminaison

Paramètres

Exemple