Gestion des utilisateurs de votre organisation avec SCIM
Une fois que vous avez vérifié votre domaine et configuré l'authentification SAML pour votre organisation, vous pouvez générer un jeton d'API SCIM.
Sur cette page
Fonctionnalités
Si vous fournissez le jeton de l’API SCIM à votre fournisseur de services d’identité, vous pouvez effectuer les actions suivantes par son intermédiaire :
- créer des utilisateurs
- attribuer ou mettre à jour les rôles des utilisateurs
- désactiver des utilisateurs
Exigences
Avant de configurer la gestion des utilisateurs avec SCIM, vous devez vérifier votre domaine et créer une configuration SAML. Vous ne pouvez gérer que les utilisateurs associés à un domaine que vous avez vérifié.
Configurer la gestion des utilisateurs avec SCIM
- Dans l’interface administrateur Shopify, allez à Users (Utilisateurs) > Security (Sécurité).
- Dans la section Intégration SCIM, cliquez sur Générer le jeton d’API.
- Cliquez sur Copier pour copier le jeton généré dans votre presse-papiers.
- Indiquez le jeton à votre fournisseur de services d’identité. La procédure d'ajout du jeton dépend du fournisseur que vous utilisez.
Terminer la configuration SCIM dans Okta
- Ouvrez l’application Shopify Plus.
-
Cliquez sur l’onglet Sign On (Se connecter).
- Définissez le format d’utilisateur de l’application sur e-mail.
- Cliquez sur Save (Enregistrer).
-
Cliquez sur l’onglet Provisionnement.
- Cliquez sur Configurer l’intégration de l’API.
- Cochez Activer l’intégration de l’API, puis collez le jeton de l’API dans le champ fourni.
- Cliquez sur Tester les informations d’identification de l’API. En cas d’erreur, vérifiez que vous avez correctement copié le jeton de l’API à partir de votre interface administrateur Shopify Plus. Si les erreurs persistent, contactez l’assistance Shopify Plus.
- Cliquez sur Save (Enregistrer).
Terminer la configuration SCIM dans OneLogin
- Ouvrez l’application Shopify Plus.
-
Cliquez sur l’élément de menu Configuration.
- Dans le champ SCIM Bearer Token (Jeton du porteur SCIM), collez le jeton de l’API.
- Cliquez sur Save (Enregistrer).
-
Cliquez sur l’élément de menu Parameters (Paramètres).
- Paramétrez la valeur par défaut de SCIM Username (Nom d’utilisateur SCIM) sur Email (E-mail).
- Cliquez sur Save (Enregistrer).
Terminer la configuration SCIM dans Azure
- Ouvrez l’application Shopify Plus.
- Cliquez sur l’élément de menu Provisionnement.
- Cliquez sur Démarrer.
- Dans le menu Mode de provisionnement, sélectionnez Automatique.
- Dans le champ URL du client, saisissez l’URL de base
https://shopifyscim.com/scim/v2/. - Dans le champ Jeton secret, saisissez le jeton de l’API.
- Cliquez sur le bouton Tester la connexion. Si vous rencontrez une erreur, vérifiez que vous avez correctement copié le jeton de l'API à partir de votre interface administrateur Shopify Plus. Si les erreurs persistent, contactez l'assistance Shopify Plus.
- Cliquez sur Save (Enregistrer).
- Faites passer le commutateur Statut de provisionnement à Activé.
- Cliquez sur Save (Enregistrer).
Une fois que le jeton de l'API a été ajouté à votre fournisseur de services d’identité, vous pouvez ajouter ou supprimer des utilisateurs par le biais de ce service. En fonction de leur statut dans Shopify et de votre fournisseur de services d’identité, cela peut avoir pour effet de modifier leur mode de connexion à Shopify.
| Statut utilisateur | Effet dans Shopify |
|---|---|
| L’utilisateur existe déjà dans votre organisation | Si vous ajoutez un utilisateur dans votre fournisseur de services d’identité, cet utilisateur est tenu de se connecter avec l’authentification SAML si toutes les situations suivantes sont vraies :
|
| L’utilisateur existe dans Shopify, mais pas dans votre organisation | Si vous ajoutez un utilisateur via votre fournisseur de services d’identité, cet utilisateur est alors ajouté à votre organisation et doit se connecter par le biais de l’authentification SAML si toutes les situations suivantes sont vraies :
|
| L’utilisateur n’existe pas dans Shopify | Si vous ajoutez un utilisateur via votre fournisseur de services d’identité, cet utilisateur est ajouté à votre organisation et doit se connecter par le biais de l’authentification SAML si toutes les conditions suivantes sont vraies :
|
Après avoir ajouté le jeton d’API, lorsque vous ajoutez un nouvel utilisateur qui n’existait pas précédemment dans Shopify, soit par le biais de votre fournisseur d’identité, soit à travers l’interface administrateur de l’organisation, le statut de votre nouvel utilisateur est configuré sur en attente. Si votre utilisateur est tenu de se connecter avec SAML, son statut restera en attente jusqu’à ce qu’il se connecte en passant par votre fournisseur d’identité.
Attribution de rôles dans SCIM
Une fois votre configuration de SCIM terminée, vous avez l’option d’attribuer des rôles aux utilisateurs de SCIM par le biais de votre fournisseur de services d’identité. Avant d’attribuer un rôle à un utilisateur, vérifiez que ce rôle existe bien dans votre organisation. En effet, les utilisateurs existants de SCIM ne seront pas mis à jour si le rôle n’a pas été créé pour votre organisation.
Attribuer des rôles dans des fournisseurs de services d’identité pris en charge
Les applications OneLogin et Okta proposent maintenant une assistance dédiée à l’attribution de rôles. Pour l’application Azure, cette assistance sera ajoutée ultérieurement. Pour attribuer ou mettre à jour un rôle d’utilisateur SCIM dans OneLogin ou Okta, changez le nom du rôle d’un utilisateur SCIM existant sur le portail de provisionnement du fournisseur de services d’identité.
Attribuer des rôles dans des fournisseurs de services d’identité non pris en charge
Si votre fournisseur de services d’identité n’a pas d’application Shopify Plus, vous devez modifier votre configuration SCIM manuellement. Avant de commencer, vérifiez que votre fournisseur de services d’identité peut ajouter des rôles en tant que champ SCIM.
Pour attribuer ou mettre à jour un rôle d’utilisateur SCIM, le corps JSON des requêtes POST, PUT et PATCH doit inclure le code suivant :
json
{
"name": {
"givenName": "given_name"
"familyName": "family_name"
},
"userName": "email",
"roles": [{"value": "role_name"}]
}
Le corps JSON SCIM doit inclure une clé appelée roles. Cette clé roles doit être un tableau contenant un hachage qui stocke le nom du rôle. Si plusieurs hachages de noms de rôle sont fournis, seul le dernier est utilisé pour attribuer un rôle. Si le nom de rôle n’est pas valide ou que le corps JSON SCIM ne correspond pas au modèle ci-dessus, les rôles ne sont ni attribués ni mis à jour.
Annuler l’attribution de rôles
Pour annuler l’attribution d’un rôle d’utilisateur, utilisez l’interface administrateur Shopify. En savoir plus sur l’annulation de l’attribution des rôles d’utilisateurs dans Shopify.
Supprimer l’intégration SCIM
Si vous n'avez plus besoin d'une intégration SCIM, vous pouvez la supprimer, mais sachez que action est irréversible. Pour la réactiver, vous devez générer un nouveau jeton d’API.
Étapes :
- Dans l’interface administrateur Shopify, allez à Users (Utilisateurs) > Security (Sécurité).
- Dans la section Intégration SCIM, cliquez sur ... à côté du jeton de l’API.
- Cliquez sur Supprimer le jeton.
Restrictions
Il n'est pas possible de supprimer les propriétaires de boutique et les propriétaires d’organisation par le biais d’un fournisseur de services d’identité. Les deux types de propriété doivent être transférés avant que l’utilisateur ou l'utilisatrice puisse être supprimé(e). Vous pouvez modifier le/la propriétaire d'une boutique depuis votre interface administrateur Shopify. Pour modifier le/la propriétaire d'une organisation, contactez l’assistance Shopify Plus.