Configuración de Salesforce

En esta página, se describe cómo un administrador de Salesforce habilita el servidor de MCP al que llama el conector de Salesforce y configura la autenticación de OAuth 2.0 en Salesforce. Ambos son requisitos previos para conectar Salesforce a Gemini Enterprise.

Elige un método de autenticación

Debido a que el flujo de OAuth 2.0 se ejecuta en los extremos de Mi dominio de tu organización, en lugar de un host de acceso compartido de Salesforce, tu organización de Salesforce debe confiar en una app cliente de OAuth antes de que cualquier usuario pueda autorizar el conector. Puedes configurar la autenticación de una de las siguientes dos maneras:

  • OAuth administrado porGoogle (OAuth 2.0 (administrado por Google), predeterminado): Google publica el paquete administrado Gemini Enterprise - Salesforce Connector en Salesforce AppExchange. Cuando instalas el paquete en tu organización de Salesforce, no creas tu propia app de Salesforce ni ingresas un ID de cliente o un secreto del cliente en Gemini Enterprise. Consulta Instala el paquete administrado por Google.
  • Trae tu propia app (OAuth 2.0 (Trae tu propia app)): Si tu organización no puede instalar paquetes de AppExchange o quiere administrar su propia aplicación de OAuth y sus políticas de seguridad directamente, puedes crear tu propia app cliente externa en Salesforce y, luego, ingresar su ID de cliente (clave de consumidor) y su secreto del cliente (secreto de consumidor) en Gemini Enterprise. Consulta Crea tu propia app de OAuth.

Antes de comenzar

Antes de configurar Salesforce, asegúrate de lo siguiente:

  • Accediste a Salesforce como administrador:

    • Para instalar el paquete administrado por Google, tu perfil de usuario debe incluir el permiso Descargar paquetes de AppExchange (incluido en el perfil de administrador del sistema).
    • Para usar tu propia app, tu perfil de usuario debe tener permiso para crear y administrar apps cliente externas en la configuración de Salesforce.
  • Sabes a qué organización te estás conectando. Completa la configuración en la misma organización cuya URL de Mi dominio planeas ingresar como el URI de instancia cuando crees el almacén de datos.

  • Tu organización tiene Mi dominio habilitado e implementado. El conector se autoriza con el host de Mi dominio, por ejemplo, https://example.my.salesforce.com.

  • Tu organización usa una edición de Salesforce compatible. El conector admite las ediciones Professional, Enterprise, Unlimited y Developer.

  • El servidor de MCP SObject All está activo en tu organización. El servidor no está activo de forma predeterminada. Consulta Habilita el servidor de MCP en tu organización.

  • Cada usuario de Salesforce que autoriza y usa el conector tiene el permiso del sistema API habilitada en su perfil asignado o en un conjunto de permisos asignado (en Configuración, ve a Usuarios > Perfiles o Usuarios > Conjuntos de permisos y, luego, selecciona Permisos del sistema > API habilitada). Los perfiles estándar de administrador del sistema y de usuario estándar incluyen este permiso de forma predeterminada, pero los perfiles personalizados suelen tenerlo desactivado.

Habilita el servidor de MCP en tu organización

El conector llama al servidor de MCP SObject All alojado en Salesforce, que expone las operaciones de creación, lectura, actualización y eliminación detrás de las acciones del conector. El conector solo se conecta al extremo del servidor de MCP SObject All. No se admiten servidores de MCP independientes por operación. Es necesario activarla para OAuth 2.0 (administrado por Google) y OAuth 2.0 (trae tu propia app).

Como el servidor está inactivo de forma predeterminada, un administrador debe activarlo en tu organización.

Para activarla, sigue estos pasos:

  1. En Salesforce, ve a Configuración.

  2. Ve a Integraciones > Catálogo de APIs > Servidores de MCP.

  3. En la pestaña Servidores de Salesforce, busca SObject All, que se describe como Crea, lee, actualiza y borra registros de Salesforce.

  4. Establece el Estado del servidor en Activo.

Cuando activas el servidor de MCP SObject All, se habilita el servidor para tu organización sin necesidad de un permiso de usuario del servidor de MCP independiente, y no les otorga a los usuarios permiso para crear, actualizar o borrar registros por su cuenta. El acceso de escritura y eliminación se controla en dos capas:

  • En Gemini Enterprise: Las acciones de solo lectura están habilitadas de forma predeterminada, y las acciones que crean, actualizan o borran registros están desactivadas de forma predeterminada. Cuando se configura o administra el almacén de datos, el administrador de Google Cloud elige qué acciones de creación, actualización o eliminación habilitar, o las deja todas inhabilitadas para que el conector sea de solo lectura. Consulta Habilita acciones.
  • En Salesforce: Cada acción se ejecuta como una llamada a la API en la cuenta de Salesforce del usuario que autoriza. El usuario debe tener el permiso del sistema API habilitada en su perfil o un conjunto de permisos asignado, y el conector respeta los permisos a nivel de objeto, la seguridad a nivel de campo y las reglas de uso compartido de ese usuario.

Instala el paquete administrado por Google

Si planeas usar OAuth 2.0 (administrado por Google), instala el paquete administrado de Gemini Enterprise desde Salesforce AppExchange:

  1. Accede a tu organización de Salesforce como administrador.

  2. Ve a la ficha de Gemini Enterprise - Salesforce Connector en Salesforce AppExchange.

  3. Haz clic en Obtener ahora.

  4. Elige el entorno en el que quieres instalar:

    • Instalar en producción para tu organización de producción
    • Instalar en la zona de pruebas para una organización de zona de pruebas
  5. Elige qué usuarios tendrán acceso a la app:

    • Install for Admins Only: Solo los usuarios con el perfil de administrador del sistema pueden usar la app.
    • Instalar para perfiles específicos: Solo los usuarios con los perfiles que selecciones pueden usar la app.
    • Instalar para todos los usuarios (recomendado): Todos los usuarios de la organización pueden usar la app sin necesidad de configurar perfiles adicionales.

    El paquete administrado ya incluye los permisos de OAuth necesarios (mcp_api y refresh_token). Todos los usuarios que accedan para autorizar el conector en Gemini Enterprise deben tener acceso a la app según la opción que elijas y también deben tener el permiso del sistema API habilitada en su perfil de Salesforce o un conjunto de permisos asignado. Un usuario cuyo perfil no tiene acceso a la app no puede completar el paso de acceso, y un usuario sin la API habilitada no puede ejecutar consultas ni acciones.

  6. Si Salesforce te lo solicita, aprueba el acceso de terceros y, luego, haz clic en Instalar o Actualizar.

  7. Espera a que finalice la instalación. En el caso de una organización grande, Salesforce puede completar la instalación de forma asíncrona y enviarte un correo electrónico cuando termine.

Después de la instalación, la app aparece en la configuración de Salesforce como Gemini Enterprise. A continuación, establece la política de IP de acceso para la app.

Crea tu propia app de OAuth

Si planeas usar OAuth 2.0 (Trae tu propia app), crea y configura una app cliente externa en Salesforce para obtener una clave de consumidor (ID de cliente) y un secreto de consumidor (Secreto del cliente):

  1. Accede a tu organización de Salesforce como administrador y ve a Configuración.

  2. En el campo Búsqueda rápida, ingresa External Client App Manager y selecciona Administrador de la aplicación cliente externa.

  3. Haz clic en Nueva aplicación cliente externa y, en Información básica, ingresa la información requerida (Nombre de la aplicación cliente externa, Nombre de la API y Correo electrónico de contacto).

  4. En la sección API (Enable OAuth Settings), selecciona Enable OAuth y establece los siguientes parámetros de configuración:

    1. En Configuración de la app, en URL de devolución de llamada, ingresa lo siguiente:

      https://vertexaisearch.cloud.google.com/oauth-redirect
      
    2. En Permisos de OAuth, agrega los siguientes dos permisos:

      • Accede a los servidores de MCP de la plataforma de la API de Salesforce (mcp_api)
      • Realizar solicitudes en cualquier momento (refresh_token, offline_access)

      Estos otorgan los permisos mcp_api y refresh_token que requiere el conector.

    3. En Seguridad, asegúrate de que estén seleccionadas las siguientes opciones:

      • Exige la extensión de clave de prueba para el intercambio de código (PKCE) para los flujos de autorización admitidos
      • Emite tokens de acceso basados en tokens web JSON (JWT) para usuarios con nombre
  5. Haz clic en Crear.

  6. Configura las políticas de OAuth de la app:

    1. En Configuración, ve a Apps > Administrador de la aplicación cliente externa, haz clic en tu aplicación cliente externa, selecciona la pestaña Políticas y haz clic en Editar.

    2. En Usuarios permitidos, selecciona Todos los usuarios pueden autorizarse a sí mismos (recomendado) o selecciona Los usuarios aprobados por el administrador tienen autorización previa y asigna los perfiles o conjuntos de permisos para todos los usuarios que autorizan el conector (incluido el administrador que verifica la autenticación durante la creación del almacén de datos). Asegúrate de que cada usuario que autorice el conector también tenga el permiso del sistema API habilitada en su perfil o un conjunto de permisos asignado.

    3. En Relajación de IP, selecciona Disminución de las restricciones de IP. Para obtener detalles sobre por qué se requiere este parámetro de configuración, consulta Establece la política de IP de acceso para la app.

    4. Haz clic en Guardar.

  7. Copia las credenciales de OAuth de la app:

    1. Selecciona la pestaña Configuración, expande Configuración de OAuth y haz clic en Clave y secreto del consumidor.
    2. Copia y guarda la clave de consumidor y el secreto de consumidor. Ingresa estos valores como el ID de cliente y el Secreto del cliente cuando crees el almacén de datos en Gemini Enterprise.

Establece la política de IP de acceso para la app

No se admiten las direcciones IP estáticas por almacén de datos para el conector de Salesforce. En cambio, la app cliente externa en Salesforce rige la validación de la IP de acceso:

  • Llamadas de autenticación (intercambio y actualización de tokens de OAuth): Cuando un usuario autoriza el conector, Gemini Enterprise intercambia y actualiza los tokens de Salesforce de ese usuario desde los servidores de Google. Esas solicitudes no provienen de las direcciones IP de tu organización. Si la app aplica restricciones de IP y los perfiles de tus usuarios tienen rangos de IP de acceso, las solicitudes se rechazan y el paso Verificar autenticación o Autorizar falla. Establece la política de Relajación de IP de la app en Disminución de las restricciones de IP. Para la app de Gemini Enterprise administrada porGoogle, Google ya restringe las solicitudes de tokens a los rangos de IP de salida de Google, y esa verificación se aplica independientemente de la configuración de la política.
  • Llamadas de datos: Solo se verifican las solicitudes de acceso y de token en función de las restricciones de IP. Después de que un usuario autoriza el conector, Salesforce entrega las solicitudes de datos del conector según el token de acceso válido del usuario.

Para establecer la política de la app administrada por Google(o tu propia app cliente externa), haz lo siguiente:

  1. En Salesforce, ve a Configuración.

  2. Ve a Apps > Administrador de apps de clientes externos y haz clic en Gemini Enterprise (o el nombre de tu app de cliente externo personalizada).

  3. Selecciona la pestaña Políticas y haz clic en Editar.

  4. En la sección Políticas de OAuth, configura Relajación de IP como Disminución de las restricciones de IP.

  5. Haz clic en Guardar.

Conecta una organización de zona de pruebas

Un entorno de pruebas es una organización de Salesforce independiente con su propio host de Mi dominio y sus propios paquetes y apps instalados. La configuración de producción no configura la zona de pruebas.

Para conectar una organización de zona de pruebas, activa el servidor de MCP SObject All en la zona de pruebas y, luego, instala el paquete de AppExchange en la zona de pruebas (elige Install in Sandbox) o crea tu app cliente externa en la zona de pruebas. Para conocer la configuración del almacén de datos que requiere una conexión de zona de pruebas, consulta Configura un almacén de datos de Salesforce.

Qué sucede después de configurar Salesforce

Configurar la app en Salesforce no conecta nada por sí solo. Hace que la app de OAuth esté disponible para tu organización, de modo que los usuarios individuales puedan autorizarla.

Después de que un administrador de Google Cloud crea el almacén de datos de Salesforce en Gemini Enterprise y lo conecta a una app (consulta Configura un almacén de datos de Salesforce), cada usuario final (incluidos los administradores que usan la app web) autoriza a Gemini Enterprise a acceder a Salesforce en su nombre con la autenticación de usuario final por usuario. Cuando un usuario consulta por primera vez los datos de Salesforce en la app web de Gemini Enterprise, se lo redirecciona a la página de acceso de Salesforce de tu organización, donde otorga a la app los permisos mcp_api y refresh_token. Para obtener más información, consulta Autoriza el conector.

Debido a que cada usuario otorga la autorización de forma individual, Gemini Enterprise accede a los registros de Salesforce con los permisos de ese usuario. Un usuario solo ve y modifica los registros que ya puede ver y modificar en Salesforce.

Solucionar problemas

Síntoma Causa probable
El paso Verificar autenticación o Autorizar falla, o la página de acceso de Salesforce informa una aplicación cliente desconocida, no válida o no autorizada. Si usas OAuth 2.0 (administrado por Google), verifica que el paquete administrado esté instalado en la organización exacta (incluido un entorno de pruebas) a la que apunta el URI de la instancia. Si usas OAuth 2.0 (Bring Your Own App), verifica que el ID de cliente y el secreto del cliente coincidan con la app de esa organización, que la URL de devolución de llamada esté configurada en https://vertexaisearch.cloud.google.com/oauth-redirect, que se hayan seleccionado los permisos mcp_api y refresh_token, y que esté habilitada la opción Requerir la extensión Proof Key for Code Exchange (PKCE) para los flujos de autorización admitidos.
Algunos usuarios pueden autorizar y otros no. La política Usuarios permitidos de la app restringe el acceso a perfiles o conjuntos de permisos específicos que no incluyen a esos usuarios, o la Relajación de IP no está configurada como Relajar restricciones de IP. En Configuración, abre la pestaña Políticas de la app, haz clic en Editar, agrega los perfiles o conjuntos de permisos afectados (o establece Usuarios permitidos en Todos los usuarios se autoautorizarán) y verifica que Relajación de IP esté configurada en Relajar restricciones de IP.
La autorización se realiza correctamente, pero las consultas o acciones fallan en la app web de Gemini Enterprise. Verifica los siguientes parámetros de configuración en Salesforce:
  • El usuario que autoriza tiene el permiso del sistema API habilitada seleccionado en Permisos del sistema en su perfil o un conjunto de permisos asignado.
  • El servidor de MCP SObject All está activo en la organización. Para activar el servidor de MCP SObject All en la configuración de Salesforce, consulta Habilita el servidor de MCP en tu organización.
  • Si usas OAuth 2.0 (Trae tu propia app), se selecciona Emitir tokens de acceso basados en JSON Web Token (JWT) para usuarios con nombre en tu app cliente externa.
La autorización se realiza correctamente, pero no se devuelven datos de Salesforce. Es posible que el usuario que autoriza no tenga acceso a nivel de registro en Salesforce. El conector respeta los permisos de Salesforce del usuario.

¿Qué sigue?