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.

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

  1. Dans l’interface administrateur Shopify, allez à Users (Utilisateurs) > Security (Sécurité).
  2. Dans la section Intégration SCIM, cliquez sur Générer le jeton d’API.
  3. Cliquez sur Copier pour copier le jeton généré dans votre presse-papiers.
  4. Indiquez le jeton à votre fournisseur de services d’identité. La procédure d'ajout du jeton dépend du fournisseur que vous utilisez.

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.

Effets de la création d’un utilisateur dans un fournisseur d’identité
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 déjà dans Shopify
  • l'utilisateur existe déjà dans votre organisation
  • vous utilisez le niveau d'application Utilisateurs spécifiques
Supprimer l’accès d’un utilisateur en passant par votre fournisseur d’identité peut avoir un effet différent selon son statut. Si vous supprimez l’accès d’un utilisateur actif à Shopify par le biais de votre fournisseur de services d’identité, celui-ci sera supprimé de votre organisation. Si vous supprimez définitivement un utilisateur par le biais de votre fournisseur de services d’identité, il est possible que celui-ci soit supprimé de votre organisation, selon la configuration de votre fournisseur d’identité.
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 existe déjà dans Shopify
  • l’utilisateur n’existe pas dans votre organisation spécifique
  • vous utilisez le niveau d'application Obligatoire ou Utilisateurs spécifiques
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 :

  • l'utilisateur n'existe pas dans Shopify
  • vous utilisez le niveau d'application Obligatoire ou Utilisateurs spécifiques
Lorsque l’utilisateur se connecte à l’interface administrateur Shopify de l'organisation pour la première fois, il doit le faire par l'intermédiaire du fournisseur d’identité, et non via la page de connexion de Shopify.

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 :

  1. Dans l’interface administrateur Shopify, allez à Users (Utilisateurs) > Security (Sécurité).
  2. Dans la section Intégration SCIM, cliquez sur ... à côté du jeton de l’API.
  3. 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.

Prêt(e) à commencer à vendre avec Shopify ?

Essayez gratuitement