Salesforce の構成

このページでは、Salesforce 管理者が Salesforce コネクタが呼び出す MCP サーバーを有効にし、Salesforce で OAuth 2.0 認証を構成する方法について説明します。どちらも、Salesforce を Gemini Enterprise に接続するための前提条件です。

認証方法を選択する

OAuth 2.0 フローは、共有の Salesforce ログインホストではなく、組織の [私のドメイン] エンドポイントに対して実行されるため、ユーザーがコネクタを承認する前に、Salesforce 組織が OAuth クライアント アプリを信頼する必要があります。認証は次の 2 つの方法のいずれかで構成できます。

  • Google管理の OAuth(OAuth 2.0(Google 管理)、デフォルト):Google は、Salesforce AppExchange で Gemini Enterprise - Salesforce コネクタのマネージド パッケージを公開します。Salesforce 組織にパッケージをインストールする場合、独自の Salesforce アプリを作成したり、Gemini Enterprise にクライアント ID やクライアント シークレットを入力したりする必要はありません。 Google管理パッケージをインストールするをご覧ください。
  • 独自のアプリを使用する(OAuth 2.0(独自のアプリを使用する)): 組織で AppExchange パッケージをインストールできない場合や、独自の OAuth アプリケーションとセキュリティ ポリシーを直接管理する場合は、Salesforce で独自の外部クライアント アプリを作成し、そのクライアント ID(コンシューマー キー)とクライアント シークレット(コンシューマー シークレット)を Gemini Enterprise に入力します。独自の OAuth アプリを作成するをご覧ください。

始める前に

Salesforce を構成する前に、次のことを確認してください。

  • 管理者として Salesforce にログインしている。

    • Google管理パッケージをインストールするには、ユーザー プロファイルに AppExchange パッケージのダウンロード権限(システム管理者プロファイルに含まれています)が含まれている必要があります。
    • 独自のアプリを使用するには、ユーザー プロファイルに、Salesforce の [設定] で外部クライアント アプリを作成して管理する権限が必要です。
  • 接続する組織を把握している。データストアの作成時に [インスタンス URI] として入力する [私のドメイン] の URL と同じ組織で設定を完了します。

  • 組織で [私のドメイン] が有効になっており、デプロイされている。コネクタは、https://example.my.salesforce.com などの [私のドメイン] ホストに対して認可を行います。

  • 組織でサポートされている Salesforce エディションを使用している。このコネクタは、Professional、Enterprise、Unlimited、Developer の各エディションをサポートしています。

  • SObject All MCP サーバーが組織で有効になっています。サーバーはデフォルトではアクティブではありません。組織で MCP サーバーを有効にするをご覧ください。

  • コネクタを承認して使用するすべての Salesforce ユーザーは、割り当てられたプロファイルまたは割り当てられた権限セットに API Enabled システム権限を持っています([Setup] で、[Users > Profiles] または [Users > Permission Sets] に移動し、[System Permissions > API Enabled] を選択します)。標準のシステム管理者プロファイルと標準ユーザー プロファイルには、デフォルトでこの権限が含まれていますが、カスタム プロファイルではオフになっていることがよくあります。

組織で MCP サーバーを有効にする

コネクタは、Salesforce でホストされている SObject All MCP サーバーを呼び出します。このサーバーは、コネクタのアクションの背後にある作成、読み取り、更新、削除のオペレーションを公開します。コネクタは SObject All MCP サーバー エンドポイントにのみ接続します。オペレーションごとの個別の MCP サーバーはサポートされていません。OAuth 2.0(Google 管理)と OAuth 2.0(独自のアプリを使用)の両方で、この機能を有効にする必要があります。

サーバーはデフォルトで非アクティブになっているため、管理者が組織で有効にする必要があります。

有効にする手順は次のとおりです。

  1. Salesforce で [設定] に移動します。

  2. [Integrations] > [API Catalog] > [MCP Servers] に移動します。

  3. [Salesforce Servers] タブで、[SObject All] を見つけます。これは、Salesforce レコードの作成、読み取り、更新、削除として説明されています。

  4. [Server Status] を [Active] に設定します。

SObject All MCP サーバーを有効にすると、個別の MCP サーバー ユーザー権限を必要とせずに、組織でサーバーが有効になります。また、ユーザーにレコードの作成、更新、削除の権限は付与されません。書き込みアクセス権と削除アクセス権は、次の 2 つのレイヤで制御されます。

  • Gemini Enterprise の場合: 読み取り専用アクションはデフォルトで有効になっており、レコードの作成、更新、削除を行うアクションはデフォルトでオフになっています。データストアを設定または管理する際、 Google Cloud 管理者は、作成、更新、削除のどのアクションを有効にするかを選択します。すべて無効にして、コネクタを読み取り専用にすることもできます。アクションを有効にするをご覧ください。
  • Salesforce: すべてのアクションは、承認ユーザー自身の Salesforce アカウントで API 呼び出しとして実行されます。ユーザーは、プロファイルまたは割り当てられた権限セットに API Enabled システム権限が必要です。コネクタは、そのユーザーのオブジェクト レベルの権限、フィールド レベルのセキュリティ、共有ルールを尊重します。

Google管理パッケージをインストールする

OAuth 2.0(Google 管理)を使用する場合は、Salesforce AppExchange から Gemini Enterprise 管理パッケージをインストールします。

  1. Salesforce 組織に管理者としてログインします。

  2. Salesforce AppExchange の Gemini Enterprise - Salesforce Connector のリスティングに移動します。

  3. [今すぐ入手する] をクリックします。

  4. インストール先の環境を選択します。

    • 本番環境の組織の場合は [Install in Production] を選択します。
    • サンドボックス組織の場合は [Install in Sandbox] を選択します。
  5. アプリへのアクセス権を付与するユーザーを選択します。

    • 管理者のみにインストール: システム管理者プロファイルを持つユーザーのみがアプリを使用できます。
    • 特定のプロファイルにインストールする: 選択したプロファイルを持つユーザーのみがアプリを使用できます。
    • すべてのユーザーにインストール(推奨): 組織内のすべてのユーザーが、追加のプロファイル構成なしでアプリを使用できます。

    管理パッケージには、必要な OAuth スコープ(mcp_api と refresh_token)がすでに含まれています。Gemini Enterprise でコネクタを承認するためにログインするすべてのユーザーは、選択したオプションでアプリにアクセスできる必要があります。また、Salesforce プロファイルまたは割り当てられた権限セットで API Enabled システム権限を持っている必要があります。プロファイルにアプリへのアクセス権がないユーザーは、ログイン手順を完了できません。API が有効になっていないユーザーは、クエリやアクションを実行できません。

  6. Salesforce からプロンプトが表示されたら、サードパーティのアクセスを承認し、[Install] または [Upgrade] をクリックします。

  7. インストールが完了するまでお待ちください。大規模な組織の場合、Salesforce はインストールを非同期で完了し、完了時にメールを送信します。

インストールが完了すると、アプリは Salesforce の [設定] に [Gemini Enterprise] として表示されます。次に、アプリのログイン IP ポリシーを設定します。

独自の OAuth アプリを作成する

OAuth 2.0(Bring Your Own App)を使用する場合は、Salesforce で外部クライアント アプリを作成して構成し、コンシューマ キー(クライアント ID)とコンシューマー シークレット(クライアント シークレット)を取得します。

  1. 管理者として Salesforce 組織にログインし、[設定] に移動します。

  2. [クイック検索] フィールドに「External Client App Manager」と入力し、[外部クライアント アプリ マネージャー] を選択します。

  3. [New External Client App] をクリックし、[Basic Information] に必要な情報([External Client App Name]、[API Name]、[Contact Email])を入力します。

  4. [API (Enable OAuth Settings)] セクションで、[Enable OAuth] を選択し、次の設定を構成します。

    1. [App Settings] の [Callback URL] に、次のように入力します。

      https://vertexaisearch.cloud.google.com/oauth-redirect
      
    2. [OAuth スコープ] に、次の両方のスコープを追加します。

      • Salesforce API Platform MCP サーバー(mcp_api)にアクセスする
      • リクエストを随時実行する(refresh_token、offline_access)

      これにより、コネクタに必要な mcp_api スコープと refresh_token スコープが付与されます。

    3. [セキュリティ] で、次のオプションが選択されていることを確認します。

      • サポートされている認証フローに Proof Key for Code Exchange(PKCE)拡張機能を要求する
      • Issue JSON Web Token (JWT)-based access tokens for named users
  5. [作成] をクリックします。

  6. アプリの OAuth ポリシーを構成します。

    1. [設定] で、[アプリ] > [外部クライアント アプリ マネージャー] に移動し、外部クライアント アプリをクリックして、[ポリシー] タブを選択し、[編集] をクリックします。

    2. [Permitted Users] で、[All users may self-authorize](推奨)を選択するか、[Admin approved users are pre-authorized] を選択して、コネクタを承認するすべてのユーザー(データストアの作成時に認証を確認する管理者を含む)にプロファイルまたは権限セットを割り当てます。コネクタを承認するすべてのユーザーのプロファイルまたは割り当てられた権限セットに、API 有効システム権限があることを確認します。

    3. [IP 制限の緩和] で [IP 制限を緩和する] を選択します。この設定が必要な理由については、アプリのログイン IP ポリシーを設定するをご覧ください。

    4. [保存] をクリックします。

  7. アプリの OAuth 認証情報をコピーします。

    1. 設定タブを選択し、OAuth 設定を展開して、コンシューマ キーと Secretをクリックします。
    2. コンシューマ キーとコンシューマ シークレットをコピーして保存します。これらの値は、Gemini Enterprise でデータストアを作成するときに、[クライアント ID] と [クライアント シークレット] として入力します。

アプリのログイン IP ポリシーを設定する

Salesforce コネクタでは、データストアごとの静的 IP アドレスはサポートされていません。代わりに、Salesforce の外部クライアント アプリがログイン IP の検証を管理します。

  • 認証呼び出し(OAuth トークンの交換と更新): ユーザーがコネクタを承認すると、Gemini Enterprise は Googleのサーバーからそのユーザーの Salesforce トークンを交換して更新します。これらのリクエストは、組織の IP アドレスから送信されたものではありません。アプリで IP 制限が適用され、ユーザーのプロファイルにログイン IP 範囲がある場合、リクエストは拒否され、[Verify Auth] または [Authorize] のステップは失敗します。アプリの [IP 制限の緩和] ポリシーを [IP 制限を緩和する] に設定します。Googleが管理する Gemini Enterprise アプリの場合、 Google はすでにトークン リクエストを Google独自の下り(外向き)IP 範囲に制限しており、このチェックはポリシー設定に関係なく適用されます。
  • データ呼び出し: ログイン リクエストとトークン リクエストのみが IP 制限に照らしてチェックされます。ユーザーがコネクタを承認すると、Salesforce はユーザーの有効なアクセス トークンに基づいてコネクタのデータ リクエストを処理します。

Google管理対象アプリ(または独自の外部クライアント アプリ)のポリシーを設定するには:

  1. Salesforce で [設定] に移動します。

  2. [Apps] > [External Client App Manager] に移動し、[Gemini Enterprise](またはカスタム外部クライアント アプリの名前)をクリックします。

  3. [ポリシー] タブを選択し、[編集] をクリックします。

  4. [OAuth ポリシー] セクションで、[IP 制限の緩和] を [IP 制限を緩和する] に設定します。

  5. [保存] をクリックします。

サンドボックス組織を接続する

サンドボックスは、独自の My Domain ホストと、独自のインストール済みパッケージおよびアプリを持つ、個別の Salesforce 組織です。本番環境を構成しても、サンドボックスは構成されません。

サンドボックス組織を接続するには、サンドボックスで SObject All MCP サーバーを有効にしてから、AppExchange パッケージをサンドボックスにインストールするか([サンドボックスにインストール] を選択)、サンドボックスに外部クライアント アプリを作成します。サンドボックス接続に必要なデータストアの設定については、Salesforce データストアを設定するをご覧ください。

Salesforce の設定後の流れ

Salesforce でアプリを構成しても、それだけでは何も接続されません。これにより、OAuth アプリが組織で使用できるようになり、個々のユーザーがアプリを承認できるようになります。

Google Cloud 管理者が Gemini Enterprise で Salesforce データストアを作成し、アプリに接続すると(Salesforce データストアを設定するを参照)、各エンドユーザー(ウェブアプリを使用する管理者を含む)は、ユーザーごとのエンドユーザー認証を使用して、Gemini Enterprise が Salesforce にアクセスすることを承認します。ユーザーが Gemini Enterprise ウェブアプリで Salesforce データを初めてクエリすると、組織の Salesforce ログインページにリダイレクトされ、アプリに mcp_api スコープと refresh_token スコープを付与します。詳細については、コネクタを承認するをご覧ください。

各ユーザーが個別に承認するため、Gemini Enterprise はそのユーザー自身の権限で Salesforce レコードにアクセスします。ユーザーは、Salesforce で表示および変更できるレコードのみを表示および変更できます。

トラブルシューティング

症状 考えられる原因
[Verify Auth] または [Authorize] のステップが失敗するか、Salesforce のログインページで、不明、無効、または未承認のクライアント アプリケーションが報告されます。 OAuth 2.0(Google 管理)を使用する場合は、インスタンス URI が指す組織(サンドボックスを含む)に管理パッケージがインストールされていることを確認します。OAuth 2.0(独自のアプリを使用)を使用する場合は、クライアント ID とクライアント シークレットがその組織のアプリと一致していること、コールバック URL が https://vertexaisearch.cloud.google.com/oauth-redirect に設定されていること、mcp_api スコープと refresh_token スコープが選択されていること、[Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows] が有効になっていることを確認します。
一部のユーザーは承認できるが、他のユーザーは承認できない。 アプリの許可されたユーザーポリシーにより、これらのユーザーを含まない特定のプロファイルまたは権限セットへのアクセスが制限されているか、IP 制限の緩和が [IP 制限を緩和する] に設定されていません。[Setup] で、アプリの [Policies] タブを開き、[Edit] をクリックして、影響を受けるプロファイルまたは権限セットを追加します(または、[Permitted Users] を [All users may self-authorize] に設定します)。[IP Relaxation] が [Relax IP restrictions] に設定されていることを確認します。
認可は成功するが、Gemini Enterprise ウェブアプリでクエリまたはアクションが失敗する。 Salesforce で次の設定を確認します。
  • 承認ユーザーのプロファイルまたは割り当てられた権限セットの [システム権限] で、[API 有効] システム権限が選択されている。
  • SObject All MCP サーバーが組織で有効になっている。Salesforce 設定で SObject All MCP サーバーを有効にするには、組織で MCP サーバーを有効にするをご覧ください。
  • OAuth 2.0(独自のアプリを使用)を使用する場合は、外部クライアント アプリで [Issue JSON Web Token (JWT)-based アクセス トークン for named users] が選択されている。
承認は成功したが、Salesforce データが返されない。 承認ユーザーが Salesforce でレコードレベルのアクセス権を持っていない可能性があります。コネクタは、ユーザー自身の Salesforce 権限を尊重します。

次のステップ