Skip to content

authentification unique Microsoft Entra

Microsoft Entra authentification unique est le service cloud de gestion des identités et des accès de Microsoft, qui aide vos employés à se connecter et à accéder aux ressources. Vous pouvez utiliser Entra authentification unique pour contrôler l’accès à vos applications et à leurs ressources, en fonction de vos besoins métier.

Exigences

Lors de la configuration, il vous est demandé de fournir une URL ACS (Assertion Consumer Service).

Exigence Détails
URL Assertion Consumer Service (ACS) https://<SUBDOMAIN>.braze.com/auth/saml/callback
Pour certains fournisseurs d’identité, cela peut également être désigné comme l’URL de réponse, l’URL d’audience ou l’URI d’audience.
Entity ID braze_dashboard par défaut.

Pour attribuer un Entity ID unique à ce tableau de bord, activez un Entity ID personnalisé et utilisez la valeur générée (braze_dashboard_<COMPANY_ID>) à la place. Pour les étapes, consultez Utiliser un Entity ID personnalisé.
Clé API RelayState Pour activer la connexion via le fournisseur d’identité, accédez à Paramètres > Clés API et créez une clé API avec les permissions sso.saml.login.

Connexion initiée par le fournisseur de services (SP) avec Microsoft Entra authentification unique

  1. Dans votre centre d’administration Microsoft Entra, accédez à Identity > Applications > Enterprise Applications, puis sélectionnez New application.
  2. Recherchez Braze dans la barre de recherche, sélectionnez-le dans le panneau de résultats, puis sélectionnez Add.

Étape 2 : Configurer Microsoft Entra authentification unique

  1. Dans votre centre d’administration Microsoft Entra, accédez à la page d’intégration de l’application Braze et sélectionnez Single sign-on.
  2. Sur la page Select a single sign-on method, sélectionnez SAML comme méthode.
  3. Sur la page Set up Single Sign-On with SAML, sélectionnez l’icône de modification pour Basic SAML Configuration.
  4. Configurez l’application en mode initié par l’IdP en saisissant une Reply URL qui combine votre instance Braze avec le modèle suivant : https://<SUBDOMAIN>.braze.com/auth/saml/callback.
  5. Dans la même section Basic SAML Configuration, laissez Identifier (Entity ID) défini sur braze_dashboard, sauf si vous utilisez un Entity ID personnalisé. Dans ce cas, saisissez la valeur générée par votre tableau de bord (braze_dashboard_<COMPANY_ID>) afin qu’elle corresponde à la valeur affichée dans vos paramètres de sécurité Braze.
  6. Configurez le RelayState en saisissant votre clé API Relay State générée dans le champ Relay State.
  1. Formatez les assertions SAML dans le format spécifique attendu par Braze. Consultez les onglets suivants sur les attributs et les revendications utilisateur pour comprendre comment ces attributs et valeurs doivent être formatés.

Vous pouvez gérer les valeurs de ces attributs depuis la section User Attributes sur la page Application Integration.

Utilisez les paires d’attributs suivantes :

  • givenname = user.givenname
  • surname= user.surname
  • emailaddress = user.mail
  • name = user.userprincipalname
  • email = user.userprincipalname
  • first_name = user.givenname
  • last_name = user.surname
  • Unique User Identifier = user.userprincipalname

Sur la page Set up Single Sign-On with SAML, sélectionnez Edit pour ouvrir la boîte de dialogue User Attributes. Modifiez ensuite les revendications utilisateur selon le format approprié.

Utilisez les paires de noms de revendications suivantes :

  • claims/givenname = user.givenname
  • claims/surname = user.surname
  • claims/emailaddress = user.userprincipalname
  • claims/name = user.userprincipalname
  • claims/nameidentifier = user.userprincipalname

Vous pouvez gérer ces revendications et valeurs utilisateur depuis la section Manage claim.

  1. Accédez à la page Set up Single Sign-On with SAML, puis faites défiler jusqu’à la section SAML Signing Certificate et téléchargez le Certificate (Base64) approprié en fonction de vos besoins.
  2. Accédez à la section Set up Braze et copiez les URL appropriées pour les utiliser dans la configuration Braze.

Étape 3 : Configurer Microsoft Entra authentification unique dans Braze

Après avoir configuré Braze dans le centre d’administration Microsoft Entra, Microsoft Entra fournit une URL cible (URL de connexion) et un certificat x.509, que vous saisissez dans votre compte Braze.

Une fois que votre gestionnaire de compte a activé l’authentification unique SAML pour votre compte, procédez comme suit :

  1. Accédez à Paramètres > Paramètres de l’entreprise > Paramètres d’administration > Paramètres de sécurité et basculez la section authentification unique SAML sur ON.
  2. Sur la même page, ajoutez les éléments suivants :
Exigence Détails
SAML Name Ce nom apparaîtra comme texte du bouton sur l’écran de connexion. Il s’agit généralement du nom de votre fournisseur d’identité, par exemple « Microsoft Entra ».
Target URL Il s’agit de l’URL de connexion fournie par Microsoft Entra.
Certificate Le certificat x.509 encodé en PEM est fourni par votre fournisseur d’identité.
New Stuff!