Guía de conexión OAuth con credenciales de cliente de Salesforce para Jitterbit App Builder

Requisitos previos

• Debes tener una cuenta de Salesforce con al menos 1 licencia de usuario activo de Salesforce.

Configuración en Salesforce

Crear un perfil de integración para usuario solo de API

1. En Salesforce, navega a Configuración y ve a la página de Perfiles. Esto se encuentra en el menú desplegable de Administración en el lado izquierdo de la página.

   

2. Haz clic en el botón Nuevo Perfil.

   

3. Verás un aviso para clonar un Perfil Existente, elige "Administrador del Sistema" que tiene una licencia de usuario de Salesforce. Proporciona un Nombre de Perfil identificable.

   

4. Haz clic en Guardar.

5. Una vez que se haya creado el perfil, verás una página que muestra los detalles del perfil. Haz clic en el botón "Editar".

   

6. Desplázate hacia abajo o busca en la página "Usuario Solo de API" para localizar la casilla de verificación de permisos bajo la sección de Permisos Administrativos de la página. Confirma que Usuario Solo de API esté marcado.

   

Crear un usuario de integración

1. Ahora que el perfil de integración está disponible, crearás el Usuario de Integración. En Configuración, ve a la página de "Usuarios". Esto se encuentra en el menú desplegable de Administración en el lado izquierdo de la página.

   

2. Haz clic en el botón "Nuevo Usuario".

   

3. Completa los siguientes campos:

   • Nombre – El nombre del sistema que se está integrando con Salesforce.
   • Apellido – "Integración". Se recomienda que el nombre y apellido comprendan el nombre del sistema y la palabra "integración" para que se pueda identificar fácilmente para qué es el usuario.
   • Correo Electrónico – Idealmente, este es un correo electrónico de distribución para que un equipo pueda monitorearlo.
   • Licencia de Usuario – Típicamente "Salesforce", pero usa la correcta para el perfil elegido.
   • Perfil – El que se creó en el paso anterior, en nuestro ejemplo titulado "Integración de App Builder".

4. Haz clic en Guardar. Ahora que el Usuario está creado, se puede crear la aplicación conectada a continuación.

Crear una aplicación OAuth personalizada

1. Inicia sesión en Salesforce.com o en tu entorno de sandbox de Salesforce.
2. Desde la página de inicio, ve a Herramientas de Plataforma > Aplicaciones > Administrador de Aplicaciones.

3. Haz clic en el botón Nueva Aplicación Conectada, e ingresa lo siguiente:

   • Nombre de la Aplicación Conectada - El nombre debe contener el nombre del sistema y la integración, como "Integración de App Builder" para identificarlo fácilmente, pero esto puede ser lo que desees.
   • Nombre de la API - Deja que Salesforce lo complete basado en el nombre de la Aplicación Conectada.
   • Correo Electrónico de Contacto - Cualquier correo electrónico que desees.
   • Habilitar Configuraciones de OAuth - Marca esta casilla, luego aparecerán las siguientes configuraciones.

   • URL de Callback - Esta será la URL de inicio de sesión con el proveedor de seguridad que utilizaremos para esta conexión. Debe terminar con "signin-SecurityProvider", por ejemplo.

     

   • Ámbitos de OAuth seleccionados - Elija "Gestionar datos de usuario a través de APIs (api)", "Acceso completo (full)" y "Realizar solicitudes en cualquier momento (refresh_token, offline_access)"

   • Habilitar flujo de credenciales de cliente - Asegúrese de que esta casilla esté marcada o habilitada.

4. Haga clic en Guardar y luego haga clic en Continuar.

5. Ahora se ha creado la aplicación conectada, pero debemos navegar a otra página para configurar el usuario en ejecución. En la página principal de la aplicación, haga clic en el botón "Administrar".
6. Haga clic en "Editar políticas", desplácese hacia abajo y en la sección titulada "Flujo de credenciales de cliente", haga clic en el botón de reloj de arena. Aquí elija el Usuario de Integración que creamos anteriormente.
7. Haga clic en Guardar. A continuación, necesitamos recuperar el ID de Cliente y el Secreto de Cliente para la aplicación que acabamos de crear.
8. En la página principal de la aplicación conectada, haga clic en el botón "Administrar detalles del consumidor". Esto debería abrir una nueva página después de completar un aviso de seguridad, que contiene el ID de Cliente y el Secreto de Cliente. Tenga en cuenta esta información ya que se necesita más adelante.
9. Esto completa la sección de configuración de Salesforce.

Configuración en App Builder

Crear un proveedor de seguridad OAuth en App Builder

1. Desde App Builder, navegue a la sección de "Proveedores de seguridad" del IDE.
2. Haga clic en el botón + Autenticación de fuente de datos.

3. Proporcione los siguientes detalles:

   • Nombre - Identifica al Proveedor de Seguridad y aparece en la URL. Ejemplo: Salesforce
   • Tipo - OAuth
   • Tipo de autenticación - OAuth
   • Concesión de OAuth - Credenciales de cliente
   • Autenticación de cliente OAuth - Básica
   • Autenticación de recurso OAuth - Portador
   • Propietario del token - Cliente
   • Redirigir en desafío - Verdadero

4. Haga clic en + Puntos finales y configure los siguientes 3 puntos finales. La URL debe coincidir con la instancia de Salesforce en sandbox o producción a la que nos estamos conectando:

   • Punto final de autorización - https://{{SalesforceInstanceURL}}/services/oauth2/authorize
   • Punto final de token - https://{{SalesforceInstanceURL}}/services/oauth2/token
   • Punto final de información del usuario - https://{{SalesforceInstanceURL}}/services/oauth2/userinfo

5. Haz clic en + Credencial y configura lo siguiente:

   • Tipo - Cliente
   • Nombre de Usuario - ID de Cliente de Salesforce
   • Contraseña - Secreto de Salesforce

6. Esto completa la configuración del proveedor de seguridad en App Builder

Crear la fuente de datos Salesforce ADO.NET en App Builder

1. Ve al IDE de App Builder y haz clic en Servidores de Datos.
2. Haz clic en el botón + Servidor para agregar una nueva fuente de datos.
3. Asigna un Nombre al Servidor.
4. Establece el Tipo como Salesforce ADO.NET

5. Expande la Configuración de Seguridad y establece el Proveedor de Seguridad en el que creamos anteriormente. Por ejemplo: SalesforceCC.

   

6. Por último, necesitamos establecer la URL del servidor OAuth. Hacemos esto haciendo clic en el botón Configuración Avanzada en el servidor de datos después de que se haya creado.

   

7. Aquí podemos configurar la URL del servidor OAuth. Esto debe configurarse a la URL de tu instancia de Salesforce, seguida de services/Soap/c/55.0.

   • Por ejemplo: url del servidor oauth = https://{{SalesforceInstance}}/services/Soap/c/55.0

8. Expande Pruebas y haz clic en el botón Probar Conexión para asegurarte de que la configuración esté funcionando como se espera.