Microsoft Entra SSO

Microsoft Entra SSO ist der cloudbasierte Identitäts- und Zugriffsverwaltungsdienst von Microsoft, der Ihren Mitarbeitenden hilft, sich anzumelden und auf Ressourcen zuzugreifen. Sie können Entra SSO verwenden, um den Zugriff auf Ihre Apps und Ihre App-Ressourcen basierend auf Ihren Geschäftsanforderungen zu steuern.

Anforderungen

Bei der Einrichtung werden Sie aufgefordert, eine Assertion Consumer Service (ACS)-URL anzugeben.

Vom Service Provider (SP) initiierte Anmeldung mit Microsoft Entra SSO

Schritt 1: Braze aus der Galerie hinzufügen

1. Gehen Sie in Ihrem Microsoft Entra Admin Center zu Identity > Applications > Enterprise Applications und wählen Sie dann New application aus.
2. Suchen Sie im Suchfeld nach Braze, wählen Sie es im Ergebnisbereich aus und wählen Sie dann Add aus.

Schritt 2: Microsoft Entra SSO konfigurieren

1. Gehen Sie in Ihrem Microsoft Entra Admin Center zur Braze-Anwendungsintegrationsseite und wählen Sie Single sign-on aus.
2. Wählen Sie auf der Seite Select a single sign-on method die Option SAML als Methode aus.
3. Wählen Sie auf der Seite Set up Single Sign-On with SAML das Bearbeitungssymbol für Basic SAML Configuration aus.
4. Konfigurieren Sie die Anwendung im IdP-initiierten Modus, indem Sie eine Reply URL eingeben, die Ihre Braze-Instanz mit dem folgenden Muster kombiniert: https://<SUBDOMAIN>.braze.com/auth/saml/callback.
5. Konfigurieren Sie den RelayState, indem Sie Ihren per Relay State generierten API-Schlüssel in das Feld Relay State eingeben.

Wichtig

Legen Sie das Feld Sign-On URL nicht fest. Lassen Sie dieses Feld leer, um Probleme mit Ihrem IdP-initiierten SAML SSO zu vermeiden.

6. Formatieren Sie SAML-Assertions in dem spezifischen Format, das Braze erwartet. In den folgenden Tabs zu Nutzerattributen und Nutzeransprüchen erfahren Sie, wie diese Attribute und Werte formatiert sein müssen.

• nutzerattribute
• nutzeransprüche

Sie können die Werte dieser Attribute im Abschnitt User Attributes auf der Seite Application Integration verwalten.

Verwenden Sie die folgenden Attributzuordnungen:

• 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

Wichtig

Das E-Mail-Feld muss mit dem übereinstimmen, was für Ihre Nutzer:innen in Braze eingerichtet ist. In den meisten Fällen ist dies dasselbe wie user.userprincipalname. Wenn Sie jedoch eine andere Konfiguration haben, arbeiten Sie mit Ihrem Systemadministrator zusammen, um sicherzustellen, dass diese Felder exakt übereinstimmen.

Wählen Sie auf der Seite Set up Single Sign-On with SAML die Option Edit aus, um den Dialog User Attributes zu öffnen. Bearbeiten Sie dann die Nutzeransprüche gemäß dem richtigen Format.

Verwenden Sie die folgenden Anspruchsnamenzuordnungen:

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

Wichtig

Das E-Mail-Feld muss mit dem übereinstimmen, was für Ihre Nutzer:innen in Braze eingerichtet ist. In den meisten Fällen ist dies dasselbe wie user.userprincipalname. Wenn Sie jedoch eine andere Konfiguration haben, arbeiten Sie mit Ihrem Systemadministrator zusammen, um sicherzustellen, dass diese Felder exakt übereinstimmen.

Sie können diese Nutzeransprüche und Werte im Abschnitt Manage claim verwalten.

8. Gehen Sie zur Seite Set up Single Sign-On with SAML, scrollen Sie dann zum Abschnitt SAML Signing Certificate und laden Sie das entsprechende Certificate (Base64) basierend auf Ihren Anforderungen herunter.
9. Gehen Sie zum Abschnitt Set up Braze und kopieren Sie die entsprechenden URLs zur Verwendung in der Braze-Konfiguration.

Schritt 3: Microsoft Entra SSO in Braze konfigurieren

Nachdem Sie Braze im Microsoft Entra Admin Center eingerichtet haben, stellt Microsoft Entra eine Ziel-URL (Anmelde-URL) und ein x.509-Zertifikat bereit, die Sie in Ihrem Braze-Konto eingeben.

Nachdem Ihr Account Manager SAML SSO für Ihr Konto aktiviert hat, gehen Sie wie folgt vor:

1. Gehen Sie zu Einstellungen > Unternehmenseinstellungen > Administratoreinstellungen > Sicherheitseinstellungen und schalten Sie den Abschnitt SAML SSO auf EIN.
2. Fügen Sie auf derselben Seite Folgendes hinzu:

Tipp

Wenn Sie möchten, dass sich Ihre Braze-Kontonutzer:innen nur mit SAML SSO anmelden, können Sie die Single-Sign-on-Authentifizierung einschränken auf der Seite Sicherheitseinstellungen unter Authentifizierungsregeln.