Skip to content

Microsoft Entra SSO

Microsoft Entra SSOは、MicrosoftのクラウドベースのIDおよびアクセス管理サービスで、従業員のサインインやリソースへのアクセスを支援します。Entra SSOを使用すると、ビジネス要件に基づいてアプリやアプリリソースへのアクセスを制御できます。

要件

設定時に、Assertion Consumer Service (ACS) URL の提供を求められます。

要件 詳細
Assertion Consumer Service (ACS) URL https://<SUBDOMAIN>.braze.com/auth/saml/callback
一部のIDプロバイダーでは、Reply URL、Audience URL、またはAudience URIと呼ばれることもあります。
Entity ID braze_dashboard
RelayState APIキー IDプロバイダーログインを有効にするには、設定 > 設定とテスト > APIと識別子に移動し、APIキータブを選択して、sso.saml.login 権限を持つAPIキーを作成します。

Microsoft Entra SSOにおけるサービスプロバイダー（SP）主導のログイン

  1. Microsoft Entra管理センターで、Identity > Applications > Enterprise Applications に移動し、New application を選択します。
  2. 検索ボックスで Braze を検索し、結果パネルから選択して、Add を選択します。

ステップ2:Microsoft Entra SSOを設定する

  1. Microsoft Entra管理センターで、Brazeアプリケーション統合ページに移動し、Single sign-on を選択します。
  2. Select a single sign-on method ページで、方式として SAML を選択します。
  3. Set up Single Sign-On with SAML ページで、Basic SAML Configuration の編集アイコンを選択します。
  4. Brazeインスタンスと次のパターンを組み合わせた Reply URL を入力して、IdP主導モードでアプリケーションを設定します：https://<SUBDOMAIN>.braze.com/auth/saml/callback。
  5. Relay State フィールドにRelay Stateで生成されたAPIキーを入力して、RelayStateを設定します。
  1. Brazeが期待する特定の形式でSAMLアサーションをフォーマットします。ユーザー属性とユーザークレームに関する以下のタブを参照して、これらの属性と値をどのようにフォーマットする必要があるかを確認してください。

これらの属性の値は、Application Integration ページの User Attributes セクションから管理できます。

以下の属性ペアリングを使用してください：

  • 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

Set up Single Sign-On with SAML ページで、Edit を選択して User Attributes ダイアログを開きます。次に、適切な形式に従ってユーザークレームを編集します。

以下のクレーム名ペアリングを使用してください：

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

これらのユーザークレームと値は、Manage claim セクションから管理できます。

  1. Set up Single Sign-On with SAML ページに移動し、SAML Signing Certificate セクションまでスクロールして、要件に基づいて適切な Certificate (Base64) をダウンロードします。
  2. Set up Braze セクションに移動し、Brazeの設定で使用する適切なURLをコピーします。

ステップ3:Braze内でMicrosoft Entra SSOを設定する

Microsoft Entra管理センター内でBrazeを設定すると、Microsoft Entraがターゲット URL（ログインURL）と x.509 証明書を提供します。これらをBrazeアカウントに入力します。

アカウントマネージャーがアカウントのSAML SSOを有効にした後、以下を行います：

  1. 設定 > 会社設定 > 管理者設定 > セキュリティ設定 に移動し、SAML SSOセクションを ON に切り替えます。
  2. 同じページで、以下を追加します：
要件 詳細
SAML Name ログイン画面のボタンテキストとして表示されます。通常、「Microsoft Entra」のようなIDプロバイダーの名前です。
Target URL Microsoft Entraが提供するログインURLです。
Certificate x.509 PEMエンコードされた証明書で、IDプロバイダーから提供されます。
New Stuff!