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 cuentas a nivel de usuario entre App Builder y Salesforce. Consulta la guía de conexión Salesforce JWT OAuth si buscas 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 de seguridad OpenID Connect. La implementación de Salesforce permite que App Builder autentique a los 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 utilizar con servidores de datos de Salesforce1 Platform
- El proveedor de seguridad SF/OIDC no admite el parámetro ReplaceIssuerTenantId
Configurar en Salesforce
Para comenzar, necesitarás iniciar sesión en tu cuenta de Salesforce y crear una Aplicación Conectada.
Desde la pantalla de Administrar Aplicaciones Conectadas en Salesforce:
-
Proporciona el valor de URL de Callback. Esta es la URL invocada después de la autorización OAuth para la aplicación conectada del consumidor. Este es el directorio raíz de App Builder/signin-[Nombre del Proveedor de Seguridad].
Por ejemplo:https://example.com/Vinyl/signin-Salesforce -
Agrega los siguientes Alcances OAuth Disponibles a la lista de Alcances OAuth Seleccionados:
- Acceder al servicio de URL de identidad (id, perfil, correo electrónico, dirección, teléfono)
- Acceder a identificadores de usuario únicos (openid)
- Acceso completo (full)
- Gestionar datos de usuario a través de APIs (api)
- Realizar solicitudes en cualquier momento (refresh_token, offline_access)
-
Asegúrate de que las siguientes opciones estén habilitadas:
- Requerir clave de prueba para el intercambio de código (PKCE) para flujos de autorización compatibles
- Requerir secreto para el flujo de servidor web
- Requerir secreto para el flujo de token de actualización
- Habilitar flujo de credenciales de cliente
El Consumer Key y el Consumer Secret para la aplicación conectada de Salesforce son necesarios para la configuración del App Builder. Asegúrate de tener estos valores a la mano para referencia.
Para obtener las credenciales de la aplicación conectada de Salesforce:
- Inicia sesión en tu cuenta de Salesforce
- Navega a Apps > Connected Apps > Manage Connected Apps
- Haz clic en el botón Manage Consumer Details para Consumer Key y Secret
- Copia los valores de Consumer Key y Consumer Secret
Configurar Salesforce como un 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:
- Inicia sesión en la instancia de App Builder como administrador
- Navega a la IDE
- Haz clic en Security Providers en el menú Connect
- Haz clic en + Data Source Authentication en el panel de Data Source Authentication
-
Proporciona lo siguiente:
- Name: Salesforce
- Type: Salesforce / OpenID Connect
-
Marca el campo Enabled
- Selecciona User como el valor de Owner de los Tokens
- Haz clic en el botón Save
- En el panel de Endpoints, App Builder proporciona endpoints predeterminados y no se necesita configuración adicional a menos que desees anular el predeterminado. El valor predeterminado de OpenID Connect Issuer es
https://login.salesforce.com. -
En el panel de Credentials, haz clic en el botón + Credential para agregar la siguiente credencial:
- Type: Client
- User Name: proporciona el Salesforce Consumer Key
- Password: proporciona el Salesforce Consumer Secret
-
Haz clic en Save y sal de la pantalla de Credential
-
En el panel de Properties, haz clic en el botón +Property para agregar las siguientes propiedades:
- Parameter: Scopes
- Value:
openid profile offline_access api
-
Haz clic en Save y sal de la pantalla de Properties
-
Haz clic en + Claim en el panel de Claims y agrega lo siguiente:
- Identificador:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name - Uso: Nombre
- Identificador:
-
Haz clic en Guardar y agrega un registro de Claims adicional:
- Identificador:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier - Uso: ID de Nombre
- Identificador:
-
Haz clic en Guardar
Registrar Salesforce como un servidor de fuente de datos
Para registrar Salesforce como un servidor de fuente de datos:
- Inicia sesión en la instancia de App Builder como administrador
- Navega a la IDE
- Haz clic en el botón Servidores de Datos en el menú Conectar
- Haz clic en + Servidor para registrar un nuevo servidor
-
Proporciona lo siguiente:
- Nombre del Servidor: Un Nombre identificable. Por ejemplo: Aplicación Conectada de Salesforce
- Tipo: Salesforce ADO.NET
-
Haz clic en el botón Configuración Avanzada
-
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 -
Haz clic en Guardar y regresa a la pantalla de configuración del Servidor
- Expande Configuraciones de Seguridad y selecciona Salesforce como el Proveedor de Seguridad
- Haz clic en Guardar
-
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 está configurada correctamente, recibirás el mensaje: "La prueba de conexión fue exitosa."