Passer au contenu principal
L’importation via l’API Microsoft Graph Mail repose sur la connexion OAuth 2.0, sur le Service de gestion des jetons du serveur d’applications et sur l’accès réseau à Microsoft. Si l’un de ces éléments fait défaut, une erreur s’affiche lors de la connexion ou pendant l’importation. Pour connaître les composants requis sur chaque ordinateur, voir Composants requis pour l’importation Microsoft Graph.

Fonctionnement de la connexion à Microsoft

FlexiCapture contacte les serveurs ABBYY une seule fois, lors de la première autorisation. Après avoir autorisé l’utilisateur, Microsoft le redirige vers https://go.abbyy.com/oauth2redirect. Cette adresse le redirige à son tour vers http://127.0.0.1:32023. L’assistant d’autorisation OAuth 2.0 écoute la réponse finale sur le port 32023. Le Service de gestion des jetons stocke ensuite les jetons dans la base de données FlexiCapture et se charge de les actualiser. FlexiCapture envoie ses requêtes directement aux ressources Microsoft depuis la machine sur laquelle le poste est installé.

Corriger l’erreur Connect to token endpoint failed

Il arrive que Microsoft confirme l’autorisation, mais que la connexion échoue ensuite avec l’erreur Flow failed. Failure info/error: Connect to token endpoint failed. L’erreur peut également se présenter sous la forme d’un message ChilkatLog: RefreshAccessToken plus long, qui se termine par Failed to connect to token endpoint.

Débloquez les ressources Microsoft

FlexiCapture doit pouvoir accéder à ces deux ressources :
  • Le point de terminaison des jetons de la plateforme d’identité Microsoft, https://login.microsoftonline.com/common/oauth2/v2.0/token
  • L’API Microsoft Graph, https://graph.microsoft.com
Vérifiez que votre pare-feu ne les bloque pas. Ces deux ressources doivent être accessibles depuis la machine qui effectue l’une des opérations suivantes :
  • Création ou modification d’un profil d’importation API Microsoft Graph Mail dans Project Setup Station
  • Démarrage manuel de l’importation d’images dans Scanning Station ou Project Setup Station, ce qui nécessite un accès depuis les deux stations
  • Exécution de l’importation automatique à partir du Hot Folder API Microsoft Graph Mail dans Processing Station

Reconnecter le Service de gestion des jetons à la base de données

Le Service de gestion des jetons obtient sa connexion à la base de données lorsque vous connectez le serveur d’applications à une base de données. Après une mise à niveau, cette connexion peut être manquante. FlexiCapture ne peut alors pas stocker le jeton de renouvellement, et l’authentification échoue.
1

Arrêter l’importation

Arrêtez l’importation dans le projet et attendez la fin du traitement de tous les lots.
2

Reconnecter le serveur d’applications à la base de données

Dans la Console d’Administration et de Surveillance, cliquez sur Settings → Application Server, puis sur Connect to Existing Database. Saisissez les informations de connexion et cliquez sur OK. Pour plus d’informations, consultez Se connecter à une base de données existante.
3

Vérifier les chaînes de connexion

Sur l’ordinateur du serveur d’applications, ouvrez le fichier appsettings.json situé dans le dossier du Service de gestion des jetons, sous C:\inetpub\wwwroot. Dans les sections Database et DbDistributedLocks, vérifiez que ConnectionString n’est pas vide.Si SQL Server utilise un certificat que l’ordinateur du serveur d’applications ne considère pas comme fiable, ajoutez TrustServerCertificate=yes aux deux chaînes de connexion.
4

Redémarrer le Service de gestion des jetons

Dans le Gestionnaire des services Internet (IIS), sélectionnez Sites → FlexiCapture 12 Token Management, puis cliquez sur Restart.
5

Recréer les profils d’importation

Dans la Project Setup Station, supprimez chaque profil d’importation API Microsoft Graph Mail, puis recréez-le.

Résoudre l’erreur « Ce site est inaccessible » lors de la connexion

Lors de la connexion, il peut arriver que le navigateur ne parvienne pas à ouvrir go.abbyy.com et affiche le message This site can't be reached. Cela signifie que l’ordinateur sur lequel vous vous connectez ne peut pas accéder à la page de redirection ABBYY. Dans ce cas, effectuez la connexion depuis un autre ordinateur qui y a accès.
1

Copier le lien d’autorisation

Dans la Project Setup Station, ouvrez les propriétés du profil d’importation API Microsoft Graph Mail et cliquez sur Se connecter…. Copiez le lien d’autorisation affiché par l’assistant.
2

Se connecter depuis un autre ordinateur

Sur un ordinateur ayant accès à go.abbyy.com, collez le lien dans un navigateur. Connectez-vous à votre compte Microsoft et accordez les autorisations demandées. Aucun composant FlexiCapture n’a besoin d’être installé sur cet ordinateur.
3

Transmettre la redirection finale à la Project Setup Station

Si la redirection finale vers http://127.0.0.1:32023 échoue sur cet ordinateur, copiez l’adresse complète affichée dans le navigateur. Collez-la dans un navigateur de l’ordinateur hébergeant la Project Setup Station, où l’assistant attend la réponse.

Corriger l’erreur de secret OAuth expiré

La connexion ou l’importation depuis une boîte aux lettres échoue avec l’erreur ERR_OAUTH_SECRET_EXPIRED. Le composant OAuth, OAuthProviders.dll, contient une information d’authentification qui a expiré. Cette erreur affecte toutes les connexions Microsoft OAuth 2.0, notamment l’API Microsoft Graph Mail, IMAP et SharePoint.
1

Mettre à jour FlexiCapture

Installez FlexiCapture 12 Version 4 Update 9 ou une version ultérieure. Cette version n’utilise plus l’information d’authentification expirée. Pour plus d’informations, consultez les notes de version de FlexiCapture 12 Version 4 Update 9.
2

Se reconnecter

Reconnectez-vous dans chaque profil d’importation qui utilise l’API Microsoft Graph Mail ou IMAP. Une fois cette connexion effectuée, le Service de gestion des jetons pourra actualiser automatiquement les jetons par la suite.
Si vous ne pouvez pas encore effectuer la mise à jour, remplacez plutôt le fichier OAuthProviders.dll. Remplacez-le sur chaque ordinateur où un composant FlexiCapture 12 est installé, ainsi que dans le dossier du Service de gestion des jetons dans IIS. Pour obtenir le fichier et la procédure à suivre, consultez Error: ERR_OAUTH_SECRET_EXPIRED - FlexiCapture 12.

Corriger l’erreur d’expiration du jeton de renouvellement

Une importation qui fonctionnait jusque-là s’interrompt avec une erreur contenant AADSTS700082: The refresh token has expired due to inactivity. Microsoft rejette tout jeton de renouvellement inutilisé pendant 90 jours, et cette limite n’est pas modifiable. Sans le Service de gestion des jetons, FlexiCapture continue d’utiliser le jeton obtenu lors de la première connexion. Microsoft finit donc par rejeter ce jeton au bout de 90 jours, même si l’importation s’exécute quotidiennement. Pour corriger l’erreur, ouvrez les propriétés du profil d’importation et cliquez sur Se connecter… pour autoriser de nouveau l’accès. Pour éviter que l’erreur ne se reproduise, stockez le projet sur le serveur d’applications. Le Service de gestion des jetons ne renouvelle les jetons que pour les projets stockés sur le serveur d’applications, à partir de FlexiCapture 12 Version 4 Update 2. Pour un projet local, reconnectez-vous au moins tous les 90 jours.

Résoudre les erreurs qui n’indiquent pas de cause

Certaines erreurs ne précisent pas ce qui a échoué. Par exemple, External component has thrown an exception est un message .NET générique. Il signifie qu’un composant natif, tel que le composant OAuth, s’est arrêté sur une erreur.
1

Vérifier votre build FlexiCapture

Si votre build est antérieur à la Version 4 Update 9, mettez à jour FlexiCapture ou remplacez le composant OAuth. Pour plus d’informations, consultez Corriger l’erreur de secret OAuth expiré.
2

Vérifier le Service de gestion des jetons

Sur l’ordinateur du serveur d’applications, ouvrez le Gestionnaire des services Internet (IIS). Vérifiez que le site FlexiCapture 12 Token Management est démarré. Si sa connexion à la base de données est absente, consultez Reconnecter le Service de gestion des jetons à la base de données.
3

Vérifier l’accès réseau

Vérifiez que l’ordinateur sur lequel l’erreur se produit peut accéder aux ressources Microsoft. Pour plus d’informations, consultez Débloquer les ressources Microsoft.
4

Se reconnecter

Ouvrez les propriétés du profil d’importation et cliquez sur Se connecter… pour renouveler l’autorisation OAuth 2.0.
5

Recueillir les détails de l’erreur

Notez le texte complet de l’erreur et le numéro de build de FlexiCapture. Si l’erreur se produit lors de l’importation automatique, activez également la journalisation de la station de traitement, puis reproduisez l’erreur. Pour plus d’informations, consultez Journalisation du traitement.
Si vous ne trouvez pas la réponse à votre question, contactez le support technique d’ABBYY. Joignez le texte de l’erreur, le numéro de build et, le cas échéant, les fichiers journaux.