Skip to content

Provisionnement automatisé des utilisateurs

Le provisionnement automatisé des utilisateurs vous permet de créer et de gérer les utilisateurs de Braze via une API au lieu de le faire manuellement dans le tableau de bord. Braze prend en charge cette fonctionnalité via le système SCIM (System for Cross-domain Identity Management). Cet article vous explique quelles informations fournir, comment générer votre jeton SCIM et où trouver votre endpoint API SCIM.

Accéder aux paramètres de provisionnement SCIM

  1. Dans le tableau de bord de Braze, accédez à Paramètres > Paramètres d’administration > Provisionnement SCIM, puis sélectionnez Configurer l’intégration SCIM.
  2. À l’étape Configuration de Braze, sélectionnez une méthode de provisionnement et fournissez les paramètres d’accès.

Une page pour configurer l'intégration SCIM avec des sections pour sélectionner une méthode de provisionnement et fournir les paramètres d'accès.

  1. À l’étape Configuration de l’IdP, suivez les étapes au sein de la plateforme pour la méthode de provisionnement sélectionnée.

Utilisez l’option Okta - Application Braze si vous avez configuré l’application Braze pour l’authentification unique (SSO) SAML dans Okta. Si vous avez configuré une application personnalisée pour le SSO, suivez les instructions dans l’onglet Okta - Intégration d’application personnalisée.

Étape 1 : Configurer le provisionnement SCIM

Étape 1.1 : Activer SCIM

  1. Dans Okta, accédez à Applications > Applications, puis sélectionnez Create App Integration. Sélectionnez SAML 2.0 comme méthode de connexion.
  2. Renseignez les informations suivantes (qui se trouvent dans l’étape Configuration de l’IdP de Braze) pour créer une application personnalisée :
    • Logo de l’application
    • URL d’authentification unique
    • URL d’audience (ID d’entité SP)
  3. Sélectionnez Finish.
  4. Sélectionnez l’onglet General.
  5. Dans la section App Settings, sélectionnez Edit.
  6. Dans le champ Provisioning, sélectionnez SCIM.

Étape 1.2 : Désactiver la visibilité de l’application

  1. Dans le champ Application visibility, cochez la case Do not display application icon to user. Cela empêche les utilisateurs d’accéder au SSO via l’application, qui est uniquement destinée au SCIM.
  2. Sélectionnez Save.

Étape 1.3 : Configurer l’intégration SCIM

  1. Sélectionnez l’onglet Provisioning.
  2. Dans Settings > Integration > SCIM Connection, sélectionnez Edit et renseignez les valeurs des champs qui apparaissent dans le tableau de la page Setup SCIM provisioning.

Étape 1.4 : Tester les identifiants API

Sélectionnez Test API Credentials. Un message de vérification apparaît si l’intégration est réussie et vous pouvez enregistrer.

Étape 1.5 : Activer le provisionnement vers l’application

  1. Dans Provisioning > Settings > To App > Provisioning to App, sélectionnez Edit.
  2. Activez les options suivantes :
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Vérifiez et configurez la section Attribute Mapping avec les mappages qui apparaissent dans le tableau de la page Setup SCIM provisioning.

Étape 2 : Assigner des utilisateurs à l’application

  1. Sélectionnez l’onglet Assignment.
  2. Sélectionnez Assign et choisissez une option.
  3. Assignez l’application aux personnes qui doivent avoir accès à Braze.
  4. Sélectionnez Done lorsque vous avez terminé l’assignation.

Utilisez l’option Okta - Intégration d’application personnalisée si vous avez configuré une application personnalisée pour le SSO. Si vous avez configuré l’application Braze pour l’authentification unique (SSO) SAML dans Okta, suivez les instructions dans l’onglet Okta - Application Braze.

Étape 1 : Configurer le provisionnement SCIM

Étape 1.1 : Activer SCIM

  1. Dans Okta, accédez à votre application Braze.
  2. Sélectionnez l’onglet General.
  3. Dans la section App Settings, sélectionnez Edit.
  4. Dans le champ Provisioning, sélectionnez SCIM.
  5. Sélectionnez Save.

Étape 1.2 : Configurer l’intégration SCIM

  1. Sélectionnez l’onglet Provisioning.
  2. Dans Settings > Integration > SCIM Connection, sélectionnez Edit et renseignez les valeurs des champs qui apparaissent dans le tableau de la page Setup SCIM provisioning.
  3. Testez les identifiants API en sélectionnant Test API Credentials.
  4. Sélectionnez Save.

Étape 1.3 : Activer le provisionnement vers l’application

  1. Dans Provisioning > Settings > To App > Provisioning to App, sélectionnez Edit.
  2. Activez les options suivantes :
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Vérifiez et configurez la section Attribute Mapping avec les mappages qui apparaissent dans le tableau de la page Setup SCIM provisioning.

Étape 2 : Assigner des utilisateurs à l’application

  1. Sélectionnez l’onglet Assignment.
  2. Sélectionnez Assign et choisissez une option.
  3. Assignez l’application aux personnes qui doivent avoir accès à Braze.
  4. Sélectionnez Done.

Étape 1 : Configurer l’application de provisionnement SCIM

Étape 1.1 : Se connecter au centre d’administration Microsoft Entra

Connectez-vous à votre centre d’administration Microsoft Entra.

Étape 1.2 : Créer et configurer votre application SCIM

  1. Dans le menu de navigation, accédez à Entra ID > Enterprise apps.
  2. Sélectionnez New application.
  3. Sélectionnez Create your own application.
  4. Dans le panneau, saisissez un nom pour votre application.
  5. Dans la section What are you looking to do with your application?, sélectionnez Integrate application you don’t find in the gallery (Non-gallery).
  6. Sélectionnez Create.

Étape 1.3 : Configurer l’intégration SCIM

  1. Accédez à la section Manage > Provisioning de votre application SCIM.
  2. Sélectionnez Connect your application ou New configuration et renseignez les valeurs des champs qui apparaissent dans le tableau de la page Setup SCIM provisioning.

Étape 1.4 : Activer le provisionnement vers l’application

  1. Accédez à la section Manage > Attribute mapping (Preview) de votre application SCIM.
  2. Sélectionnez Provision Microsoft Entra ID Users.
  3. Vérifiez et configurez la section Attribute Mapping pour correspondre aux attributs qui apparaissent dans le tableau de la page Setup SCIM provisioning.
  4. Fermez la page Attribute Mapping.

Étape 2 : Assigner des utilisateurs à l’application

  1. Accédez à Manage > Users and Groups.
  2. Sélectionnez Add user/group.
  3. Sélectionnez None Selected pour assigner des utilisateurs à l’application.
  4. Sélectionnez le bouton Select pour confirmer l’assignation.

Étape 1 : Configurer vos paramètres SCIM

  • Espace de travail par défaut : Sélectionnez l’espace de travail dans lequel les nouveaux utilisateurs doivent être ajoutés par défaut. Si vous ne spécifiez pas d’espace de travail dans votre requête API SCIM, Braze assigne les utilisateurs à cet espace de travail.
  • Origine du service : Saisissez le domaine d’origine de vos requêtes SCIM. Braze l’utilise dans l’en-tête X-Request-Origin pour vérifier la provenance des requêtes.
  • Liste d’adresses IP autorisées (facultatif) : Vous pouvez restreindre les requêtes SCIM à des adresses IP spécifiques. Saisissez une liste ou une plage d’adresses IP séparées par des virgules. L’en-tête X-Request-Origin de chaque requête est utilisé pour vérifier l’adresse IP de la requête par rapport à la liste autorisée.

Étape 2 : Générer un jeton SCIM

Après avoir renseigné les champs obligatoires, appuyez sur Generate SCIM token pour générer un jeton SCIM et afficher votre endpoint API SCIM. Assurez-vous de copier le jeton SCIM avant de quitter la page. Ce jeton n’apparaît qu’une seule fois.

Champs endpoint API SCIM et jeton SCIM affichés avec des valeurs masquées et des boutons de copie. Sous le champ du jeton se trouve un bouton « Reset Token ».

Braze exige que toutes les requêtes SCIM contiennent le jeton porteur (bearer token) de l’API SCIM, attaché via un en-tête HTTP Authorization.
New Stuff!