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 vershttps://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’erreurFlow 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
- 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.Arrêter l’importation
Reconnecter le serveur d’applications à la base de données
Vérifier les chaînes de connexion
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.Redémarrer le Service de gestion des jetons
Recréer les profils d’importation
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 à ouvrirgo.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.
Copier le lien d’autorisation
Se connecter depuis un autre ordinateur
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.Transmettre la redirection finale à la Project Setup Station
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’erreurERR_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.
Mettre à jour FlexiCapture
Se reconnecter
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 contenantAADSTS700082: 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.
Vérifier votre build FlexiCapture
Vérifier le Service de gestion des jetons
Vérifier l’accès réseau
Se reconnecter
Recueillir les détails de l’erreur
