DQE One se conecta a su org de Salesforce mediante una autorización dedicada (la aplicación DQE One Installer, llamada External Client App en las orgs de Salesforce más recientes) creada durante la instalación. Cada vez que se lanza un proceso — un job programado, una fusión manual, una acción de Data Stewardship o un mapping — DQE One utiliza un refresh token almacenado en su configuración para solicitar un access token de corta duración antes de llamar al servicio DQE. Si ese refresh token ya no es válido, el proceso falla de inmediato con un error «Expired access/refresh token», aunque no haya cambiado nada en la configuración del propio proceso.
Síntomas comunes
- un proceso que antes funcionaba correctamente ahora falla nada más empezar;
- el mensaje de error contiene «expired access/refresh token» o «invalid_grant»;
- el fallo no está relacionado con un cambio reciente en el proceso, el mapping o el rule set;
- los jobs programados, las fusiones manuales, las acciones de Data Stewardship y las llamadas en tiempo real pueden verse afectados, ya que comparten la misma conexión;
- el problema puede reaparecer después de un tiempo aunque ya se hubiera resuelto antes.
Por qué ocurre esto
El refresh token que utiliza DQE One está vinculado a la autorización concedida a la aplicación DQE One Installer durante la configuración. Salesforce invalida ese refresh token de forma independiente a DQE One cuando ocurre, del lado de la org, alguno de los siguientes casos:
- la política OAuth de la connected app impone una vida útil al refresh token (por ejemplo, «expira tras un período definido») y ese período ya ha transcurrido;
- el token fue revocado explícitamente — por ejemplo desde Setup > Connected Apps OAuth Usage, o como parte de una revisión de seguridad;
- el usuario de Salesforce que autorizó originalmente la conexión fue desactivado, congelado, o se le retiró el permiso API Enabled;
- la política OAuth de la connected app rota el refresh token en cada uso (Rotate Refresh Token) — DQE One solo almacena un único valor de refresh token y únicamente lo actualiza durante una instalación/reinstalación; si esta rotación está activada en su org, el valor almacenado puede quedar obsoleto entre dos ejecuciones del instalador.
En todos estos casos, reconectar DQE One desde su Setup — como se describe a continuación — genera un nuevo refresh token y resuelve el error.
Solución: reconectar DQE One
- Vaya al Setup de DQE One.
- Desinstale la configuración existente.
- Vuelva a lanzar la instalación haciendo clic en Start Installation.
- Complete el campo de licencia.
- Complete la URL del backend solo si utiliza su propio servidor DQE autoalojado — déjela vacía en caso contrario.
- Seleccione los productos asociados a su contrato.
- Si la instalación falla debido a las credenciales anteriores, haga clic en Exit en la página de error (no en Retry), para que desinstale las credenciales anteriores en lugar de reutilizarlas.
- Vuelva a lanzar la instalación con los mismos campos (licencia, URL del backend, productos).
- La instalación debería completarse correctamente.
- Si utiliza el módulo en tiempo real, vaya a Named Credentials, edite el named credential DQE One Tooling API y guárdelo.
Cómo evitar que esto vuelva a ocurrir
- En el Setup de Salesforce, abra la connected app / external client app DQE One Installer y revise sus políticas OAuth: la política de vida útil del refresh token y si Rotate Refresh Token está activado. Si la política de seguridad de su org exige la rotación, DQE One deberá reconectarse cada vez que se aplique.
- Evite desactivar, congelar o retirar el permiso API Enabled al usuario que autorizó la conexión de DQE One sin antes reconectar DQE One con otro usuario.
- Revise Setup > Connected Apps OAuth Usage antes de revocar tokens de la aplicación DQE One Installer, ya que esto rompe de inmediato todos los procesos de DQE One.
Cuándo contactar con el soporte de DQE
Si el error persiste tras reconectar, indique el entorno de Salesforce, el ID de la organización, el proceso o job afectado, el mensaje de error exacto, el momento del fallo, y si se trata de algo puntual o recurrente.
Artículos relacionados
- Set up after a refresh or sandbox creation
- Complete the DQE One Installer Setup Wizard
- How to troubleshoot API authentication issues
- Why does the DQE One Installer stay stuck in Salesforce?
- Salesforce Permissions for DQE One
Relacionada con