コンテンツにスキップ

OAuth設定の管理

OAuth設定では、OAuthパートナーアプリとBraze MCPサーバーへの会社全体のアクセスを管理します。ワークスペースごとにパートナーアプリを承認またはブロックしたり、Brazeに接続できるMCPクライアントとリダイレクトURIを制御したり、会社のすべてのMCP OAuthトークンを取り消したりできます。

OAuth設定は会社全体に適用されます。各ユーザーに割り当てられた権限によって、パートナーアプリやMCPサーバーを通じてアクセスできるワークスペースと機能が決まります。

要件

要件 説明
「管理者」権限 OAuth 設定の表示、OAuth パートナーアプリの管理、MCP OAuth アクセスのオン/オフの切り替え、MCP クライアントの承認または削除、リダイレクト URI の管理、MCP OAuth トークンの取り消しを行うには、会社レベルの「管理者」権限が必要です。
「MCP サーバーを使用」権限 ユーザーは、MCP サーバー経由でアクセスする各ワークスペースについてこの権限を持っている必要があります。この権限は、OAuth 設定の管理に使用する「管理者」権限とは別のものです。

権限の割り当てについて詳しくは、ユーザー権限を参照してください。

OAuth アクセスの仕組み

OAuth 設定とユーザー権限は連携して機能します。

  • 会社全体の OAuth 設定によって、ユーザーがパートナーアプリや MCP クライアントを Braze に接続できるかどうかが決まります。
  • OAuth パートナーアプリのポリシーによって、各ワークスペースで承認またはブロックされるパートナーアプリが決まります。
  • 「MCP サーバーを使用」権限によって、個々のユーザーがワークスペースで MCP サーバーを使用できるかどうかが決まります。
  • ユーザーの既存のダッシュボード権限によって、MCP クライアントまたはパートナーアプリがアクセスできる Braze のデータと機能が決まります。
  • 1 つの OAuth 接続でアクセスできるのは、ユーザーがアクセスを許可されているワークスペースのみです。

MCP OAuth アクセスまたはパートナーアプリの OAuth アクセスをオンにしても、ユーザーに新しいワークスペース権限が付与されることはありません。同様に、ダッシュボード権限を削除すると、ユーザーが接続しているクライアントまたはパートナーアプリからもその機能が削除されます。

会社とワークスペースのコントロール

OAuthポリシーは会社レベルで保存されます。ワークスペース管理者は、個々のワークスペースに対してパートナーアプリのOAuthアクセス、MCP OAuthアクセス、またはリダイレクトURIのステータスを上書きできません。ただし、パートナーアプリの承認では、アクセスを選択したワークスペースに制限できます。

コントロール 設定場所 範囲
パートナーアプリのOAuthアクセスとOAuthパートナーアプリ 設定 > 管理者設定 > 外部連携 会社全体の有効化はOAuth設定タブで行います。パートナーアプリごとの承認済みまたはブロック済みのステータスと、対象ワークスペースの選択はOAuthパートナーアプリタブで行います。
MCP OAuthアクセス 外部連携 > OAuth設定 会社全体。オフにすると、すべてのワークスペースでMCP OAuthが拒否されます。
MCPクライアントページ 外部連携 > MCPクライアント 会社全体。検証済みクライアントを承認すると、「MCPサーバーを使用」権限を持つユーザーは、すべてのワークスペースでそのクライアントを接続できます。
承認済みリダイレクトURI 外部連携 > MCPクライアント 会社全体。カスタム (およびローカル) リダイレクトURIはすべてのワークスペースに適用されます。
MCP OAuthトークンを取り消す 外部連携 > OAuth設定 会社全体。取り消しは、すべてのワークスペースのすべてのMCP OAuthトークンに適用されます。
「MCPサーバーを使用」権限 設定 > ユーザー管理 ワークスペースごと。ユーザーは、MCPサーバー経由でアクセスする各ワークスペースでこの権限が必要です。

パートナーアプリのポリシーの変更、MCP OAuthアクセスの変更、MCPクライアントの承認または削除、リダイレクトURIのステータスの変更、MCP OAuthトークンの取り消しを行えるのは、「管理者」権限を持つユーザーのみです。ワークスペースの権限とこれらの会社設定の関係については、OAuthとMCPアクセスを参照してください。

OAuthパートナーアプリ

OAuthパートナーアプリタブでは、会社のユーザーがOAuthで接続できるパートナーアプリを監視および管理できます。

  1. 設定 > 管理者設定 > 外部接続に移動します。
  2. OAuthパートナーアプリタブを開きます。

パートナーアプリを表示する

パートナーアプリリストには、会社が承認またはブロックしたすべてのOAuthパートナーアプリが表示されます。各アプリについて、次の項目を確認できます。

列 説明
アプリ名 パートナーアプリの名前。
最終更新者 パートナーアプリのポリシーを最後に変更したダッシュボードユーザー。
最終更新日時 パートナーアプリのポリシーが最後に変更された日時。
承認済みワークスペース 会社のユーザーがアプリを接続できるワークスペース。
ステータス アプリが承認済みかブロック済みか。

パートナーアプリを参照して承認する

会社でパートナーアプリを承認するには、次の手順を実行します。

  1. OAuthパートナーアプリタブで、アプリを参照を選択します。
  2. 確認するパートナーアプリを選択します。
  3. アプリを承認を選択し、すべてのワークスペースまたは選択したワークスペースを選びます。
  4. 承認を選択します。

デフォルトでは、すべてのワークスペースが承認されます。会社のユーザーは、承認したワークスペースにのみアプリを接続できます。後からワークスペースを編集を選択して、ワークスペースへのアクセスを変更できます。

アプリの詳細を確認する

パートナーアプリを開くと、アプリの説明や権限スコープを含むアプリの詳細を表示できます。各ユーザーは、自身のBraze権限で許可されているアクションのみを実行できます。

パートナーアプリをブロックする

選択したワークスペースでユーザーがパートナーアプリを接続できないようにするには、次の手順を実行します。

  1. パートナーアプリリストまたはアプリを参照からパートナーアプリを開きます。
  2. アプリをブロックを選択し、ブロックするワークスペースを選びます。
  3. アクションを確定します。

これらのワークスペースのユーザーは直ちに接続が解除され、そのアプリでのサインインや同期ができなくなります。アプリはいつでも再度承認できます。

パートナーアプリのOAuthアクセスをオンまたはオフにする

パートナーアプリのOAuthアクセスは、OAuth設定タブにある会社全体の切り替え設定です。

  1. 設定 > 管理者設定 > 外部接続に移動します。
  2. OAuth設定タブを開きます。
  3. グローバルアクセスコントロールで、パートナーアプリのOAuthアクセスをオンまたはオフにします。

パートナーアプリのOAuthアクセスがオンの場合、管理者はOAuthパートナーアプリタブでパートナーアプリを管理でき、会社のユーザーは承認済みのワークスペースで承認済みのパートナーアプリを接続できます。オフの場合、Brazeはすべてのユーザーのパートナーアプリ OAuthアクセスを直ちに切断し、アクティブなセッションを終了します。これらの連携を通じてすでに同期されたデータは、Brazeに保持されます。パートナーアプリのOAuthアクセスを再度オンにすると、既存の接続は再び機能します。

Braze Bonfire Community

Braze Bonfire Community は、設定 > 管理者設定 > 外部接続 > OAuthパートナーアプリにアプリとして表示されます。デフォルトでは承認済みになっています。

ユーザーはダッシュボードでコミュニティを開き、Braze Bonfire Communityにサインインを選択すると、Brazeアカウントでサインインできます。

Brazeダッシュボードと Bonfireアカウントのメールアドレスが異なる場合

既存のBonfireアカウントとは異なるメールアドレスでサインインすると、新しいBonfireアカウントが作成されます。以前の投稿を統合するには、両方のメールアドレスから [email protected] にメールを送信し、所有者であることを確認してください。

MCP OAuthアクセスをオンまたはオフにする

会社のMCP OAuthアクセスを更新するには、次の手順に従います。

  1. 設定 > 管理者設定 > 外部接続に移動します。
  2. グローバルアクセスコントロールで、MCP OAuthアクセスをオンまたはオフにします。

MCP OAuthアクセスがオンの場合、「Use MCP Server」権限を持つユーザーは、承認済みのMCPクライアントを認可できます。オフの場合、会社内のすべてのユーザーとワークスペースでMCPサーバーへのOAuthアクセスが拒否され、MCPクライアントタブは使用できなくなります。

MCP OAuthアクセスをオフにしても、設定済みのリダイレクトURIは削除もブロックもされません。Brazeは会社の既存のMCP OAuthトークンを取り消すため、接続済みのMCPクライアントはアクセスできなくなります。

MCPクライアントの管理

MCPクライアントタブでは、ユーザーが接続できるBraze検証済みMCPクライアントを管理します。Brazeの検証済みリストにないクライアントについては、このタブでカスタムリダイレクトURIを管理します。

検証済みMCPクライアント

Brazeは検証済みMCPクライアントをあらかじめ登録しているため、リダイレクトURIを貼り付けなくても名前でクライアントを承認できます。承認したクライアントは、検証済みMCPクライアントの下に承認済みステータスで表示されます。

  • ChatGPT
  • Claude
  • Claude Code
  • Cursor
  • OpenAI Codex
  • Visual Studio Code

検証済みクライアントの閲覧と承認

  1. 設定 > 管理者設定 > 外部接続に移動します。
  2. OAuth設定でMCP OAuthアクセスがオンになっていることを確認します。
  3. MCPクライアントタブを開きます。
  4. MCPクライアントを追加 > 検証済みMCPクライアントを閲覧を選択します。まだクライアントを承認していない場合は、MCPクライアントを閲覧を選択します。
  5. リストを検索またはフィルタリングし、許可するクライアントを開きます。
  6. クライアントの詳細と対応する利用環境(Web、デスクトップ、ターミナルなど)を確認し、設定を完了を選択します。

一部のクライアントは、各ユーザーのコンピューター上のローカルアドレス(http://localhost/... やカスタムスキームなど)経由でのみ接続します。ローカルアドレスは1つのアプリに固有のものではないため、承認後は同じアドレスを使用する他のアプリもBrazeにアクセスできるようになります。ローカルアドレスを必要とするクライアントを承認する際、Brazeからそれらのアドレスも同時に承認するよう求められる場合があります。クライアントの削除やURIステータスの変更は後から行えます。

MCPクライアントのステータス

ステータス 意味
未承認 会社がまだこのクライアントを承認していません。クライアントは承認済みリストに含まれておらず、ユーザーは接続できません。
承認済み 「Use MCP Server」権限を持つユーザーは、このクライアントを接続できます。クライアントのリダイレクトURIはいずれもブロックされていません。
部分的なアクセス クライアントは承認されていますが、リダイレクトURIテーブルでそのリダイレクトURIの1つ以上がブロック済みになっています。ユーザーは、クライアントの残りの承認済みアドレス経由で引き続き接続できます。
アクセスなし クライアントは承認されていますが、そのリダイレクトURIがすべてブロック済みになっています。少なくとも1つのアドレスのブロックを解除するまで、ユーザーはクライアントを接続できません。

検証済みクライアントの削除

検証済みクライアントを承認済みリストから外すには、MCPクライアントタブからクライアントを開き、MCPクライアントを削除を選択します。検証済みMCPクライアントを閲覧から再度承認するまで、ユーザーはそのクライアントを接続できません。

クライアントを削除しても、すでに接続しているユーザーのセッションは終了しません。それらのセッションを終了するには、MCP OAuthトークンを取り消すを選択します。

カスタムリダイレクト URI の管理

MCP OAuth access をオンにすると、MCP Clients タブの Approved redirect URIs セクションに、ローカル MCP クライアント、または Braze が検証していないリモートクライアント用のカスタムリダイレクト URI が一覧表示されます。クライアントが検証済み MCP クライアントにない場合は、このリストを使用してください。形式については、リダイレクト URI の形式を参照してください。

検証済み MCP クライアントを参照せずに URI を追加するには、Add MCP client > Add custom redirect URIs を選択することもできます。

Approved redirect URIs テーブルには、次の情報が表示されます。

列 説明
リダイレクト URI Braze がクライアントのコールバックと照合する正確なアドレス (パスを含む)。
追加者 URI を追加した、または最後に更新したダッシュボードユーザー。
追加日 URI が追加された、または最後に更新された日時。
ステータス URI が 承認済み と Blocked のどちらであるか。
アクション 現在のステータスに応じた Block、Unblock、または Delete redirect URI。

リダイレクト URI の形式

URI の種類 追加時に使用する形式
ローカル (ループバックアドレス) http://localhost または http://127.0.0.1 で始まります。任意のローカルポートと一致するように、ポート (ホストの後のコロンと数字) を省略します。たとえば、クライアントに http://localhost:33491/oauth/callback と表示されている場合は、http://localhost/oauth/callback と入力します。追加する URI にポート (:33491 など) を残した場合、Braze はそのポートのみと照合します。
リモートアドレス クライアントに表示されているとおりに完全なアドレスを入力します。例: https://app.example.com/callback。
カスタムスキーム cursor:// など、カスタム URI スキーム (http:// や https:// 以外) で始まります。表示されているとおりに正確に入力します。一部のデスクトップアプリはこのようなアドレスを使用します。

カスタムリダイレクト URI の追加

Braze が検証済みの MCP クライアントではない MCP クライアントを許可するには、次の手順に従います。

  1. MCP Clients タブを開き、Add MCP client > Add custom redirect URIs を選択するか、Approved redirect URIs セクションで Add redirect URI を選択します。
  2. クライアントの OAuth または統合設定から、コールバックプロトコルを含む完全なリダイレクト URI を入力します。クライアントのコールバックとの照合でサポートが必要な場合は、リダイレクト URI の形式の表を使用してください。
  3. Save を選択します。

ローカルクライアントの場合は、追加するリダイレクト URI で 127.0.0.1 を使用し、ポート番号を省略します。

カスタムクライアントの新しい OAuth 認可を完了できるのは、ステータスが 承認済み のリダイレクト URI のみです。クライアントのリダイレクト URI がリストにない場合、またはステータスが Blocked の場合、Braze は認可リクエストを拒否します。Braze が検証済みのクライアントについては、URI を手動で追加する代わりに、MCP Clients ページでクライアントを承認することをおすすめします。

リダイレクト URI のブロック

リダイレクト URI からの新しい OAuth 認可を防ぐには、その行の Block を選択してアクションを確定します。Braze は URI のレコードを保持し、ステータスを Blocked に変更します。

リダイレクト URI をブロックしても、その MCP クライアントにすでに接続しているユーザーのトークンは取り消されません。これらのセッションを終了するには、Revoke MCP OAuth tokens を選択します。URI のブロックは、そのコールバックによる新しい認可を防ぐための別のアクションです。

または、ユーザーから「Use MCP Server」権限を削除すると、そのユーザーのみが MCP サーバーを使用できなくなります。他のユーザーの MCP 接続は、Revoke MCP OAuth tokens を選択するまで有効なままです。

リダイレクト URI のブロック解除

ブロックされたリダイレクト URI のアクセスを復元するには、その行の Unblock を選択してアクションを確定します。Braze は重複したレコードを作成せず、既存のレコードを 承認済み に更新します。

以前にその MCP クライアントに接続していたユーザーは、再度認証する必要があります。

リダイレクト URI の削除

Approved redirect URIs リストからリダイレクト URI を削除するには、その行の Delete redirect URI を選択してアクションを確定します。

  • URI が 承認済み だった場合、そのアドレスを使用する承認済みのマーケットプレイスクライアントは、引き続きそのアドレス経由で接続できます。カスタムリストのエントリのみに依存していた他のアプリは、そのアドレスを使用できなくなります。承認済みクライアントによるアドレスの使用も停止するには、削除する代わりに URI をブロックしてください。
  • URI が Blocked だった場合、削除するとブロックが解除されます。そのアドレスを使用する承認済みクライアントや他のアプリは、再びそのアドレス経由で接続できるようになります。アドレスのブロックを維持するには、リストに残しておいてください。

リダイレクト URI を削除しても、すでに接続しているユーザーのトークンは取り消されません。これらのセッションを終了するには、Revoke MCP OAuth tokens を選択します。

MCP OAuthトークンを取り消す

トークンを取り消すと、会社全体のすべてのMCP OAuthトークンが一括で無効になります。トークンが漏洩した、または不正に使用された可能性がある場合に使用してください。

会社のMCP OAuthトークンを取り消すには、次の手順に従います。

  1. 設定 > 管理設定 > 外部接続に移動します。
  2. MCP OAuthトークンを取り消すで、MCP OAuthトークンを取り消すを選択します。
  3. 確認ダイアログの内容を確認し、トークンを取り消すを選択します。

Brazeはバックグラウンドでトークンを取り消し、取り消しが完了すると確認メッセージを表示します。接続数が多い会社では、数分かかることがあります。確認メッセージが表示されるまで、外部接続ページを開いたままにしてください。

取り消しによる変更点

項目 結果
アクセストークン 取り消されます。ユーザーが再接続するまで、接続されているMCPクライアントは動作しなくなります。
リフレッシュトークン 取り消されます。MCPクライアントはバックグラウンドで自動的に再接続できません。ユーザー自身が再接続する必要があります。
MCP OAuthアクセス 変更されません。オンになっていた場合、ユーザーはすぐに再接続できます。
承認済みのリダイレクトURI 変更されません。承認済みおよびブロック済みのURIはそのまま維持されます。
「Use MCP Server」権限 変更されません。ユーザーは権限を保持し、再接続できます。
新しい接続 影響を受けません。取り消しの開始後に作成された接続は引き続き動作します。

取り消し時にすでに処理中だったリクエストは取り消されません。現在のセッションを終了するだけでなく、すべてのMCPアクセスを停止するには、MCP OAuthアクセスをオフにしてください(これによりMCP OAuthトークンも取り消されます)。特定のユーザーのMCPアクセスを削除するには、そのユーザーから「Use MCP Server」権限を削除します。

取り消しが完了しない場合、Brazeはエラーメッセージを表示します。一部のトークンはすでに取り消されている可能性があるため、再試行する前にサポートにお問い合わせください。

ブロックされた接続のトラブルシューティング

ユーザーがMCPクライアントをBrazeに接続する際に「このアプリには承認が必要です」や「予期しないエラーが発生しました」などの一般的なエラーが表示される場合は、会社がそのクライアントまたはそのリダイレクトURIを承認していない可能性があります。

  1. 設定 > 管理者設定 > 外部接続 > MCPクライアントに移動します。
  2. クライアントがBraze検証済みの場合は、検証済みMCPクライアントまたは検証済みMCPクライアントを閲覧から開きます。承認済みリストにない場合は、必要なローカルアドレスも含めて承認します。
  3. クライアントが検証されていない場合は、承認済みリダイレクトURIテーブルでそのリダイレクトURIを探します。リストにない場合はURIを追加し、ステータスがブロック済みの場合はブロック解除を選択します。
  4. ユーザーにMCPクライアントを再度接続するよう依頼します。

クライアントまたはリダイレクトURIが承認されているにもかかわらず接続が失敗する場合は、MCP OAuthアクセスがオンになっていること、およびユーザーに「MCPサーバーを使用」権限があることを確認してください。その他のトラブルシューティングについては、Braze MCPサーバーの設定を参照してください。

OAuth アクティビティを監査する

Braze は、MCP サーバーへの OAuth 接続をセキュリティイベントレポートに記録します。このレポートを使用して、ユーザーが OAuth 経由で接続した日時を監査できます。

特定のユーザーの MCP アクセスを取り消すには、そのユーザーから「Use MCP Server」権限を削除します。会社内のすべての MCP OAuth トークンを取り消すには、MCP OAuth トークンを取り消すを参照してください。設定とトラブルシューティングのガイダンスについては、Braze MCP サーバーの設定を参照してください。

New Stuff!