Integrar una aplicación para el flujo de intercambio de tokens
Para integrar una aplicación con Salesforce para el flujo de intercambio de tokens de OAuth 2.0, cree una aplicación conectada de Salesforce o una aplicación cliente externa.
Ediciones necesarias
| Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition |
- Opción 1: Crear una aplicación conectada
Para activar una aplicación conectada para el flujo de intercambio de tokens, realice estos pasos. - Opción 2: Crear una aplicación cliente externa
Para activar una aplicación cliente externa para el flujo de intercambio de tokens, realice estos pasos.
Opción 1: Crear una aplicación conectada
Para activar una aplicación conectada para el flujo de intercambio de tokens, realice estos pasos.
Ediciones necesarias
| Permisos de usuario necesarios | |
|---|---|
| Para leer, crear, actualizar o eliminar aplicaciones conectadas: | Personalizar aplicación Y Modificar todos los datos O Gestionar aplicaciones conectadas |
| Para actualizar todos los campos, excepto Perfiles, Conjuntos de permisos y Atributos SAML de proveedor de servicio: | Personalizar aplicación Y Modificar todos los datos O Gestionar aplicaciones conectadas |
| Para actualizar Perfiles, Conjuntos de permisos y Atributos SAML de proveedor de servicio: | Personalizar aplicación Y Modificar todos los datos Y Gestionar perfiles y conjuntos de permisos |
| Para rotar la clave de consumidor y el secreto de consumidor: | Permitir la rotación de secreto y clave de consumidor |
| Para instalar y desinstalar aplicaciones conectadas: | Personalizar aplicación Y Modificar todos los datos O Gestionar aplicaciones conectadas |
| Para instalar y desinstalar aplicaciones conectadas empaquetadas: | Descargar paquetes de AppExchange Y Personalizar aplicación Y Modificar todos los datos O Gestionar aplicaciones conectadas |
- Cree una aplicación conectada y complete su información bÔsica.
- Activar la configuración de OAuth de la aplicación conectada para integración de API. AdemÔs de activar OAuth e ingresar una URL de devolución de llamada, utilice estos parÔmetros.
- Para definir los permisos de la aplicación, seleccione Ômbitos. Cuando configura el flujo, la solicitud de token puede incluir opcionalmente un parÔmetro
scopes. Los Ômbitos en este parÔmetro deben coincidir o ser un subconjunto de los Ômbitos asignados a la aplicación conectada. - Seleccione Activar flujo de intercambio de tokens.
- Opcionalmente, seleccione Requerir secreto para flujo de intercambio de tokens. Le recomendamos activar este parÔmetro solo para clientes privados con un backend de cliente seguro. Para clientes públicos que no pueden mantener el secreto de consumidor confidencial, como aplicaciones de una sola pÔgina y aplicaciones móviles, no active esta configuración.
- Opcionalmente, para emitir tokens de acceso basados en Token web de JSON (JWT) en vez de tokens de acceso opacos, consulte Activar tokens de acceso basados en Token web de JSON (JWT).
- Para definir los permisos de la aplicación, seleccione Ômbitos. Cuando configura el flujo, la solicitud de token puede incluir opcionalmente un parÔmetro
- Establezca las polĆticas de OAuth para la aplicación conectada. AsegĆŗrese de utilizar estos parĆ”metros.
- Para la polĆtica Usuarios permitidos, seleccione Los usuarios aprobados por el administrador se han autorizado previamente. Para controlar quĆ© usuarios estĆ”n aprobados por el administrador, gestione quĆ© perfiles estĆ”n asignados a la aplicación.
- Seleccione Activar flujo de intercambio de tokens.
- Guarde sus cambios.
A continuación, cree una clase de Apex de controlador de intercambio de tokens.
Opción 2: Crear una aplicación cliente externa
Para activar una aplicación cliente externa para el flujo de intercambio de tokens, realice estos pasos.
Antes de empezar, configure permisos para aplicaciones cliente externas.
- Cree una aplicación cliente externa local y configure su configuración bÔsica.
- Implemente la aplicación cliente externa.
- Configure los parÔmetros de OAuth globales de la aplicación cliente externa. Asegúrese de establecer estos campos.
Field Description isTokenExchangeEnabled Boolean field indicating whether the token exchange flow is enabled. Set this field to true.isSecretRequiredForTokenExchange Boolean field indicating whether the app is required to send its consumer secret in the token request. We recommend that you set this field to trueonly if your app has a private client back end that can keep the secret confidential. For public clients such as mobile apps and single-page apps, set this field tofalse.Este es un archivo de configuración de OAuth global de ejemplo.<?xml version="1.0" encoding="UTF-8"?> <ExtlClntAppGlobalOauthSettings xmlns="http://soap.sforce.com/2006/04/metadata"> <callbackUrl>https://www.example.com</callbackUrl> <externalClientApplication>myeca</externalClientApplication> <idTokenConfig> <idTokenAudience>SalesforceAudience</idTokenAudience> <idTokenIncludeStandardClaims>true</idTokenIncludeStandardClaims> <idTokenValidityInMinutes>0</idTokenValidityInMinutes> </idTokenConfig> <isConsumerSecretOptional>false</isConsumerSecretOptional> <isIntrospectAllTokens>false</isIntrospectAllTokens> <isPkceRequired>false</isPkceRequired> <isSecretRequiredForRefreshToken>false</isSecretRequiredForRefreshToken> <label>myecaglobalset</label> <shouldRotateConsumerKey>false</shouldRotateConsumerKey> <shouldRotateConsumerSecret>false</shouldRotateConsumerSecret> <isTokenExchangeEnabled>true</isTokenExchangeEnabled> <isSecretRequiredForTokenExchange>true</isSecretRequiredForTokenExchange> </ExtlClntAppGlobalOauthSettings> - Configure los parĆ”metros de OAuth de la aplicación cliente externa, que afectan a la instancia local. AdemĆ”s de los campos obligatorios, puede utilizar el campo commaSeparatedOauthScopes para especificar Ć”mbitos. Si envĆa un parĆ”metro
scopesen su solicitud de token, los Ć”mbitos deben coincidir o ser un subconjunto de los Ć”mbitos asignados a su aplicación cliente externa. - Configure las polĆticas de OAuth de la aplicación cliente externa. Si crea su propio archivo de polĆticas, asegĆŗrese de que el campo
permittedUsersPolicyTypeestÔ establecido comoAdminApprovedPreAuthorized. - Implemente el complemento de OAuth de la aplicación cliente externa.
A continuación, cree una clase de Apex de controlador de intercambio de tokens.

