Activar aplicaciones para un controlador de intercambio de tokens
Para activar una aplicación conectada o una aplicación cliente externa para un controlador de intercambio de tokens, utilice la página Controladores de intercambio de tokens en Configuración o modifique su definición de metadatos.
Ediciones necesarias
| Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition |
Antes de empezar, asegúrese de tener una aplicación conectada o una aplicación cliente externa configurada para el flujo de intercambio de tokens. Consulte Integrar una aplicación para el flujo de intercambio de tokens.
Puede activar un controlador de intercambio de tokens para múltiples aplicaciones conectadas o aplicaciones cliente externas. Una única aplicación conectada o aplicación cliente externa se puede asociar con múltiples controladores.
- Opción 1: Activar aplicaciones en Configuración
Para utilizar una aplicación cliente externa o una aplicación conectada con el controlador de intercambio de tokens, active aplicaciones desde la página Controlador de intercambio de tokens en Configuración. - Opción 2: Activar aplicaciones a través de la API de metadatos
Utilice la API de metadatos para activar aplicaciones cliente externas de aplicaciones conectadas para un controlador de intercambio de tokens.
Opción 1: Activar aplicaciones en Configuración
Para utilizar una aplicación cliente externa o una aplicación conectada con el controlador de intercambio de tokens, active aplicaciones desde la página Controlador de intercambio de tokens en Configuración.
Antes de empezar, asegúrese de tener una aplicación conectada o una aplicación cliente externa configurada para el flujo de intercambio de tokens. Consulte Integrar una aplicación para el flujo de intercambio de tokens.
- Si no está en la página Controladores de intercambio de tokens en Configuración, navegue allí. Desde Configuración, en el cuadro Búsqueda rápida, ingrese Token y, a continuación, seleccione Controladores de intercambio de tokens.
-
Busque el controlador que desea modificar, haga clic en
y luego seleccione Ver detalles.
- Bajo Aplicaciones activadas, haga clic en Activar nueva aplicación.
- Seleccione el tipo de aplicación que desea activar y haga clic en Siguiente.
-
Para Seleccionar aplicación, busque y seleccione la aplicación conectada o la aplicación cliente externa que desea utilizar.
Nota La búsqueda de aplicación solo devuelve aplicaciones configuradas correctamente para el flujo de intercambio de tokens. Si no puede encontrar una aplicación, compruebe su configuración y políticas. -
Para Ejecutar como, busque y seleccione un usuario de ejecución para ejecutar el controlador. Recomendamos que utilice una cuenta de usuario de integración que no represente un usuario real.
La búsqueda devuelve hasta 200 usuarios. Para filtrar usuarios, ingrese la primera letra del nombre o apellidos del usuario. O bien, para encontrar rápidamente todos los usuarios cuyos nombres contienen una cadena concreta, ingrese el carácter * (asterisco) seguido de la cadena. Por ejemplo, para buscar todas las cuentas de usuario con la integración de cadena, ingrese *ion.
-
Para establecer este controlador como el controlador predeterminado para esta aplicación, seleccione Convertir <nombre de su controlador> en el controlador predeterminado para esta aplicación. Una aplicación solo puede tener un controlador predeterminado.
Cuando se establece un controlador como predeterminado para una aplicación, Salesforce lo utiliza automáticamente durante el flujo de intercambio de tokens a menos que especifique un controlador diferente. Para obtener más información, consulte Configurar el flujo de intercambio de tokens.
-
Haga clic en Listo.
Su aplicación recién activada se muestra bajo Aplicaciones activadas en la página de detalles del controlador. Para encontrar aplicaciones con mayor facilidad, filtre su vista por tipo de aplicación u ordene aplicaciones por Nombre, Ejecutar como usuario o Fecha de activación.
Advertencia La clasificación solo se admite para gestores con hasta 100 aplicaciones activadas. Si tiene más de 100 aplicaciones, no funciona.
Para modificar una aplicación activada, junto a la aplicación, haga clic en
, seleccione Modificar y cambie su configuración según desee.
Para eliminar una aplicación del controlador, junto a la aplicación, haga clic en
y luego seleccione Eliminar. Confirme que desea eliminar la aplicación. Puede volver a activar la aplicación para el controlador en cualquier momento.
Tras finalizar la activación de su aplicación, configure el flujo de intercambio de tokens.
Opción 2: Activar aplicaciones a través de la API de metadatos
Utilice la API de metadatos para activar aplicaciones cliente externas de aplicaciones conectadas para un controlador de intercambio de tokens.
Asegúrese de tener los permisos correctos para trabajar con la API de metadatos. Consulte Acceso de modificación de la API de metadatos en la Guía del desarrollador de la API de metadatos.
Para trabajar con la API de metadatos, utilice Extensiones de Salesforce para código de Visual Studio en la CLI de Salesforce, o bien utilice una herramienta de desarrollador de su elección. Para obtener más información, consulte Herramientas del desarrollador de la API de metadatos en la Guía del desarrollador de la API de metadatos.
La API de metadatos admite desarrollo basado en archivos y basado en CRUD. Estos pasos tratan cómo definir el controlador con desarrollo basado en archivos.
-
En el archivo
your_handler_name.oauthtokenexchangehandler, establezca el campo isEnabled entrue. - Agregue un campo denominado activaciones. Este campo hace referencia al tipo de metadatos OauthTokenExchHandlerApp.
-
En el campo activaciones, agregue estos campos.
-
Para especificar el usuario de ejecución que ejecuta el controlador, agregue un campo de usuario
apexExecutionUsere ingrese el nombre del usuario. Recomendamos que utilice una cuenta de usuario de integración que no represente un usuario real. - Si está utilizando una aplicación conectada, agregue un campo connectedApp y especifique el nombre de API de la aplicación conectada.
- Si está utilizando una aplicación cliente externa, agregue un campo externalClientApp y especifique el nombre de API de la aplicación cliente externa.
- Para definir para qué controlador es su controlador predeterminado, establezca el campo booleano isDefault. Durante el flujo de intercambio de tokens, cuando envía una solicitud de token, puede especificar opcionalmente el nombre del controlador que desea utilizar. Si no especifica un nombre, Salesforce utiliza el controlador predeterminado. Si tiene múltiples controladores, especifique solo uno predeterminado.
-
Para especificar el usuario de ejecución que ejecuta el controlador, agregue un campo de usuario
-
Opcionalmente, para agregar más aplicaciones al controlador, agregue un campo activaciones para la aplicación.
A continuación se incluye un ejemplo de la definición de metadatos de controlador de intercambio de tokens completo. Este controlador está activado para dos aplicaciones conectadas
<?xml version="1.0" encoding="UTF-8"?> <OauthTokenExchangeHandler xmlns="http://soap.sforce.com/2006/04/metadata"> <developerName>MyTokenExchangeHandler</developerName> <description>My token exchange handler</description> <isAccessTokenSupported>true</isAccessTokenSupported> <isEnabled>true</isEnabled> <isIdTokenSupported>false</isIdTokenSupported> <isJwtSupported>true</isJwtSupported> <isProtected>false</isProtected> <isRefreshTokenSupported>false</isRefreshTokenSupported> <isSaml2Supported>false</isSaml2Supported> <isUserCreationAllowed>true</isUserCreationAllowed> <masterLabel>MyTokenExchangeHandler</masterLabel> <tokenHandlerApex>MyOauthTokenExchangeHandler</tokenHandlerApex> <enablements> <apexExecutionUser>integrationuser@mycompany.com</apexExecutionUser> <connectedApp>TokenExchangeApp1</conectedApp> <isDefault>true</isDefault> </enablements> <enablements> <apexExecutionUser>integrationuser@mycompany.com</apexExecutionUser> <connectedApp>TokenExchangeApp2</conectedApp> <isDefault>true</isDefault> </enablements> </OauthTokenExchangeHandler> -
Utilizando su herramienta de desarrollo de metadatos, utilice la llamada
deploy()para implementar los cambios en su organización. -
Para ver el controlador, desde Configuración, en el cuadro Búsqueda rápida, ingrese Controladores de intercambio de tokens y luego seleccione Controladores de intercambio de tokens.
Puede ver el nombre, el nombre de API de cada controlador, los tipos de token admitidos y el estado. También puede ver cuándo se modificó por última vez y por quién.
Tras finalizar la activación de su aplicación, configure el flujo de intercambio de tokens.

