Zum Hauptinhalt springen
Der Import über die Microsoft Graph Mail API setzt drei Dinge voraus: die Anmeldung über OAuth 2.0, den Token-Verwaltungsdienst auf dem Anwendungsserver und den Netzwerkzugriff auf Microsoft. Funktioniert eine dieser Voraussetzungen nicht, wird bei der Anmeldung oder beim Ausführen des Imports ein Fehler angezeigt. Welche Komponenten auf den einzelnen Computern benötigt werden, erfahren Sie unter Für den Microsoft-Graph-Import erforderliche Komponenten.

So stellt die Anmeldung die Verbindung zu Microsoft her

FlexiCapture kontaktiert die ABBYY-Server nur einmal – während der ersten Autorisierung. Nachdem Microsoft den Benutzer autorisiert hat, leitet es ihn zu https://go.abbyy.com/oauth2redirect weiter. Diese Adresse leitet ihn anschließend an http://127.0.0.1:32023 weiter. Der OAuth 2.0-Autorisierungsassistent lauscht an Port 32023 auf diese endgültige Antwort. Anschließend speichert der Token-Verwaltungsdienst die Tokens in der FlexiCapture-Datenbank und aktualisiert sie. FlexiCapture sendet seine Anfragen direkt von dem Computer, auf dem die Station installiert ist, an die Microsoft-Ressourcen.

Den Fehler „Connect to token endpoint failed“ beheben

Mitunter bestätigt Microsoft die Autorisierung, die Anmeldung schlägt anschließend jedoch mit dem Fehler Flow failed. Failure info/error: Connect to token endpoint failed fehl. Der Fehler kann auch als längere ChilkatLog: RefreshAccessToken-Meldung erscheinen, die mit Failed to connect to token endpoint endet.

Microsoft-Ressourcen freigeben

FlexiCapture muss diese beiden Ressourcen erreichen können:
  • Den Token-Endpunkt der Microsoft-Identitätsplattform, https://login.microsoftonline.com/common/oauth2/v2.0/token
  • Die Microsoft Graph API, https://graph.microsoft.com
Stellen Sie sicher, dass Ihre Firewall diese nicht blockiert. Beide Ressourcen müssen von dem Computer erreichbar sein, auf dem einer der folgenden Vorgänge ausgeführt wird:
  • Erstellen oder Bearbeiten eines Microsoft Graph Mail API-Importprofils auf der Projekteinrichtungsstation
  • Manuelles Starten des Bildimports auf der Scanning Station oder der Projekteinrichtungsstation, wofür der Zugriff von beiden Stationen erforderlich ist
  • Ausführen des automatischen Imports aus dem Microsoft Graph Mail API Hot Folder auf der Processing Station

Token-Verwaltungsdienst erneut mit der Datenbank verbinden

Der Token-Verwaltungsdienst erhält seine Datenbankverbindung, wenn Sie den Anwendungsserver mit einer Datenbank verbinden. Nach einem Upgrade kann diese Verbindung fehlen. FlexiCapture kann das Refresh-Token dann nicht speichern, und die Anmeldung schlägt fehl.
1

Import stoppen

Stoppen Sie den Import im Projekt und warten Sie, bis alle Batches vollständig verarbeitet wurden.
2

Anwendungsserver erneut mit der Datenbank verbinden

Klicken Sie in der Administrations- und Überwachungskonsole auf Settings → Anwendungsserver und anschließend auf Connect to Existing Database. Geben Sie die Verbindungsdaten ein und klicken Sie auf OK. Weitere Informationen finden Sie unter Verbindung mit einer bestehenden Datenbank herstellen.
3

Verbindungszeichenfolgen prüfen

Öffnen Sie auf dem Anwendungsserver-Computer die Datei appsettings.json im Ordner des Token-Verwaltungsdienstes unter C:\inetpub\wwwroot. Vergewissern Sie sich, dass ConnectionString sowohl im Abschnitt Database als auch im Abschnitt DbDistributedLocks nicht leer ist.Wenn SQL Server ein Zertifikat verwendet, dem der Anwendungsserver-Computer nicht vertraut, fügen Sie beiden Verbindungszeichenfolgen TrustServerCertificate=yes hinzu.
4

Token-Verwaltungsdienst neu starten

Wählen Sie im IIS-Manager Sites → FlexiCapture 12 Token Management aus und klicken Sie auf Restart.
5

Importprofile neu erstellen

Löschen Sie in der Projekteinrichtungsstation jedes Microsoft Graph Mail API-Importprofil und erstellen Sie es anschließend neu.

Fehler „Website nicht erreichbar“ bei der Anmeldung beheben

Bei der Anmeldung kann es vorkommen, dass der Browser go.abbyy.com nicht öffnen kann und die Meldung This site can't be reached anzeigt. Das bedeutet, dass der Computer, auf dem Sie sich anmelden, die ABBYY-Umleitungsseite nicht erreicht. Schließen Sie die Anmeldung in diesem Fall auf einem anderen Computer ab, der die Seite erreichen kann.
1

Autorisierungslink kopieren

Öffnen Sie in der Projekteinrichtungsstation die Eigenschaften des Importprofils für die Microsoft Graph Mail API und klicken Sie auf Anmelden…. Kopieren Sie den Autorisierungslink, den der Assistent anzeigt.
2

Auf einem anderen Computer anmelden

Fügen Sie den Link auf einem Computer, der go.abbyy.com erreichen kann, in einen Browser ein. Melden Sie sich bei Ihrem Microsoft-Konto an und erteilen Sie die erforderlichen Berechtigungen. Auf diesem Computer müssen keine FlexiCapture-Komponenten installiert sein.
3

Abschließende Umleitung an die Projekteinrichtungsstation übergeben

Schlägt die abschließende Umleitung zu http://127.0.0.1:32023 auf diesem Computer fehl, kopieren Sie die vollständige Adresse aus dem Browser. Fügen Sie sie auf dem Computer mit der Projekteinrichtungsstation, auf dem der Assistent auf die Antwort wartet, in einen Browser ein.

Fehler wegen abgelaufenen OAuth-Geheimnisses beheben

Die Anmeldung oder der Postfachimport schlägt mit dem Fehler ERR_OAUTH_SECRET_EXPIRED fehl. Die OAuth-Komponente OAuthProviders.dll enthält Zugangsdaten, die abgelaufen sind. Der Fehler betrifft alle Microsoft-OAuth-2.0-Verbindungen, darunter Microsoft Graph Mail API, IMAP und SharePoint.
1

FlexiCapture aktualisieren

Installieren Sie FlexiCapture 12 Release 4 Update 9 oder höher. Dieses Release verwendet die abgelaufenen Zugangsdaten nicht mehr. Weitere Informationen finden Sie unter Versionshinweise zu FlexiCapture 12 Release 4 Update 9.
2

Erneut anmelden

Melden Sie sich in jedem Importprofil, das die Microsoft Graph Mail API oder IMAP verwendet, erneut an. Nach dieser einmaligen Anmeldung kann der Token-Verwaltungsdienst die Tokens ab sofort selbst aktualisieren.
Wenn Sie noch nicht aktualisieren können, ersetzen Sie stattdessen die Datei OAuthProviders.dll. Ersetzen Sie sie auf jedem Computer, auf dem eine FlexiCapture-12-Komponente installiert ist, sowie im Ordner des Token-Verwaltungsdienstes im IIS. Die Datei und die einzelnen Schritte finden Sie unter Error: ERR_OAUTH_SECRET_EXPIRED - FlexiCapture 12.

Fehler „Refresh-Token abgelaufen“ beheben

Ein Import, der bisher funktioniert hat, bricht mit einem Fehler ab, der AADSTS700082: The refresh token has expired due to inactivity enthält. Microsoft lehnt ein Refresh-Token ab, wenn es 90 Tage lang nicht verwendet wurde. Diese Frist lässt sich nicht ändern. Ohne den Token-Verwaltungsdienst verwendet FlexiCapture weiterhin das Token aus der ersten Anmeldung. Microsoft lehnt dieses Token daher nach 90 Tagen ab, selbst wenn der Import täglich ausgeführt wird. Um den Fehler zu beheben, öffnen Sie die Properties des Importprofils und klicken Sie auf Anmelden…, um die Autorisierung erneut durchzuführen. Damit der Fehler nicht wieder auftritt, speichern Sie das Projekt auf dem Anwendungsserver. Der Token-Verwaltungsdienst aktualisiert Tokens ab FlexiCapture 12 Release 4 Update 2 und nur für Projekte auf dem Anwendungsserver. Bei einem lokalen Projekt müssen Sie sich mindestens alle 90 Tage erneut anmelden.

Fehler ohne Angabe einer Ursache beheben

Manche Fehlermeldungen geben nicht an, was fehlgeschlagen ist. So ist beispielsweise External component has thrown an exception eine allgemeine .NET-Meldung. Sie bedeutet, dass eine native Komponente, etwa die OAuth-Komponente, mit einem Fehler abgebrochen wurde.
1

FlexiCapture-Build prüfen

Wenn Ihr Build älter als Release 4 Update 9 ist, aktualisieren Sie FlexiCapture oder ersetzen Sie die OAuth-Komponente. Weitere Informationen finden Sie unter Fehler wegen abgelaufenem OAuth-Geheimnis beheben.
2

Token-Verwaltungsdienst prüfen

Öffnen Sie auf dem Computer mit dem Anwendungsserver den IIS-Manager. Stellen Sie sicher, dass die Site FlexiCapture 12 Token Management gestartet ist. Falls die Datenbankverbindung fehlt, lesen Sie Token-Verwaltungsdienst erneut mit der Datenbank verbinden.
3

Netzwerkzugriff prüfen

Stellen Sie sicher, dass der Computer, auf dem der Fehler auftritt, die Microsoft-Ressourcen erreichen kann. Weitere Informationen finden Sie unter Microsoft-Ressourcen freigeben.
4

Erneut anmelden

Öffnen Sie die Eigenschaften des Importprofils und klicken Sie auf Anmelden…, um die OAuth 2.0-Autorisierung erneut durchzuführen.
5

Fehlerdetails sammeln

Notieren Sie den vollständigen Fehlertext und die Build-Nummer Ihrer FlexiCapture-Installation. Wenn der Fehler beim automatischen Import auftritt, aktivieren Sie zusätzlich die Protokollierung der Processing Station und reproduzieren Sie den Fehler. Weitere Informationen finden Sie unter Verarbeitungsprotokollierung.
Wenn Sie keine Antwort auf Ihre Frage finden, wenden Sie sich an den ABBYY Support. Geben Sie dabei den Fehlertext und die Build-Nummer an und fügen Sie alle vorhandenen Protokolldateien bei.