OAuth認証について¶

メール通知の認証方法では、GoogleまたはMicrosoftのOAuth認証を利用することができます。
ここではOAuth認証で必要となるOAuthクライアントの設定について説明します。

免責事項¶

このページで説明している設定方法は他社が提供しているサービスのため、随時変更される可能性があります。サービス提供元が提供方法を変更した場合において、当社は責任を負いかねますので予めご了承ください。

当社はこのページで案内している設定方法に対して正確性を保証できません。設定方法に関する不明点は、サービス提供元にお問い合わせください。

このページに記載されていないことに関しても、サービス提供元が明言している制限や注意事項が適用されます。

注意事項¶

連携するサービスによって、送信できるメールの数や容量に制限がある場合があります。ご利用のサービスの制限事項をご確認ください。

メール送信のない期間が、Microsoftでは90日間、Googleでは6カ月を超えると、認可が無効になることがあります。無効になった場合、サインインボタンをクリックし再認可してください。

OAuthクライアントの設定¶

SMTPサーバーの認証方法にOAuth認証を選択した場合、事前にOAuthクライアントにてワークフローシステムを認可する必要があります。認可するには、あらかじめOAuthクライアントにアプリケーションを登録し、クライアントID等の項目を発行する必要があります。
ワークフローシステムでは、OAuthクライアントとして、GoogleとMicrosoftに対応しています。
以下、GoogleおよびMicrosoftにてクライアントID等を発行する手順を説明します。

Google

Microsoft

Google¶

GoogleにおけるOAuth認証の設定方法を説明します。

注意

Google Workspaceの管理者権限を持つアカウントでGoogle Cloud Platformにログインしてください。

Google Cloud Platformにログインします。
ヘッダーの[プロジェクトの選択]を選択します。
「プロジェクトの選択」ダイアログで、[新しいプロジェクト]を選択します。
「新しいプロジェクト」画面で、プロジェクトの情報を設定し、[作成]を選択します。
手順4で作成したプロジェクトを表示します。[APIとサービス]の[OAuth 同意画面]を選択します。
「OAuth 同意画面」画面で、User Typeを選択し、[作成]を選択します。
「アプリ登録の編集」画面で、OAuth同意画面に表示される情報を設定します。
アプリ名、ユーザーサポートメール、メールアドレスは必ず設定します。そのほかの項目は任意です。
「承認済みドメイン」の[ドメインの追加]をクリックして、ワークフローシステムサーバーのドメインを入力します。
設定内容を確認し、[保存して次へ]を選択します。
[保存して次へ]を選択します。
[APIとサービス]の[認証情報]を選択します。
「認証情報」画面で、[認証情報を作成]の[OAuth クライアント ID]を選択します。
「OAuth クライアント ID の作成」画面で、アプリケーションの種類を「ウェブアプリケーション」に設定し、「名前」を入力します。
「承認済みのリダイレクトURI」の[URIを追加]をクリックして、以下の「URI」を入力します。

https://[ドメイン名]:[ポート番号]/XFV20/config/system/mail/oauth_finish

注意

httpのURLは設定できません。ワークフローシステムにhttpsでアクセスができることが必須となります。
ドメインの末尾は、パブリックトップレベルドメイン（.com、.org など）であることが必須となります。

設定内容を確認し、[作成]を選択します。「OAuth クライアントを作成しました」ダイアログが表示され、「クライアント ID」と「クライアントシークレット」が発行されます。「クライアント ID」と「クライアントシークレット」は、OAuth認証の設定で必要です。メモ帳などのテキストエディターにコピーしてください。

Microsoft¶

MicrosoftにおけるOAuth認証の設定方法を説明します。

注意

Azure Active Directoryの管理者権限を持つアカウントでAzure Portalにログインしてください。

Azure Portalにログインします。
ナビゲーションメニューから「Azure Active Directory」を表示します。
ナビゲーションメニューから[アプリの登録]を選択します。
「アプリの登録」画面で、[新規登録]を選択します。
「アプリケーションの登録」画面で、アプリケーションの名前を入力します。名前は必ず設定します。
サポートされているアカウントの種類を選択します。

注意

「個人用 Microsoft アカウントのみ」は利用できません。

リダイレクト URIを入力します。

https://[IPアドレスまたはホスト名]:[ポート番号]/XFV20/config/system/mail/oauth_finish

注意

httpのURLは設定できません。ワークフローシステムにhttpsでアクセスができることが必須となります。

設定内容を確認し、[登録]を選択します。Azure portalに、アプリの概要が表示され、「アプリケーション (クライアント) ID」が発行されます。「アプリケーション (クライアント) ID」は、OAuth認証の設定で必要です。メモ帳などのテキストエディターにコピーしてください。
ナビゲーションメニューから[証明書とシークレット]を選択します。
「証明書とシークレット」画面で、「クライアントシークレット」の[新しいクライアントシークレット]を選択します。
「クライアントシークレットの追加」ダイアログで、クライアントシークレットの説明と有効期限を設定します。
設定内容を確認し、[追加]を選択します。「クライアントシークレット」が発行されます。「クライアントシークレット」は、OAuth認証の設定で必要です。クライアントシークレットの値の[クリップボードにコピー]をクリックし、メモ帳などのテキストエディターにコピーしてください。

注意

「証明書とシークレット」画面を再読込すると、作成したクライアントシークレットの値は二度と表示されません。値を控えられなかった場合は、新しいクライアントシークレットを作成してください。

ナビゲーションメニューから[概要]を選択します。
「概要」画面で　ディレクトリ (テナント) IDの[クリップボードにコピー]をクリックし、メモ帳などのテキストエディターにコピーしてください。「ディレクトリ (テナント) ID」は、OAuth認証の設定で必要です。