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 です。

このダッシュボードに一意の Entity ID を設定するには、カスタム Entity ID を有効にし、生成された値（braze_dashboard_<COMPANY_ID>）を使用してください。手順については、カスタム Entity ID の使用を参照してください。
RelayState API キー IDプロバイダーログインを有効にするには、設定 > API キーに移動し、sso.saml.login 権限を持つ API キーを作成します。

サービスプロバイダー（SP）によるMicrosoft Entra SSO内でのログイン開始

  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. 同じ Basic SAML Configuration セクションで、カスタムEntity IDを使用しない限り、Identifier (Entity ID) は braze_dashboard のままにします。カスタムEntity IDを使用する場合は、Brazeのセキュリティ設定に表示される値と一致するように、ダッシュボードで生成された値（braze_dashboard_<COMPANY_ID>）を入力します。
  6. 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 ログイン画面のボタンテキストとして表示されます。通常、これはIDプロバイダーの名前です（「Microsoft Entra」など）。
Target URL Microsoft Entraが提供するログインURLです。
Certificate x.509 PEMエンコード証明書で、IDプロバイダーから提供されます。
New Stuff!