DQE One se connecte à votre org Salesforce via une autorisation dédiée (l'application DQE One Installer, appelée External Client App dans les orgs Salesforce récentes) créée lors de l'installation. À chaque lancement d'un traitement — un job planifié, une fusion manuelle, une action de Data Stewardship, ou un mapping — DQE One utilise un refresh token stocké dans sa configuration pour obtenir un access token de courte durée avant d'appeler le service DQE. Si ce refresh token n'est plus valide, le traitement échoue immédiatement avec une erreur « Expired access/refresh token », même si rien n'a changé dans la configuration du traitement lui-même.
Symptômes courants
- un traitement qui fonctionnait auparavant échoue désormais dès son lancement ;
- le message d'erreur contient « expired access/refresh token » ou « invalid_grant » ;
- l'échec n'est pas lié à une modification récente du traitement, du mapping ou du rule set ;
- les jobs planifiés, les fusions manuelles, les actions de Data Stewardship et les appels temps réel peuvent tous être affectés, car ils partagent la même connexion ;
- le problème peut réapparaître après un certain temps, même s'il avait été résolu auparavant.
Pourquoi cela se produit
Le refresh token utilisé par DQE One est lié à l'autorisation accordée à l'application DQE One Installer lors de la configuration. Salesforce invalide ce refresh token indépendamment de DQE One dans l'un des cas suivants, côté org :
- la politique OAuth de l'application connectée impose une durée de vie au refresh token (par exemple « expire après une durée définie ») et cette durée est écoulée ;
- le token a été explicitement révoqué — par exemple depuis Setup > Connected Apps OAuth Usage, ou dans le cadre d'une revue de sécurité ;
- l'utilisateur Salesforce ayant initialement autorisé la connexion a été désactivé, gelé, ou a perdu la permission API Enabled ;
- la politique OAuth de l'application connectée fait tourner le refresh token à chaque utilisation (Rotate Refresh Token) — DQE One ne stocke qu'une seule valeur de refresh token et ne la met à jour que lors d'une installation/réinstallation ; si cette rotation est activée sur votre org, la valeur stockée peut devenir obsolète entre deux passages dans l'installeur.
Dans tous ces cas, reconnecter DQE One via son Setup — comme décrit ci-dessous — génère un nouveau refresh token et résout l'erreur.
Solution : reconnecter DQE One
- Allez dans le Setup DQE One.
- Désinstallez la configuration existante.
- Relancez l'installation en cliquant sur Start Installation.
- Renseignez le champ de licence.
- Renseignez l'URL du backend uniquement si vous utilisez votre propre serveur DQE auto-hébergé — laissez-la vide sinon.
- Sélectionnez les produits associés à votre contrat.
- Si l'installation échoue à cause des identifiants précédents, cliquez sur Exit sur la page d'échec (pas Retry), pour qu'elle désinstalle les identifiants précédents au lieu de les réutiliser.
- Relancez l'installation avec les mêmes champs (licence, URL du backend, produits).
- L'installation devrait se terminer avec succès.
- Si vous utilisez le module temps réel, allez dans Named Credentials, modifiez le named credential DQE One Tooling API, puis enregistrez-le.
Comment éviter que cela se reproduise
- Dans le Setup Salesforce, ouvrez l'application connectée / external client app DQE One Installer et vérifiez ses politiques OAuth : la politique de durée de vie du refresh token, et si Rotate Refresh Token est activé. Si la politique de sécurité de votre org impose la rotation, DQE One devra être reconnecté à chaque fois qu'elle s'applique.
- Évitez de désactiver, geler, ou retirer la permission API Enabled de l'utilisateur ayant autorisé la connexion DQE One sans reconnecter DQE One avec un autre utilisateur au préalable.
- Vérifiez Setup > Connected Apps OAuth Usage avant de révoquer les tokens de l'application DQE One Installer, car cela casse immédiatement tous les traitements DQE One.
Quand contacter le support DQE
Si l'erreur persiste après reconnexion, fournissez l'environnement Salesforce, l'ID de l'organisation, le traitement ou le job concerné, le message d'erreur exact, l'horodatage de l'échec, et si le problème est ponctuel ou récurrent.
Articles liés
- 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
Associé à