Traducido con IA. Aún no revisado por la comunidad. Leer en inglés

Blog · 3 de octubre de 2023 · Steve Simpson · Identidad

Guía paso a paso: configurar una aplicación conectada en Salesforce para una integración OAuth sencilla

Bienvenido a esta guía para configurar una aplicación conectada en Salesforce para una integración OAuth fluida. En este tutorial paso a paso aprenderás lo básico para configurar una aplicación conectada en Salesforce y acceder a ella por API con Postman. Entremos en OAuth y empecemos a configurar una aplicación conectada.

Paso 1: crear una nueva aplicación conectada

Ir al Administrador de aplicaciones: primero, abre el Administrador de aplicaciones en Salesforce.

Habilitar el acceso por API: para que las aplicaciones externas accedan por API, crea una nueva aplicación conectada y llámala “App One”.

Configurar la aplicación: indica un correo electrónico para la aplicación y habilita la configuración de OAuth. Algunos flujos OAuth requieren una URL de devolución de llamada (hablaremos de eso en guías futuras); por ahora, pon un valor provisional como “www.salesforce.com” (opens in a new tab).

Captura de pantalla: creación de una nueva aplicación conectada en el Administrador de aplicaciones, con la configuración de OAuth habilitada Captura de pantalla: elección de los ámbitos OAuth de la aplicación conectada y definición de la URL de devolución de llamada

Paso 2: definir los ámbitos OAuth

Los ámbitos definen qué capacidades son accesibles por API. Para este tutorial:

Administrar datos de usuario: asigna el ámbito que permite administrar datos de usuario por API.

Guardar y esperar: guarda la configuración y espera unos 10 minutos a que termine el proceso.

Paso 3: obtener los datos del consumidor

Luego necesitarás dos datos importantes y no públicos: la clave del consumidor (Consumer Key) y el secreto del consumidor (Consumer Secret). Haz clic en el botón correspondiente para autenticarte y obtener estos datos de “App One”.

Paso 4: autenticarse con Postman

Captura de pantalla de Postman: un POST al endpoint de token OAuth de Salesforce que devuelve un token de acceso

Iniciar una llamada POST: en Postman, crea una llamada POST al servidor OAuth en “login.salesforce.com/services/oauth2/token”.

Definir los parámetros: en el cuerpo, incluye los parámetros, entre ellos grant type (password), client ID (la clave del consumidor) y el Client Secret.

Incluir las credenciales: agrega el nombre de usuario y la contraseña a los parámetros y luego haz un POST al endpoint OAuth para autenticarte.

Paso 5: token de acceso y consultas

Después de autenticarte con éxito:

Recibir el token de acceso: obtienes un token de acceso, necesario para hacer llamadas a la API.

Incluir el token: en Postman, en tu consulta, pon el token de acceso en la línea Authorization del encabezado, precedido de “Bearer”.

Captura de pantalla de Postman: una consulta REST con el token de acceso en el encabezado Authorization, que devuelve registros en JSON

Ejecutar consultas: con el token incluido, envía la solicitud para ejecutar consultas y obtener datos.

Paso 6: versiones del endpoint y siguientes pasos

Ahora puedes usar la versión del endpoint de tu aplicación conectada (por ejemplo, la versión 58) para obtener datos. Esta configuración básica no cubre todos los demás elementos de flujo ni las devoluciones de llamada, pero es un primer paso en la integración OAuth con Postman y Salesforce.

Conclusión y siguientes pasos

Configuraste una aplicación conectada en Salesforce y la autenticaste vía OAuth para acceder a la API desde Postman. Esta guía cubre lo básico; otros tutoriales presentarán flujos OAuth y funciones adicionales para ampliar tu aplicación.

No te lo pierdas

¡Empieza con confianza tu camino por las API de Salesforce! Para más ideas y consejos, sigue atento aquí en www.SteveTechArc.com y en el canal de YouTube @SteveTechArc (opens in a new tab). Suscríbete y amplía tu comprensión de Salesforce y de cómo integrarlo con otros sistemas.

¡Ayudando a cambiar el mundo compartiendo conocimientos de integración con otros arquitectos y con quienes están en camino de serlo!

Transcripción hecha con ayuda de IA

STA 3.11