メインコンテンツへスキップ
Microsoft Graph Mail API によるインポートを行うには、OAuth 2.0 によるサインイン、アプリケーションサーバー上のトークン管理サービス、および Microsoft へのネットワークアクセスが必要です。これらのいずれかに問題があると、サインイン時またはインポートの実行時にエラーが表示されます。 各コンピューターに必要なコンポーネントについては、Microsoft Graph インポートに必要なコンポーネントを参照してください。

サインイン時の Microsoft への接続の仕組み

FlexiCapture が ABBYY サーバーに接続するのは、初回の認可時の一度だけです。 Microsoft がユーザーを認可すると、ユーザーは https://go.abbyy.com/oauth2redirect にリダイレクトされます。このアドレスからさらに http://127.0.0.1:32023 にリダイレクトされます。OAuth 2.0 認可ウィザードは、この最終レスポンスを受信するためにポート 32023 で待機します。 その後、トークン管理サービスがトークンを FlexiCapture データベースに保存し、更新します。FlexiCapture は、ステーションがインストールされているマシンから Microsoft のリソースに直接リクエストを送信します。

「Connect to token endpoint failed」エラーの解決

Microsoft による認可は完了したものの、その後のサインインが Flow failed. Failure info/error: Connect to token endpoint failed エラーで失敗することがあります。このエラーは、末尾が Failed to connect to token endpoint となる長い ChilkatLog: RefreshAccessToken メッセージとして表示される場合もあります。

Microsoft のリソースのブロックを解除する

FlexiCapture は、次の両方のリソースにアクセスできる必要があります。
  • Microsoft ID プラットフォーム のトークンエンドポイント: https://login.microsoftonline.com/common/oauth2/v2.0/token
  • Microsoft Graph API: https://graph.microsoft.com
ファイアウォールでこれらがブロックされていないことを確認してください。以下のいずれかの操作を実行するマシンから、両方のリソースにアクセスできる必要があります。
  • プロジェクト設定ステーション で Microsoft Graph Mail API インポートプロファイルを作成または編集する
  • Scanning Station または プロジェクト設定ステーション で画像のインポートを手動で開始する (両方のステーションからアクセスできる必要があります)
  • 処理ステーション で Microsoft Graph Mail API Hot Folder から自動インポートを実行する

トークン管理サービスをデータベースに再接続する

トークン管理サービスは、アプリケーションサーバーをデータベースに接続した時点でデータベース接続を取得します。アップグレード後、この接続が失われることがあります。その場合、FlexiCapture はリフレッシュトークンを保存できず、サインインに失敗します。
1

インポートを停止する

プロジェクトでインポートを停止し、すべてのバッチの処理が完了するまで待ちます。
2

アプリケーションサーバーをデータベースに再接続する

管理および監視コンソールで Settings → Application Server をクリックし、Connect to Existing Database をクリックします。接続情報を入力して OK をクリックします。詳細については、既存のデータベースに接続するを参照してください。
3

接続文字列を確認する

アプリケーションサーバーのコンピューターで、C:\inetpub\wwwroot 配下にあるトークン管理サービスのフォルダー内の appsettings.json ファイルを開きます。Database セクションと DbDistributedLocks セクションの両方で、ConnectionString が空でないことを確認します。SQL Server が使用している証明書をアプリケーションサーバーのコンピューターが信頼していない場合は、両方の接続文字列に TrustServerCertificate=yes を追加します。
4

トークン管理サービスを再起動する

IIS マネージャーで Sites → FlexiCapture 12 Token Management を選択し、Restart をクリックします。
5

インポートプロファイルを再作成する

プロジェクト設定ステーションで、Microsoft Graph Mail API のインポートプロファイルをそれぞれ削除し、作成し直します。

サインイン時の「このサイトにアクセスできません」エラーを解決する

サインイン中に、ブラウザーで go.abbyy.com を開けず、This site can't be reached というメッセージが表示されることがあります。これは、サインインに使用しているコンピューターから ABBYY のリダイレクトページにアクセスできないことを示しています。この場合は、このページにアクセスできる別のコンピューターでサインインを完了してください。
1

認可リンクをコピーする

プロジェクト設定ステーションで Microsoft Graph Mail API インポートプロファイルのプロパティを開き、Sign in… をクリックします。ウィザードに表示される認可リンクをコピーします。
2

別のコンピューターでサインインする

go.abbyy.com にアクセスできるコンピューターで、コピーしたリンクをブラウザーに貼り付けます。Microsoft アカウントにサインインし、権限を付与します。このコンピューターに FlexiCapture のコンポーネントをインストールする必要はありません。
3

最終リダイレクトをプロジェクト設定ステーションに引き渡す

そのコンピューターで http://127.0.0.1:32023 への最終リダイレクトが失敗した場合は、ブラウザーのアドレスを丸ごとコピーします。次に、プロジェクト設定ステーションのコンピューター (ウィザードがレスポンスを待機している側) のブラウザーに、そのアドレスを貼り付けます。

OAuth シークレットの有効期限切れエラーを修正する

サインインまたはメールボックスのインポートが、エラー ERR_OAUTH_SECRET_EXPIRED で失敗します。これは、OAuth コンポーネント OAuthProviders.dll に含まれる認証情報の有効期限が切れているためです。このエラーは、Microsoft Graph Mail API、IMAP、SharePoint を含む、すべての Microsoft OAuth 2.0 接続に影響します。
1

FlexiCapture を更新する

FlexiCapture 12 Release 4 Update 9 以降をインストールしてください。このリリースでは、有効期限切れの認証情報は使用されません。詳細については、FlexiCapture 12 Release 4 Update 9 リリースノートを参照してください。
2

再度サインインする

Microsoft Graph Mail API または IMAP を使用する各インポートプロファイルで、再度サインインしてください。一度サインインすれば、以降はトークン管理サービスがトークンを自動的に更新します。
すぐに更新できない場合は、代わりに OAuthProviders.dll を置き換えてください。置き換えは、FlexiCapture 12 のコンポーネントがインストールされているすべてのコンピューターと、IIS 内のトークン管理サービスのフォルダーで行います。ファイルと手順については、Error: ERR_OAUTH_SECRET_EXPIRED - FlexiCapture 12 を参照してください。

リフレッシュトークンの有効期限切れエラーを解決する

以前は正常に動作していたインポートが、AADSTS700082: The refresh token has expired due to inactivity を含むエラーで停止します。 Microsoft は、90 日間使用されていないリフレッシュトークンを拒否します。この制限は変更できません。トークン管理サービスを使用しない場合、FlexiCapture は最初のサインイン時に取得したトークンを使い続けます。そのため、インポートを毎日実行していても、90 日が経過するとそのトークンは Microsoft に拒否されます。 このエラーを解決するには、インポートプロファイルのプロパティを開き、Sign in… をクリックして再度認可します。 エラーの再発を防ぐには、プロジェクトをアプリケーションサーバーに保存してください。トークン管理サービスによるトークンの更新対象は、FlexiCapture 12 リリース 4 Update 2 以降でアプリケーションサーバー上に保存されたプロジェクトに限られます。ローカルプロジェクトの場合は、少なくとも 90 日ごとに再度サインインしてください。

原因が示されないエラーのトラブルシューティング

エラーの中には、何が失敗したのかが示されないものがあります。たとえば、External component has thrown an exception は .NET の一般的なメッセージで、OAuth コンポーネントなどのネイティブコンポーネントがエラーで停止したことを意味します。
1

FlexiCapture のビルドを確認する

ビルドが Release 4 Update 9 より前の場合は、FlexiCapture を更新するか、OAuth コンポーネントを置き換えてください。詳細については、期限切れの OAuth シークレットエラーを修正するを参照してください。
2

トークン管理サービスを確認する

アプリケーションサーバーのコンピューターで IIS マネージャーを開き、FlexiCapture 12 Token Management サイトが開始されていることを確認します。データベース接続が失われている場合は、トークン管理サービスをデータベースに再接続するを参照してください。
3

ネットワークアクセスを確認する

エラーが発生しているコンピューターから Microsoft のリソースにアクセスできることを確認します。詳細については、Microsoft のリソースのブロックを解除するを参照してください。
4

再度サインインする

インポートプロファイルのプロパティを開き、Sign in… をクリックして OAuth 2.0 認可をやり直します。
5

エラーの詳細を収集する

エラーの全文と FlexiCapture のビルド番号を控えておきます。自動インポート中にエラーが発生する場合は、処理ステーションのログ記録も有効にしてから、エラーを再現してください。詳細については、処理ログ記録を参照してください。
問題が解決しない場合は、ABBYY サポートにお問い合わせください。その際は、エラーテキスト、ビルド番号、およびログファイルをお送りください。