3. プロジェクトが作成されたことを知らせる通知が表示されるまで待ちます。
2. 画面左側のメニューで、**APIs & Services > OAuth consent screen** を選択します。
3. **External** ユーザータイプを選択し、**Create** をクリックします。
4. アプリケーション名を指定します。**User support email** ドロップダウンリスト field で、Gmail アドレスを選択します。
5. ページ下部の **Developer contact information** セクションで開発者のメールアドレスを指定し、**Save and continue** をクリックします。
6. **Add or remove scopes** をクリックします。すると、右側に **Update selected scopes** ダイアログが開きます。
7. ダイアログ下部の **Manually add scopes** field に次のテキストをコピー＆ペーストし、**Add to table** をクリックします。
```
openid https://www.googleapis.com/auth2/userinfo.email https://www.googleapis.com/auth2/userinfo.profile https://mail.google.com/
```
9. 画面下部の **Save and continue** をクリックします。
10. **Save and continue** をクリックして **Test users** ページの設定をスキップし、**Summary** ページに移動します。
概要ページには、設定されたアプリケーション、メールアドレス、権限に関する情報が表示されます。
3. 種類として **ウェブ アプリケーション** を選択します。
4. **承認済みのリダイレクト URI** セクションで、**+ URI を追加** を選択します。
5. 表示された field に、リダイレクト URI を指定します。
```
https://
6. **Create** をクリックします。
表示されるポップアップダイアログには、**Client ID** と **クライアントシークレット** の値が表示されます。
このデータは、Vantage で tokenmanagement サービス を設定するために必須です。すぐに保存することも、後で **APIs & Services > Credentials** に移動し、作成した OAuth 2.0 クライアント識別子を選択してコピーすることもできます。
### 公開と検証
アプリケーションの公開ステータスは、**APIs & Services > OAuth consent screen** セクションに表示されます。
**Testing** ステータスのアプリケーションは、テスター一覧に追加されたユーザーのみが利用できます。アプリケーションを公開すると、Google アカウントを持つすべてのユーザーが利用可能になります。
**Publish app** をクリックします。`https://mail.google.com/` スコープでは、アプリケーションが機密性の高いユーザーデータにアクセスできるため、アプリケーションの検証が必要であることを示すメッセージが表示されます。
アプリケーションを検証するには、次の情報を提出する必要があります。
* アプリケーションのプライバシーポリシーへの公式リンク
* アプリケーションを使用して Google ユーザーデータを取得する目的を示す YouTube 動画
* 機密性の高いユーザーデータへのアクセスが必要な理由の説明を含む、Google 宛てのテキスト
* Google Search Console で検証済みのすべてのドメインの完全な一覧
**Confirm** をクリックします。アプリケーションのステータスが **In Production** に変わります。
また、**Prepare for verification** ボタンも表示され、必要な検証データをすべて入力できるようになります。
## Microsoft Azure でのアプリケーションの登録
アプリケーションを作成するには、アプリケーション登録と編集の権限を持つ Azure Active Directory テナントが必要です。
**Portal settings | Directories + subscriptions** ページで、正しいディレクトリに切り替えることができます。
### アプリケーションの登録
1. **App registrations** ページに移動します。
2. **New registration** をクリックします。
3. アプリケーションの名前を指定し、サポートされているアカウントの種類を選択します。
5. **Register** をクリックします。
### アプリケーションの権限を設定する
1. **API permissions** タブに移動します。
2. **Add permission** をクリックします。
3. 開いたダイアログで、**Microsoft Graph** セクションを選択します。
4. **Delegated permissions** を選択します。
5. 次の権限を追加します。
* `email`
* `IMAP.AccessAsUser.All`
* `offline_access`
* `openid`
* `profile`
6. **Add permissions** をクリックします。ダイアログが閉じ、選択した権限が表示されます。
### クライアントシークレットの作成
1. **Authentication** タブに移動します。
2. **Implicit grant and hybrid flows** セクションで、**ID tokens (used for implicit and hybrid flows)** をオンにします。
3. 画面上部の **Save** をクリックします。
4. **Certificates & secrets** タブに移動し、**New client secret** をクリックします。
5. 開いたダイアログで、クライアントシークレットの名前と有効期限を指定します。
また、クライアント識別子も必要です。これは、**Overview** タブの **Application (client) ID** フィールドからコピーできます。識別子の値にマウスカーソルを合わせると、コピー アイコンが表示されます。
### アプリケーションの検証
任意の Azure AD テナントのユーザーがこのアプリケーションを利用できるようにするには、検証が必要です。1 つの Azure AD テナントのアカウントのみを使用する場合は、検証は不要です。
検証を受けられるのは、Microsoft Partner Network の参加者のみです。
1. **Branding & properties** タブに移動します。
2. **Publisher domain** field にドメインが指定されていることを確認します。必要に応じて、**Configure a domain** をクリックしてドメインを設定します。
## Consul への認証情報の設定
Vantage がすでにインストールされている場合は、Microsoft および/または Google のメールサービスの認証用に生成された認証情報を手動で入力するため、Consul を使用する必要があります。
OAuth 2.0 プロトコルに固有の機能については、TokenManagement サービスに記載されています。
3. **tokenmanagement** サービスを選択します。
4. **oAuthClientConfiguration** セクションに移動します。
5. ユーザーデータを指定するサービス (**google** または **microsoft**) を選択します。
6. **clientId** キーを選択します。
7. 先ほど保存した Client ID の値を入力フィールドにコピー＆ペーストし、**Save** をクリックします。
8. **clientSecret** キーについても、手順 6 と 7 を繰り返します。
必要に応じて、別のメールサービスに対して手順 5 ～ 8 を繰り返します。
9. 次のコマンドを実行して、**tokenmanagement** サービスを再起動します。
```bash theme={null}
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
```
## クライアントシークレットの更新
クライアントシークレットの値は、サーバー側でクライアントを識別するために使用されるもので、秘密情報に当たります。セキュリティ上の理由から、この情報は定期的に更新する必要があります。Azure Active Directory など、一部のサービスでは、この種の情報の有効期間が制限されています。
新しいクライアントシークレットを作成したら、対応する Consul キーの値も更新する必要があります。
### Google でクライアントシークレットを更新する
1. Google Cloud Console に移動し、該当するプロジェクトを選択します。
2. 左側のメニューで、**APIs & Services > Credentials** を選択します。
3. **OAuth 2.0 Client IDs** セクションで、IMAP サーバーへの接続時の認証に使用する識別子を選択します。
4. **Reset secret** をクリックします。
5. ポップアップダイアログで **Reset** をクリックします。これにより、クライアントシークレットの値が更新され、以前の値が呼び出されます。
6. 認証情報を含む JSON ファイルをダウンロードします。 または、画面右側からクライアントシークレットの値をコピーします。
### Microsoft Azure でのクライアントシークレットの更新
1. **App registrations** ページに移動し、IMAP サーバーでの認証に使用しているアプリケーションを選択します。
2. **Certificates & secrets** タブに移動し、**New client secret** をクリックします。
3. 表示されたダイアログで、クライアントシークレットの名前と有効期限を指定します。
4. **Add** をクリックします。ダイアログが閉じ、新しいクライアントシークレットの情報が表示されます。ページを閉じると **Value** には再度アクセスできなくなるため、必ずコピーして保存しておいてください。
5. 現在のクライアントシークレットがまだ有効期限切れでない場合は、削除することで、クライアントの識別には新しいクライアントシークレットのみを使用できるようになります。
### Consul でクライアントシークレットを更新する
[認証情報を Consul に渡す](#passing-credentials-to-consul)に記載された手順に従ってください。ただし、手順 6 と 7 (clientId 値のコピー) は省略します。