Saltar al contenido

Proveedor de seguridad Salesforce / OpenID Connect en Jitterbit App Builder

Nota

Esta guía de conexión es el proceso recomendado para la autenticación de cuenta a nivel de usuario entre App Builder y Salesforce. Consulta la guía de conexión OAuth de Salesforce JWT si deseas configurar la autenticación de cuenta de servicio.

El proveedor de seguridad Salesforce / OpenID Connect (SF/OIDC) es una implementación específica del proveedor del OpenID Connect. La implementación de Salesforce permite que App Builder autentique usuarios de Salesforce. También se puede utilizar para autorizar solicitudes a los siguientes servidores de datos:

  • Salesforce ADO.NET
  • REST

Limitaciones

  • El proveedor de seguridad SF/OIDC no se puede usar con servidores de datos de Salesforce1 Platform
  • El proveedor de seguridad SF/OIDC no es compatible con el parámetro ReplaceIssuerTenantId

Configurar en Salesforce

Para comenzar, deberás acceder a tu cuenta de Salesforce y crear una aplicación conectada.

Desde la pantalla Manage Connected Apps en Salesforce:

  1. Proporciona el valor de Callback URL. Esta es la URL que se invoca después de la autorización OAuth para la aplicación conectada del consumidor. Esta es la raíz del directorio de App Builder/signin-[Scheme of Security Provider].
    Por ejemplo: https://example.com/Vinyl/signin-Salesforce

  2. Agrega los siguientes Available OAuth Scopes a la lista de Selected OAuth Scopes:

    • Access the identity URL service (id, profile, email, address, phone)
    • Access unique user identifiers (openid)
    • Full access (full)
    • Manage user data via APIs (api)
    • Perform requests at any time (refresh_token, offline_access)

  3. Asegúrate de que las siguientes opciones estén habilitadas:

    • Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows
    • Require Secret for Web Server Flow
    • Require Secret for Refresh Token Flow
    • Enable Client Credentials Flow

La Consumer Key y la Consumer Secret de la aplicación conectada de Salesforce son obligatorias para la configuración de App Builder. Asegúrate de tener estos valores disponibles como referencia.

Para obtener las credenciales de la aplicación conectada de Salesforce:

  1. Accede a tu cuenta de Salesforce
  2. Navega a Apps > Connected Apps > Manage Connected Apps
  3. Haz clic en el botón Manage Consumer Details para Consumer Key and Secret
  4. Copia los valores de Consumer Key y Consumer Secret

Configurar Salesforce como proveedor de seguridad en App Builder

El proveedor de seguridad SF/OIDC requiere:

  • Credenciales del cliente (Consumer Key y Consumer Secret)

Para configurar el proveedor de seguridad de Salesforce:

  1. Accede a la instancia de App Builder como administrador
  2. Navega al IDE
  3. Haz clic en Security Providers desde el menú Connect
  4. Haz clic en + Security Provider

  5. Proporciona lo siguiente:

    • Name: Salesforce
    • Type: Salesforce / OpenID Connect

  6. Marca el campo Enabled

  7. Selecciona User como valor de Owner de Tokens
  8. Haz clic en el botón Save
  9. En el panel Endpoints, App Builder proporciona puntos finales predeterminados y no se necesita configuración adicional a menos que desees anular los valores predeterminados. El valor predeterminado de OpenID Connect Issuer es https://login.salesforce.com.

  10. En el panel Credentials, haz clic en el botón + Credential para agregar la siguiente credencial:

    • Type: Client
    • User Name: proporciona la Salesforce Consumer Key
    • Password: proporciona la Salesforce Consumer Secret

  11. Haz clic en Save y cierra la pantalla Credential

  12. En el panel Properties, haz clic en el botón +Property para agregar las siguientes propiedades:

    • Parameter: Scopes
    • Value: openid profile offline_access api

  13. Haz clic en Guardar y sal de la pantalla Propiedades

  14. Haz clic en + Solicitud desde el panel Solicitudes y agrega lo siguiente:

    • Identificador: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
    • Uso: Nombre

  15. Haz clic en Guardar y agrega un registro de Solicitudes adicional:

    • Identificador: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier
    • Uso: ID de nombre

  16. Haz clic en Guardar

Registra Salesforce como servidor de fuente de datos

Para registrar Salesforce como servidor de fuente de datos:

  1. Inicia sesión en la instancia del Constructor de aplicaciones como administrador
  2. Navega al IDE
  3. Haz clic en el botón Servidores de datos desde el menú Conectar
  4. Haz clic en + Servidor para registrar un nuevo servidor

  5. Proporciona lo siguiente:

    • Nombre del servidor: Un nombre identificable. Por ejemplo: Aplicación conectada de Salesforce
    • Tipo: Salesforce ADO.NET

  6. Haz clic en el botón Configuración avanzada

  7. Proporciona la información del servidor OAuth en el campo Avanzado:

    https://<tu instancia>.salesforce.com/services/Soap/c/56.0/<tu ID de organización>
    Para encontrar tu instancia, inicia sesión en Salesforce y la URL comenzará con la instancia correcta.
    El ID de organización se puede encontrar siguiendo este artículo de Salesforce: Encuentra tu ID de organización de Salesforce

  8. Haz clic en Guardar y regresa a la pantalla de configuración de Servidor

  9. Expande Configuración de seguridad y selecciona Salesforce como Proveedor de seguridad
  10. Haz clic en Guardar

  11. Expande Pruebas y haz clic en el botón Probar conexión

    • Haz clic en el botón Continuar para confirmar. Si toda la información se configura correctamente, recibirás el mensaje "La prueba de conexión fue exitosa".