3. プロジェクトが作成されたことを示す通知が表示されるまで待ちます。
2. 画面左側のメニューで **APIs & Services > OAuth consent screen** を選択します。
3. **External** ユーザータイプを選択し、**Create** をクリックします。
4. アプリケーション名を指定します。**User support email** のドロップダウンリストで、自分の Gmail アドレスを選択します。
5. ページ下部の **Developer contact information** セクションで開発者のメールアドレスを指定し、**Save and continue** をクリックします。
6. **Add or remove scopes** をクリックします。右側に **Update selected scopes** ダイアログが開きます。
7. 次のテキストをコピーして、ダイアログ下部の **Manually add scopes** フィールドに貼り付け、**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. **Test users** ページの設定をスキップして **Summary** ページに進むために、再度 **Save and continue** をクリックします。
Summary ページでは、アプリケーション、メールアドレス、および設定された権限に関する情報が表示されます。
3. **Web application** タイプを選択します。
4. **Authorized redirect URIs** セクションで **+ Add URI** をクリックします。
5. 表示されるフィールドに、リダイレクト URI を指定します。
```
https://
6. **Create** をクリックします。
表示されるポップアップダイアログボックスに、**Client ID** と **Client secret** の値が表示されます。
このデータは、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 テナントのユーザーが利用できるようにするには、検証が必要です。単一の Azure AD テナントのアカウントのみを使用する場合は、検証は不要です。
Microsoft Partner Network の参加者のみが検証を受けることができます。
1. **Branding & properties** タブを開きます。
2. **Publisher domain** フィールドにドメインが指定されていることを確認します。必要に応じて、**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 サーバーへの接続時の認証に使用しているクライアント ID を選択します。
4. **Reset secret** をクリックします。
5. ポップアップダイアログボックスで **Reset** をクリックします。これにより Client secret の値が更新され、以前の値が失効します。
6. 認証情報を含む JSON ファイルをダウンロードします。あるいは、画面右側に表示されている Client secret の値をコピーします。
### Microsoft Azure でクライアント シークレットを更新する
1. **App registrations** ページを開き、IMAP サーバーによる認証に使用するアプリケーションを選択します。
2. **Certificates & secrets** タブを開き、**New client secret** をクリックします。
3. 表示されるダイアログ ボックスで、クライアント シークレットの名前と有効期限を指定します。
4. **Add** をクリックします。ダイアログが閉じられ、新しいクライアント シークレットに関する情報が表示されます。ページを閉じると再度参照できなくなるため、**Value** は必ずコピーして保存しておいてください。
5. 現在のクライアント シークレットの有効期限がまだ切れていない場合は、それを削除して、新しいクライアント シークレットだけでクライアントを識別できるようにすることができます。
### Consul でクライアントシークレットを更新する
[Passing Credentials to Consul](#passing-credentials-to-consul) に記載されている手順に従います。ただし、手順 6 と 7（`clientId` 値のコピー）は実行しないでください。