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:

email

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

Please leave your feedback about this article

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.