サインイン時の 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 のビルド番号を控えておきます。自動インポート中にエラーが発生する場合は、処理ステーションのログ記録も有効にしてから、エラーを再現してください。詳細については、処理ログ記録を参照してください。
