Skip to content

SSO Microsoft Entra

Microsoft Entra SSO 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 SSO 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 Assertion Consumer Service (ACS).

Exigence Détails
URL Assertion Consumer Service (ACS) https://<SUBDOMAIN>.braze.com/auth/saml/callback
Pour certains fournisseurs d’identité, cette URL peut également être appelée URL de réponse, URL d’audience ou URI d’audience.
Entity ID braze_dashboard
Clé API RelayState Pour activer la connexion via le fournisseur d’identité, accédez à Paramètres > Configuration et test > API et identifiants, sélectionnez l’onglet Clés API, puis créez une clé API avec les permissions sso.saml.login.

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

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

Étape 2 : Configurer Microsoft Entra SSO

  1. Dans votre centre d’administration Microsoft Entra, accédez à la page d’intégration de votre 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 format suivant : https://<SUBDOMAIN>.braze.com/auth/saml/callback.
  5. Configurez le RelayState en saisissant votre clé API de 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 utilisateur 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 revendication 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 SSO 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 (SSO) 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 SSO 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é, comme « 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!