Cette page explique comment un administrateur Salesforce active le serveur MCP appelé par le connecteur Salesforce et configure l'authentification OAuth 2.0 dans Salesforce. Ces deux éléments sont des prérequis pour connecter Salesforce à Gemini Enterprise.
Choisir une méthode d'authentification
Étant donné que le flux OAuth 2.0 s'exécute sur les points de terminaison Mon domaine de votre organisation plutôt que sur un hôte de connexion Salesforce partagé, votre organisation Salesforce doit faire confiance à une application cliente OAuth avant qu'un utilisateur puisse autoriser le connecteur. Vous pouvez configurer l'authentification de deux manières :
- OAuth géré parGoogle (OAuth 2.0 (géré par Google), par défaut) :Google publie le package géré Gemini Enterprise – Connecteur Salesforce sur Salesforce AppExchange. Lorsque vous installez le package dans votre organisation Salesforce, vous ne créez pas votre propre application Salesforce et vous ne saisissez pas d'ID client ni de code secret du client dans Gemini Enterprise. Consultez Installer le package géré par Google.
- Utiliser votre propre application (OAuth 2.0 (Utiliser votre propre application)) : si votre organisation ne peut pas installer de packages AppExchange ou souhaite gérer directement sa propre application OAuth et ses propres règles de sécurité, vous pouvez créer votre propre application cliente externe dans Salesforce et saisir son ID client (clé client) et son code secret du client (clé secrète client) dans Gemini Enterprise. Consultez Créer votre propre application OAuth.
Avant de commencer
Avant de configurer Salesforce, assurez-vous de ce qui suit :
Vous êtes connecté à Salesforce en tant qu'administrateur :
- Pour installer le package géré par Google, votre profil utilisateur doit inclure l'autorisation Télécharger des packages AppExchange (incluse dans le profil Administrateur système).
- Pour utiliser votre propre application, votre profil utilisateur doit être autorisé à créer et à gérer des applications clientes externes dans la configuration de Salesforce.
Vous savez à quelle organisation vous vous connectez. Effectuez la configuration dans la même organisation que celle dont vous prévoyez de saisir l'URL "Mon domaine" en tant qu'URI d'instance lorsque vous créez le data store.
Votre organisation a activé et déployé Mon domaine. Le connecteur s'autorise auprès de votre hôte Mon domaine, par exemple
https://example.my.salesforce.com.Votre organisation utilise une édition Salesforce compatible. Le connecteur est compatible avec les éditions Professional, Enterprise, Unlimited et Developer.
Le serveur MCP SObject All est actif dans votre organisation. Le serveur n'est pas actif par défaut. Consultez Activer le serveur MCP dans votre organisation.
Tous les utilisateurs Salesforce qui autorisent et utilisent le connecteur disposent de l'autorisation système API activée sur leur profil attribué ou sur un ensemble d'autorisations attribué (dans Configuration, accédez à Utilisateurs > Profils ou Utilisateurs > Ensembles d'autorisations, puis sélectionnez Autorisations système > API activée). Les profils standards Administrateur système et Utilisateur standard incluent cette autorisation par défaut, mais elle est souvent désactivée pour les profils personnalisés.
Activer le serveur MCP dans votre organisation
Le connecteur appelle le serveur MCP SObject All hébergé par Salesforce, qui expose les opérations de création, de lecture, de mise à jour et de suppression derrière les actions du connecteur. Le connecteur ne se connecte qu'au point de terminaison du serveur MCP SObject All. Les serveurs MCP distincts par opération ne sont pas compatibles. L'activation est requise pour OAuth 2.0 (géré par Google) et OAuth 2.0 (Bring Your Own App).
Le serveur étant inactif par défaut, un administrateur doit l'activer dans votre organisation.
Pour l'activer, procédez comme suit :
Dans Salesforce, accédez à Setup (Configuration).
Accédez à Intégrations > Catalogue d'API > Serveurs MCP.
Dans l'onglet Serveurs Salesforce, recherchez SObject All, décrit comme suit : Crée, lit, met à jour et supprime des enregistrements Salesforce.
Définissez son état du serveur sur Actif.
L'activation du serveur MCP SObject All active le serveur pour votre organisation sans nécessiter d'autorisation de l'utilisateur distincte pour le serveur MCP. Elle n'accorde pas aux utilisateurs l'autorisation de créer, de mettre à jour ou de supprimer des enregistrements par eux-mêmes. L'accès en écriture et en suppression est contrôlé à deux niveaux :
- Dans Gemini Enterprise : les actions en lecture seule sont activées par défaut, et les actions qui créent, mettent à jour ou suppriment des enregistrements sont désactivées par défaut. Lors de la configuration ou de la gestion du data store, l'administrateur Google Cloud choisit les actions de création, de mise à jour ou de suppression à activer, ou les laisse toutes désactivées pour que le connecteur soit en lecture seule. Consultez Activer les actions.
- Dans Salesforce : chaque action s'exécute en tant qu'appel d'API sous le compte Salesforce de l'utilisateur qui l'autorise. L'utilisateur doit disposer de l'autorisation système API activée sur son profil ou d'un ensemble d'autorisations attribué. Le connecteur respecte les autorisations au niveau de l'objet, la sécurité au niveau du champ et les règles de partage de cet utilisateur.
Installer le package géré par Google
Si vous prévoyez d'utiliser OAuth 2.0 (géré par Google), installez le package géré Gemini Enterprise depuis Salesforce AppExchange :
Connectez-vous à votre organisation Salesforce en tant qu'administrateur.
Accédez à la fiche Gemini Enterprise – Connecteur Salesforce sur Salesforce AppExchange.
Cliquez sur Obtenir.
Choisissez l'environnement dans lequel effectuer l'installation :
- Installer en production pour votre organisation de production.
- Installer dans un bac à sable pour une organisation de bac à sable.
Choisissez les utilisateurs qui auront accès à l'application :
- Install for Admins Only (Installer pour les administrateurs uniquement) : seuls les utilisateurs disposant du profil d'administrateur système peuvent utiliser l'application.
- Installer pour des profils spécifiques : seuls les utilisateurs disposant des profils que vous sélectionnez peuvent utiliser l'application.
- Installer pour tous les utilisateurs (recommandé) : tous les utilisateurs de l'organisation peuvent utiliser l'application sans configuration de profil supplémentaire.
Le package géré inclut déjà les champs d'application OAuth requis (
mcp_apietrefresh_token). Chaque utilisateur qui se connecte pour autoriser le connecteur dans Gemini Enterprise doit avoir accès à l'application selon l'option que vous choisissez, et doit également disposer de l'autorisation système API activée sur son profil Salesforce ou d'un ensemble d'autorisations attribué. Un utilisateur dont le profil n'a pas accès à l'application ne peut pas se connecter, et un utilisateur pour lequel l'option API activée n'est pas activée ne peut pas exécuter de requêtes ni d'actions.Approuvez l'accès tiers si Salesforce vous y invite, puis cliquez sur Install (Installer) ou Upgrade (Mettre à niveau).
Attendez que l'installation se termine. Pour une grande organisation, Salesforce peut effectuer l'installation de manière asynchrone et vous envoyer un e-mail une fois l'opération terminée.
Après l'installation, l'application apparaît dans la configuration de Salesforce sous le nom Gemini Enterprise. Ensuite, définissez la règle d'adresse IP de connexion pour l'application.
Créer votre propre application OAuth
Si vous prévoyez d'utiliser OAuth 2.0 (Bring Your Own App), créez et configurez une application cliente externe dans Salesforce pour obtenir une clé client (ID client) et un code secret client (code secret du client) :
Connectez-vous à votre organisation Salesforce en tant qu'administrateur, puis accédez à Setup (Configuration).
Dans le champ Recherche rapide, saisissez
External Client App Manager, puis sélectionnez Gestionnaire d'applications clientes externes.Cliquez sur New External Client App (Nouvelle application cliente externe), puis sous Basic Information (Informations de base), saisissez les informations requises (External Client App Name (Nom de l'application cliente externe), API Name (Nom de l'API) et Contact Email (Adresse e-mail de contact)).
Dans la section API (Enable OAuth Settings) (API [Activer les paramètres OAuth]), sélectionnez Enable OAuth (Activer OAuth) et configurez les paramètres suivants :
Sous App Settings (Paramètres de l'application), pour Callback URL (URL de rappel), saisissez :
https://vertexaisearch.cloud.google.com/oauth-redirectPour Niveaux d'accès OAuth, ajoutez les deux niveaux d'accès suivants :
- Accéder aux serveurs MCP de la plate-forme d'API Salesforce (mcp_api)
- Perform requests at any time (refresh_token, offline_access) (Exécuter des requêtes à tout moment)
Ils accordent les champs d'application
mcp_apietrefresh_tokenrequis par le connecteur.Sous Sécurité, assurez-vous que les options suivantes sont sélectionnées :
- Exiger l'extension PKCE (clé de vérification pour l'échange de code) pour les flux d'autorisation compatibles
- Émettre des jetons d'accès basés sur des jetons Web JSON (JWT) pour des utilisateurs nommés
Cliquez sur Créer.
Configurez les règles OAuth de l'application :
Dans Setup (Configuration), accédez à Apps > External Client App Manager (Applications > Gestionnaire d'applications clientes externes), cliquez sur votre application cliente externe, sélectionnez l'onglet Policies (Règles), puis cliquez sur Edit (Modifier).
Pour Utilisateurs autorisés, sélectionnez Tous les utilisateurs peuvent s'autoriser eux-mêmes (recommandé) ou Les utilisateurs approuvés par l'administrateur sont pré-autorisés, puis attribuez les profils ou les ensembles d'autorisations à tous les utilisateurs qui autorisent le connecteur (y compris l'administrateur qui valide l'authentification lors de la création du data store). Assurez-vous que chaque utilisateur qui autorise le connecteur dispose également de l'autorisation système API activée sur son profil ou d'un ensemble d'autorisations attribué.
Pour Assouplissement des restrictions d'adresses IP, sélectionnez Assouplir les restrictions d'adresses IP. Pour savoir pourquoi ce paramètre est requis, consultez Définir la règle d'adresse IP de connexion pour l'application.
Cliquez sur Enregistrer.
Copiez les identifiants OAuth de l'application :
- Sélectionnez l'onglet Settings (Paramètres), développez OAuth Settings (Paramètres OAuth), puis cliquez sur Consumer Key and Secret (Clé client et code secret).
- Copiez et enregistrez la clé client et le secret client. Vous saisissez ces valeurs en tant qu'ID client et code secret du client lorsque vous créez le data store dans Gemini Enterprise.
Définir la règle d'adresse IP de connexion pour l'application
Les adresses IP statiques par datastore ne sont pas compatibles avec le connecteur Salesforce. À la place, l'application cliente externe dans Salesforce régit la validation de l'adresse IP de connexion :
- Appels d'authentification (échange et actualisation de jetons OAuth) : lorsqu'un utilisateur autorise le connecteur, Gemini Enterprise échange et actualise les jetons Salesforce de cet utilisateur à partir des serveurs de Google. Ces requêtes ne proviennent pas des adresses IP de votre organisation. Si l'application applique des restrictions d'adresse IP et que les profils de vos utilisateurs ont des plages d'adresses IP de connexion, les requêtes sont rejetées et l'étape Vérifier l'authentification ou Autoriser échoue. Définissez la règle IP Relaxation (Assouplissement des restrictions d'adresses IP) de l'application sur Relax IP restrictions (Assouplir les restrictions d'adresses IP). Pour l'application Gemini Enterprise gérée parGoogle, Google limite déjà les requêtes de jetons aux plages d'adresses IP de sortie de Google, et cette vérification s'applique quel que soit le paramètre de la règle.
- Appels de données : seules les demandes de connexion et de jeton sont vérifiées par rapport aux restrictions d'adresse IP. Une fois qu'un utilisateur a autorisé le connecteur, Salesforce traite les requêtes de données du connecteur en fonction du jeton d'accès valide de l'utilisateur.
Pour définir la règle de l'application gérée par Google(ou de votre propre application cliente externe) :
Dans Salesforce, accédez à Setup (Configuration).
Accédez à Apps > External Client App Manager (Applications > Gestionnaire d'applications clientes externes), puis cliquez sur Gemini Enterprise (ou sur le nom de votre application cliente externe personnalisée).
Sélectionnez l'onglet Règles, puis cliquez sur Modifier.
Dans la section Règles OAuth, définissez Assouplissement des restrictions d'adresses IP sur Assouplir les restrictions d'adresses IP.
Cliquez sur Enregistrer.
Connecter une organisation de bac à sable
Un bac à sable est une organisation Salesforce distincte, avec son propre hôte Mon domaine, ainsi que ses propres packages et applications installés. La configuration de la production ne configure pas votre bac à sable.
Pour connecter une organisation de bac à sable, activez le serveur MCP SObject All dans le bac à sable, puis installez le package AppExchange dans le bac à sable (en choisissant Installer dans le bac à sable) ou créez votre application cliente externe dans le bac à sable. Pour connaître les paramètres de data store requis pour une connexion à un bac à sable, consultez Configurer un datastore Salesforce.
Que se passe-t-il après la configuration de Salesforce ?
La configuration de l'application dans Salesforce ne connecte rien en soi. Elle met l'application OAuth à la disposition de votre organisation afin que les utilisateurs individuels puissent l'autoriser.
Une fois qu'un administrateur Google Cloud a créé le data store Salesforce dans Gemini Enterprise et l'a connecté à une application (voir Configurer un datastore Salesforce), chaque utilisateur final (y compris les administrateurs qui utilisent l'application Web) autorise Gemini Enterprise à accéder à Salesforce en son nom à l'aide de l'authentification de l'utilisateur final par utilisateur. Lorsqu'un utilisateur interroge des données Salesforce pour la première fois dans l'application Web Gemini Enterprise, il est redirigé vers la page de connexion Salesforce de votre organisation, où il accorde à l'application les champs d'application mcp_api et refresh_token. Pour en savoir plus, consultez Autoriser le connecteur.
Comme chaque utilisateur s'autorise individuellement, Gemini Enterprise accède aux enregistrements Salesforce avec les autorisations de cet utilisateur. Un utilisateur ne peut voir et modifier que les enregistrements qu'il peut déjà voir et modifier dans Salesforce.
Résoudre les problèmes
| Problème constaté | Cause probable |
|---|---|
| L'étape Vérifier l'authentification ou Autoriser échoue, ou la page de connexion Salesforce signale une application cliente inconnue, non valide ou non autorisée. | Si vous utilisez OAuth 2.0 (géré par Google), vérifiez que le package géré est installé dans l'organisation exacte (y compris un bac à sable) vers laquelle pointe l'URI de l'instance. Si vous utilisez OAuth 2.0 (Bring Your Own App), vérifiez que l'ID client et le code secret du client correspondent à l'application de cette organisation, que l'URL de rappel est définie sur https://vertexaisearch.cloud.google.com/oauth-redirect, que les champs d'application mcp_api et refresh_token sont sélectionnés, et que l'option Exiger l'extension clé de vérification pour l'échange de code (PKCE) pour les flux d'autorisation compatibles est activée. |
| Certains utilisateurs peuvent autoriser l'accès, d'autres non. | La règle Permitted Users (Utilisateurs autorisés) de l'application limite l'accès à des profils ou à des ensembles d'autorisations spécifiques qui n'incluent pas ces utilisateurs, ou l'option IP Relaxation (Assouplissement des restrictions d'adresses IP) n'est pas définie sur Relax IP restrictions (Assouplir les restrictions d'adresses IP). Dans Setup (Configuration), ouvrez l'onglet Policies (Règles) de l'application, cliquez sur Edit (Modifier), ajoutez les profils ou ensembles d'autorisations concernés (ou définissez Permitted Users (Utilisateurs autorisés) sur All users may self-authorize (Tous les utilisateurs peuvent s'autoriser eux-mêmes)), puis vérifiez que IP Relaxation (Assouplissement des restrictions d'adresses IP) est défini sur Relax IP restrictions (Assouplir les restrictions d'adresses IP). |
| L'autorisation réussit, mais les requêtes ou les actions échouent dans l'application Web Gemini Enterprise. | Vérifiez les paramètres suivants dans Salesforce :
|
| L'autorisation réussit, mais aucune donnée Salesforce n'est renvoyée. | L'utilisateur qui autorise l'accès n'a peut-être pas d'accès au niveau des enregistrements dans Salesforce. Le connecteur respecte les autorisations Salesforce de l'utilisateur. |
Étapes suivantes
- Pour créer le data store, consultez Configurer un datastore Salesforce.