Guía de conexión JWT OAuth de Salesforce para Jitterbit App Builder

Requisitos previos

• Debes tener una cuenta de Salesforce con al menos 1 licencia de usuario activo de Salesforce y un entorno sandbox al que conectarte.

Limitaciones

• Solo puedes tener una conexión JWT de Salesforce por instancia de App Builder.

Creación de un certificado

Salesforce solo acepta JWT firmados con RSA SHA256, por lo que necesitas un Certificado x509 y su clave privada asociada.

1. Descarga e instala OpenSSL

   • OpenSSL es una herramienta completa para criptografía y comunicación segura. Puedes descargarla gratis: https://www.openssl.org/

   • También puedes instalar Git, ya que tiene OpenSSL instalado en su interior: https://git-scm.com/

2. Después de instalar OpenSSL, procede a crear un Certificado y Clave X509

   • Abre una terminal o línea de comandos, ejecuta OpenSSL y luego ejecuta el siguiente comando para crear un archivo de certificado y clave:

     req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout myKey.key -out myCertificate.crt
     

   • Se te pedirá que completes detalles como País, Nombre Común o Dirección de Correo Electrónico. No es necesario completar toda la información, pero el Nombre Común es obligatorio.

   

3. Después de ejecutar el comando anterior, deberías encontrar dos archivos creados

   

Configuración en Salesforce

Ahora que tenemos nuestro Certificado, necesitamos crear una aplicación conectada en Salesforce.

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 y 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, y luego aparecerán las siguientes configuraciones.
   • URL de Callback - sfdc://oauth/jwt/success
   • Usar firmas digitales - Marca esta casilla, luego sube el archivo myCertificate.crt que creamos anteriormente.
   • Ámbitos de OAuth Seleccionados - Elige "Gestionar datos de usuario a través de APIs (api)", "Acceso completo (full)" y "Realizar solicitudes en cualquier momento (refresh_token, offline_access)".
4. Haz clic en Guardar y luego haz clic en Continuar.
5. Ahora que se ha creado la aplicación conectada, necesitamos anotar el ID de Cliente y el Secreto de Cliente para esta aplicación.
6. En la página principal de la aplicación conectada, haz clic en el botón titulado "Gestionar 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 para la aplicación. Toma nota de esto ya que lo necesitaremos más adelante.
7. A continuación, necesitamos ajustar la configuración de la aplicación conectada para preaprobar a nuestro usuario.
8. En la página de la aplicación conectada, haz clic en el botón "Gestionar" en la parte superior de la pantalla, luego en la siguiente página, haz clic en el botón "Editar Políticas".
9. En la sección de Políticas de OAuth, cambia el menú desplegable de Usuarios Permitidos de "Todos los usuarios pueden autorizarse a sí mismos" a "Los usuarios aprobados por el administrador están preautorizados".
10. Haz clic en Guardar.
11. Una vez que la página se actualice, deberías ver una sección de "Perfiles" cerca de la parte inferior. Haz clic en el botón "Gestionar Perfiles".
12. Agrega el perfil con el que te estás conectando, en este ejemplo estamos usando el perfil de Administrador del Sistema.
13. Haz clic en Guardar.
14. Esto completa la sección de configuración de Salesforce.

Configuración en el servidor de la aplicación

Ahora que hemos creado la aplicación en Salesforce y subido nuestro certificado, necesitamos colocar el archivo de clave en el servidor de la aplicación donde se está ejecutando App Builder, para permitir que App Builder acceda a él.

1. En el servidor de la aplicación o en el servidor de App Builder, crea o utiliza una carpeta existente para colocar el certificado y el archivo de clave que generamos anteriormente. Este ejemplo muestra una carpeta creada llamada JWT.

   

2. Haz clic derecho en la carpeta donde se encuentran estos archivos y selecciona Propiedades, luego la pestaña Seguridad. Asegúrate de que esta carpeta tenga control total para el grupo de aplicaciones en el que está desplegado App Builder.

   

3. Esto completa la configuración en el servidor de la aplicación.

Configuración en App Builder

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

Ahora que hemos creado la aplicación en Salesforce y subido nuestro certificado, podemos proceder a crear la fuente de datos de Salesforce en App Builder.

1. Ve a la 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 del Servidor
4. Establece el Tipo como Salesforce ADO.NET

5. Haz clic en Guardar. Asegúrate de marcar la casilla Sandbox si te estás conectando a una instancia de sandbox.

   

6. Después de que la fuente de datos se haya guardado, haz clic en el ícono de maletín de Configuraciones Avanzadas

7. Luego haz clic en Editar y expande la sección Avanzada

   

8. Configura los siguientes ajustes:

   • AuthScheme - OAuthJWT
   • OAuthJWTCertType - PEMKEY_FILE
   • OAuthJWTCert - Ubicación del archivo de clave que creamos anteriormente, debería estar en una carpeta en algún lugar. Por ejemplo: C:\JWT\myKey.key
   • OAuthJWTIssuer - Este es el valor del ID de Cliente que obtuvimos de Salesforce anteriormente.
   • OAuthJWTSubject - Este debería ser tu correo electrónico de Salesforce, o el correo electrónico del usuario de Salesforce con el que estamos autenticando.

   Nota

   Ingrese cada configuración en el campo Avanzado en una sola línea sin espacios, y separe cada configuración con un punto y coma (;). Aquí hay un ejemplo:

   

9. Ahora que todo está configurado, desplácese hacia abajo y pruebe la conexión. Si todo se configuró correctamente, recibirá un mensaje de Éxito.

10. Ahora puede importar tablas y acceder a datos de Salesforce.