Zum Inhalt springen

Automatisierte Bereitstellung von Nutzer:innen

Die automatisierte Bereitstellung von Nutzer:innen ermöglicht es Ihnen, Braze-Nutzer:innen über eine API zu erstellen und zu verwalten, anstatt dies manuell im Dashboard zu tun. Braze unterstützt dies über das System for Cross-domain Identity Management (SCIM). In diesem Artikel erfahren Sie, welche Informationen Sie angeben müssen, wie Sie Ihr SCIM-Token generieren und wo Sie Ihren SCIM-API-Endpunkt finden.

Auf SCIM-Provisioning-Einstellungen zugreifen

  1. Gehen Sie im Braze-Dashboard zu Einstellungen > Unternehmenseinstellungen > Admin-Einstellungen > SCIM-Provisioning und wählen Sie dann SCIM-Integration konfigurieren aus.
  2. Wählen Sie im Schritt Braze-Konfiguration eine Provisioning-Methode aus und geben Sie die Zugriffseinstellungen an.

Eine Seite zum Einrichten der SCIM-Integration mit Bereichen zur Auswahl einer Provisioning-Methode und zur Angabe von Zugriffseinstellungen.

  1. Folgen Sie im Schritt IdP-Konfiguration den Anweisungen auf der Plattform für Ihre ausgewählte Provisioning-Methode.

Verwenden Sie die Option Okta - Braze app, wenn Sie die Braze-App für SAML SSO in Okta eingerichtet haben. Wenn Sie eine angepasste App für SSO eingerichtet haben, folgen Sie den Anweisungen im Tab Okta - Custom app integration.

Schritt 1: SCIM-Provisioning einrichten

Schritt 1.1: SCIM aktivieren

  1. Gehen Sie in Okta zu Applications > Applications und wählen Sie dann Create App Integration aus. Wählen Sie SAML 2.0 als Anmeldemethode aus.
  2. Geben Sie die folgenden Details ein (die Sie im Braze-Schritt IdP-Konfiguration finden), um eine angepasste App zu erstellen:
    • App-Logo
    • Single-Sign-on-URL
    • Audience-URL (SP-Entity-ID)
  3. Wählen Sie Finish aus.
  4. Wählen Sie den Tab General aus.
  5. Wählen Sie im Bereich App Settings die Option Edit aus.
  6. Wählen Sie im Feld Provisioning die Option SCIM aus.

Schritt 1.2: Sichtbarkeit der Anwendung deaktivieren

  1. Aktivieren Sie im Feld Application visibility das Kontrollkästchen Do not display application icon to user. Dadurch wird verhindert, dass Nutzer:innen über die App, die ausschließlich für SCIM vorgesehen ist, auf SSO zugreifen.
  2. Wählen Sie Save aus.

Schritt 1.3: SCIM-Integration einrichten

  1. Wählen Sie den Tab Provisioning aus.
  2. Wählen Sie unter Settings > Integration > SCIM Connection die Option Edit aus und geben Sie die Feldwerte ein, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.

Schritt 1.4: API-Zugangsdaten testen

Wählen Sie Test API Credentials aus. Wenn die Integration erfolgreich ist, erscheint eine Bestätigungsmeldung und Sie können speichern.

Schritt 1.5: Provisioning für die App aktivieren

  1. Wählen Sie unter Provisioning > Settings > To App > Provisioning to App die Option Edit aus.
  2. Aktivieren Sie Folgendes:
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Überprüfen und konfigurieren Sie den Bereich Attribute Mapping mit den Abbildungen, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.

Schritt 2: Nutzer:innen der App zuweisen

  1. Wählen Sie den Tab Assignment aus.
  2. Wählen Sie Assign und dann eine Option aus.
  3. Weisen Sie die App den Personen zu, die Zugriff auf Braze haben sollen.
  4. Wählen Sie Done aus, wenn Sie die Zuweisung abgeschlossen haben.

Verwenden Sie die Option Okta - Custom app integration, wenn Sie eine angepasste App für SSO eingerichtet haben. Wenn Sie die Braze-App für SAML SSO in Okta eingerichtet haben, folgen Sie den Anweisungen im Tab Okta - Braze app.

Schritt 1: SCIM-Provisioning einrichten

Schritt 1.1: SCIM aktivieren

  1. Gehen Sie in Okta zu Ihrer Braze-App.
  2. Wählen Sie den Tab General aus.
  3. Wählen Sie im Bereich App Settings die Option Edit aus.
  4. Wählen Sie im Feld Provisioning die Option SCIM aus.
  5. Wählen Sie Save aus.

Schritt 1.2: SCIM-Integration einrichten

  1. Wählen Sie den Tab Provisioning aus.
  2. Wählen Sie unter Settings > Integration > SCIM Connection die Option Edit aus und geben Sie die Feldwerte ein, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.
  3. Testen Sie die API-Zugangsdaten, indem Sie Test API Credentials auswählen.
  4. Wählen Sie Save aus.

Schritt 1.3: Provisioning für die App aktivieren

  1. Wählen Sie unter Provisioning > Settings > To App > Provisioning to App die Option Edit aus.
  2. Aktivieren Sie Folgendes:
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. Überprüfen und konfigurieren Sie den Bereich Attribute Mapping mit den Abbildungen, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.

Schritt 2: Nutzer:innen der App zuweisen

  1. Wählen Sie den Tab Assignment aus.
  2. Wählen Sie Assign und dann eine Option aus.
  3. Weisen Sie die App den Personen zu, die Zugriff auf Braze haben sollen.
  4. Wählen Sie Done aus.

Schritt 1: SCIM-Provisioning-App einrichten

Schritt 1.1: Beim Microsoft Entra Admin Center anmelden

Melden Sie sich bei Ihrem Microsoft Entra Admin Center an.

Schritt 1.2: SCIM-App erstellen und einrichten

  1. Gehen Sie im Navigationsmenü zu Entra ID > Enterprise apps.
  2. Wählen Sie New application aus.
  3. Wählen Sie Create your own application aus.
  4. Geben Sie im Panel einen Namen für Ihre App ein.
  5. Wählen Sie im Bereich What are you looking to do with your application? die Option Integrate application you don’t find in the gallery (Non-gallery) aus.
  6. Wählen Sie Create aus.

Schritt 1.3: SCIM-Integration einrichten

  1. Gehen Sie in Ihrer SCIM-Anwendung zum Bereich Manage > Provisioning.
  2. Wählen Sie Connect your application oder New configuration aus und geben Sie die Feldwerte ein, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.

Schritt 1.4: Provisioning für die App aktivieren

  1. Gehen Sie in Ihrer SCIM-Anwendung zum Bereich Manage > Attribute mapping (Preview).
  2. Wählen Sie Provision Microsoft Entra ID Users aus.
  3. Überprüfen und konfigurieren Sie den Bereich Attribute Mapping so, dass er mit den Attributen übereinstimmt, die in der Tabelle auf der Seite SCIM-Provisioning einrichten angezeigt werden.
  4. Schließen Sie die Seite Attribute Mapping.

Schritt 2: Nutzer:innen der App zuweisen

  1. Gehen Sie zu Manage > Users and Groups.
  2. Wählen Sie Add user/group aus.
  3. Wählen Sie None Selected aus, um der App Nutzer:innen zuzuweisen.
  4. Wählen Sie den Button Select aus, um die Zuweisung zu bestätigen.

Schritt 1: SCIM-Einstellungen konfigurieren

  • Standard-Workspace: Wählen Sie den Workspace aus, dem neue Nutzer:innen standardmäßig hinzugefügt werden sollen. Wenn Sie in Ihrer SCIM-API-Anfrage keinen Workspace angeben, weist Braze die Nutzer:innen diesem Workspace zu. Wenn Ihre Anfrage keine permissions enthält, erteilt Braze den Nutzer:innen in diesem Workspace die Standard-Berechtigungen.
  • Dienst-Herkunft: Geben Sie die Herkunftsdomain Ihrer SCIM-Anfragen ein. Braze verwendet diese im Header X-Request-Origin, um zu überprüfen, woher Anfragen stammen.
  • IP-Allowlisting (optional): Sie können SCIM-Anfragen auf bestimmte IP-Adressen beschränken. Geben Sie eine kommagetrennte Liste oder einen Bereich zulässiger IP-Adressen ein. Anhand des Headers X-Request-Origin in jeder Anfrage wird die IP-Adresse der Anfrage mit der Allowlist abgeglichen.

Schritt 2: SCIM-Token generieren

Nachdem Sie die Pflichtfelder ausgefüllt haben, klicken Sie auf SCIM-Token generieren, um ein SCIM-Token zu generieren und Ihren SCIM-API-Endpunkt anzuzeigen. Kopieren Sie das SCIM-Token unbedingt, bevor Sie die Seite verlassen. Dieses Token wird nur einmal angezeigt.

Felder „SCIM API Endpoint“ und „SCIM Token“ mit maskierten Werten und Kopier-Buttons. Unter dem Token-Feld befindet sich ein Button „Reset Token“.

Braze erwartet, dass alle SCIM-Anfragen das SCIM-API-Bearer-Token in einem HTTP-Header Authorization enthalten.

Standardberechtigungen für neue Nutzer:innen

Wenn SCIM über die Okta- oder Entra-ID-Integration Nutzer:innen ohne Berechtigungsliste anlegt, erhalten diese Nutzer:innen von Braze einen Standardsatz schreibgeschützter Berechtigungen für Ihren Standard-Workspace. Das gilt auch für angepasste SCIM-API-Anfragen, die permissions nicht enthalten.

Der Standardsatz enthält keine Berechtigung zum Erstellen, Bearbeiten, Archivieren, Löschen, Exportieren oder Versenden. Um Nutzer:innen mehr Zugriff zu gewähren, verwenden Sie die SCIM-Gruppenrollen-Abbildung oder bearbeiten Sie die Nutzer:innen in Braze.

Produktbereich Berechtigungen
Messaging Campaigns anzeigen, Canvases anzeigen, Canvas-Templates anzeigen, Feature-Flags anzeigen, Platzierungen anzeigen, Einstellungen zur Nachrichtenpriorisierung anzeigen, Frequency-Capping-Regeln anzeigen, Messaging-Rate-Limits anzeigen, Globale Kontrollgruppe anzeigen, Einstellungen für Ruhezeiten anzeigen, Dashboard-Berichte anzeigen
Inhalt Content Blocks anzeigen, E-Mail-Templates anzeigen, E-Mail-Link-Templates anzeigen, IAM-Templates anzeigen, Webhook-Templates anzeigen, Assets der Medienbibliothek anzeigen, Präferenzzentren anzeigen, Aktionscodes anzeigen, Standorte anzeigen, Lokalisierungseinstellungen anzeigen
Zielgruppe und Daten Segments anzeigen, Angepasste Attribute anzeigen, Angepasste Events anzeigen, Kataloge anzeigen, Datensätze zu Nutzerzusammenführungen anzeigen, Einstellungen für Audience Sync anzeigen
Kanaleinstellungen E-Mail-Einstellungen anzeigen, Push-Einstellungen anzeigen, WhatsApp-Einstellungen anzeigen, WhatsApp-Katalog anzeigen, WhatsApp Flows anzeigen, WhatsApp-Nachrichten-Templates von Meta anzeigen
Decisioning Studio Decisioning Studio Agent anzeigen, Decisioning Studio Zielgruppe anzeigen, Decisioning Studio Action Banks anzeigen, Konversions-Event anzeigen, Decisioning Studio Guardrails anzeigen, Decisioning Studio Timing anzeigen
New Stuff!