コンテンツにスキップ

自動ユーザープロビジョニング

自動ユーザープロビジョニングを使用すると、ダッシュボードで手動で行う代わりに、APIを通じてBrazeユーザーを作成・管理できます。Brazeはクロスドメインid管理用システム(SCIM)を通じてこの機能をサポートしています。この記事では、提供すべき情報、SCIMトークンの生成方法、SCIM APIエンドポイントの場所について説明します。

SCIM プロビジョニング設定へのアクセス

  1. Braze ダッシュボードで、設定 > 会社の設定 > 管理者設定 > SCIM プロビジョニングに移動し、SCIM 統合を設定を選択します。
  2. Braze 設定ステップで、プロビジョニング方法を選択し、アクセス設定を入力します。

プロビジョニング方法の選択とアクセス設定の入力セクションがある、SCIM 統合の設定ページ。

  1. IdP 設定ステップで、選択したプロビジョニング方法に対応するプラットフォーム内の手順に従います。

Okta で SAML SSO 用に Braze アプリを設定した場合は、Okta - Braze app オプションを使用します。SSO 用にカスタムアプリを設定した場合は、Okta - Custom app integration タブの手順に従ってください。

ステップ 1:SCIM プロビジョニングを設定する

ステップ 1.1:SCIM を有効にする

  1. Okta で Applications > Applications に移動し、Create App Integration を選択します。サインイン方法として SAML 2.0 を選択します。
  2. 以下の詳細 (Braze の IdP 設定ステップに記載されています) を入力して、カスタムアプリを作成します。
    • アプリのロゴ
    • シングルサインオン URL
    • オーディエンス URL (SP エンティティ ID)
  3. Finish を選択します。
  4. General タブを選択します。
  5. App Settings セクションで Edit を選択します。
  6. Provisioning フィールドで SCIM を選択します。

ステップ 1.2:アプリケーションの表示を無効にする

  1. Application visibility フィールドで、Do not display application icon to user チェックボックスを選択します。これにより、SCIM 専用のこのアプリを通じてユーザーが SSO にアクセスできなくなります。
  2. Save を選択します。

ステップ 1.3:SCIM 統合を設定する

  1. Provisioning タブを選択します。
  2. Settings > Integration > SCIM Connection で Edit を選択し、SCIM プロビジョニングの設定ページの表に表示されるフィールド値を入力します。

ステップ 1.4:API 認証情報をテストする

Test API Credentials を選択します。統合が成功すると確認メッセージが表示され、保存できるようになります。

ステップ 1.5:アプリへのプロビジョニングを有効にする

  1. Provisioning > Settings > To App > Provisioning to App で Edit を選択します。
  2. 以下を有効にします。
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. SCIM プロビジョニングの設定ページの表に表示されるマッピングを使用して、Attribute Mapping セクションを確認し、設定します。

ステップ 2:アプリにユーザーを割り当てる

  1. Assignment タブを選択します。
  2. Assign を選択し、オプションを選択します。
  3. Braze へのアクセスが必要なユーザーにアプリを割り当てます。
  4. 割り当てが完了したら Done を選択します。

SSO 用にカスタムアプリを設定した場合は、Okta - Custom app integration オプションを使用します。Okta で SAML SSO 用に Braze アプリを設定した場合は、Okta - Braze app タブの手順に従ってください。

ステップ 1:SCIM プロビジョニングを設定する

ステップ 1.1:SCIM を有効にする

  1. Okta で Braze アプリに移動します。
  2. General タブを選択します。
  3. App Settings セクションで Edit を選択します。
  4. Provisioning フィールドで SCIM を選択します。
  5. Save を選択します。

ステップ 1.2:SCIM 統合を設定する

  1. Provisioning タブを選択します。
  2. Settings > Integration > SCIM Connection で Edit を選択し、SCIM プロビジョニングの設定ページの表に表示されるフィールド値を入力します。
  3. Test API Credentials を選択して、API 認証情報をテストします。
  4. Save を選択します。

ステップ 1.3:アプリへのプロビジョニングを有効にする

  1. Provisioning > Settings > To App > Provisioning to App で Edit を選択します。
  2. 以下を有効にします。
    • Create Users
    • Update Users Attributes
    • Deactivate Users
  3. SCIM プロビジョニングの設定ページの表に表示されるマッピングを使用して、Attribute Mapping セクションを確認し、設定します。

ステップ 2:アプリにユーザーを割り当てる

  1. Assignment タブを選択します。
  2. Assign を選択し、オプションを選択します。
  3. Braze へのアクセスが必要なユーザーにアプリを割り当てます。
  4. Done を選択します。

ステップ 1:SCIM プロビジョニングアプリを設定する

ステップ 1.1:Microsoft Entra 管理センターにログインする

Microsoft Entra 管理センターにログインします。

ステップ 1.2:SCIM アプリを作成して設定する

  1. ナビゲーションメニューで Entra ID > Enterprise apps に移動します。
  2. New application を選択します。
  3. Create your own application を選択します。
  4. パネルでアプリの名前を入力します。
  5. What are you looking to do with your application? セクションで、Integrate application you don’t find in the gallery (Non-gallery) を選択します。
  6. Create を選択します。

ステップ 1.3:SCIM 統合を設定する

  1. SCIM アプリケーションの Manage > Provisioning セクションに移動します。
  2. Connect your application または New configuration を選択し、SCIM プロビジョニングの設定ページの表に表示されるフィールド値を入力します。

ステップ 1.4:アプリへのプロビジョニングを有効にする

  1. SCIM アプリケーションの Manage > Attribute mapping (Preview) セクションに移動します。
  2. Provision Microsoft Entra ID Users を選択します。
  3. SCIM プロビジョニングの設定ページの表に表示される属性と一致するように、Attribute Mapping セクションを確認し、設定します。
  4. Attribute Mapping ページを閉じます。

ステップ 2:アプリにユーザーを割り当てる

  1. Manage > Users and Groups に移動します。
  2. Add user/group を選択します。
  3. None Selected を選択して、アプリにユーザーを割り当てます。
  4. Select ボタンを選択して、割り当てを確定します。

ステップ 1:SCIM 設定を構成する

  • デフォルトワークスペース: 新しいユーザーをデフォルトで追加するワークスペースを選択します。SCIM API リクエストでワークスペースを指定しない場合、Braze はユーザーをこのワークスペースに割り当てます。リクエストに permissions が含まれていない場合、Braze はこのワークスペースでユーザーにデフォルトの権限セットを付与します。
  • サービスオリジン: SCIM リクエストのオリジンドメインを入力します。Braze はこれを X-Request-Origin ヘッダーで使用して、リクエストの送信元を検証します。
  • IP 許可リスト (オプション): SCIM リクエストを特定の IP アドレスに制限できます。許可する IP アドレスのカンマ区切りリストまたは範囲を入力します。各リクエストの X-Request-Origin ヘッダーを使用して、リクエストの IP アドレスが許可リストに含まれているかを確認します。

ステップ 2:SCIM トークンを生成する

必須フィールドを入力したら、SCIM トークンを生成を押して SCIM トークンを生成し、SCIM API エンドポイントを確認します。ページから移動する前に、必ず SCIM トークンをコピーしてください。このトークンは一度しか表示されません。

マスクされた値とコピーボタンが表示された SCIM API エンドポイントと SCIM トークンのフィールド。トークンフィールドの下に「Reset Token」ボタンがあります。

Braze は、すべての SCIM リクエストに、HTTP Authorization ヘッダーを介して SCIM API ベアラートークンが付与されていることを想定しています。

新規ユーザーのデフォルト権限

Okta または Entra ID の統合を通じて SCIM が権限リストなしでユーザーを作成すると、Braze はそのユーザーにデフォルトのワークスペースにおける閲覧専用のデフォルト権限セットを付与します。これは、permissions を省略したカスタムの SCIM API リクエストにも適用されます。

デフォルトの権限セットには、作成、編集、アーカイブ、削除、エクスポート、送信の権限は含まれていません。ユーザーにより多くのアクセス権を付与するには、SCIM グループロールマッピングを使用するか、Braze でユーザーを編集してください。

製品領域 権限
メッセージング キャンペーンを表示、キャンバスを表示、キャンバステンプレートを表示、フィーチャーフラグを表示、プレースメントを表示、メッセージ優先順位設定を表示、フリークエンシーキャップルールを表示、メッセージングレート制限を表示、グローバルコントロールグループを表示、サイレント時間設定を表示、ダッシュボードレポートを表示
コンテンツ Content Blocksを表示、メールテンプレートを表示、メールリンクテンプレートを表示、アプリ内メッセージテンプレートを表示、Webhookテンプレートを表示、メディアライブラリアセットを表示、ユーザー設定センターを表示、プロモーションコードを表示、ロケーションを表示、ローカライゼーション設定を表示
オーディエンスとデータ セグメントを表示、カスタム属性を表示、カスタムイベントを表示、カタログを表示、ユーザーマージレコードを表示、オーディエンス同期設定を表示
チャネル設定 メール設定を表示、プッシュ設定を表示、WhatsApp設定を表示、WhatsAppカタログを表示、WhatsAppフローを表示、MetaからのWhatsAppメッセージテンプレートを表示
Decisioning Studio Decisioning Studioエージェントを表示、Decisioning Studioオーディエンスを表示、Decisioning Studioアクションバンクを表示、コンバージョンイベントを表示、Decisioning Studioガードレールを表示、Decisioning Studioタイミングを表示
New Stuff!