Microsoft Graph Mail APIによる画像のインポート
ABBYY FlexiCapture 12 では、Microsoft Graph Mail API を介して電子メールから文書画像を自動的にインポートし、処理することができます。そのためには、適切な画像インポートプロファイルを作成する必要があります。詳しくは、画像インポートプロファイルをご覧ください。
電子メールにアクセスするには、FlexiCapture 12 Graph Mail Importアプリケーションを使用します。 インポートプロファイルの設定を終了するには、Microsoftアカウントにログインし、アプリケーションに以下の許可を付与します:
- へのアクセスを与えたデータへのアクセスを維持します
- サインインしてプロファイルを読む
- メールを読む
- メールの読み取りと書き込みアクセス
- アクセスできるメールの読み書き
権限識別子:
Mail permissions: |
Mail.Read Mail.ReadWrite Mail.ReadWrite.Shared |
OpenID permissions: |
offline_access openid profile |
User permissions: | User.Read |
権限の詳細については、Microsoft の公式 Web サイト(<...>)にアクセスしてください。(https://docs.microsoft.com/ja-ja/graph/permissions-reference/).
注:電子メールインポートのアプリケーションを変更したり、そのアプリケーションに付与された許可を変更することはできません。
セキュリティ設定により、初回認証試行時に以下のいずれかが発生します:
- アクセス権が付与されます;
- アクセス権を付与するには、管理者の許可が必要になります(詳しくは公式のMicrosoftのWebサイトを参照してください)。
OAuth 2.0 認証
Microsoft Graph Mail API経由で画像インポートを設定するには、OAuth 2.0認証が必要です。認証処理の詳細については、公式のMicrosoftのWebサイトおよびOAuth 2.0 Frameworkの第4.1項を参照してください。
認証されると、ユーザーは自動的に https://go.abbyy.com/oauth2redirectに誘導され、さらに https://127.0.0.1にも誘導されます。認証に成功した場合、ユーザーは認証ウィザードのダイアログボックスに戻り、インポートプロファイルの設定を続けることができます。
注:認証の確認後、以下のメッセージが表示され、認証が拒否される場合があります:フローは失敗しました。失敗の情報/エラー:トークンエンドポイントへの接続に失敗しました(詳細は、「Microsoft Graph API connection error」をご覧ください)。
注:HTTPS プロトコルを利用するために、ユーザーは https://go.abbyy.com/oauth2redirect にリダイレクトされます(詳細はMicrosoft の公式サイトをご覧ください)。この手順は完全に安全です:データ収集は https://go.abbyy.com/oauth2redirectで無効になり、リダイレクト以外のアクションは行われません。
インポート時には、プライマリ更新トークンがセカンダリアクセストークンおよびリフレッシュトークンに置き換えられ、これらのトークンは、認証およびMicrosoft Graph Mail APIを介してユーザーの電子メールにアクセスするために使用されます。アクセス目的では、特定のユーザーまたは特定の電子メールに対してのみアクセスが提供されるため、管理者の許可は必要ありません。
注:デフォルトでは、更新トークンは最後に使用されてから90日後に失効します。その後、インポートプロファイルの再認証が必要になります。有効期限は、アクティブディレクトリの管理者が設定することができます。トークンの設定の詳細については、公式のMicrosoftのWebサイトを参照してください。
注:プロジェクト設定ステーションでインポートプロファイルを設定する場合、ステーションが開かれているコンピューターを使って電子メールとの接続を確立します。自動インポートタスクを行う場合は、処理ステーションマシンを使用します。
12.04.2024 18:16:25