3. Attendez la notification indiquant que votre projet a été créé.
2. Dans le menu situé à gauche de l’écran, sélectionnez **APIs & Services > OAuth consent screen**.
3. Sélectionnez le type d’utilisateur **External**, puis cliquez sur **Create**.
4. Indiquez un nom pour votre application. Dans le champ de liste déroulante **User support email**, sélectionnez votre adresse Gmail.
5. Indiquez l’adresse e-mail du développeur dans la section **Developer contact information** au bas de la page, puis cliquez sur **Save and continue**.
6. Cliquez sur **Add or remove scopes**. La boîte de dialogue **Update selected scopes** s’ouvre alors sur la droite.
7. Copiez-collez le texte suivant dans le champ **Manually add scopes** au bas de la boîte de dialogue, puis cliquez sur **Add to table** :
```
openid https://www.googleapis.com/auth2/userinfo.email https://www.googleapis.com/auth2/userinfo.profile https://mail.google.com/
```
9. Cliquez sur **Save and continue** en bas de l’écran.
10. Cliquez sur **Save and continue** pour ignorer les paramètres de la page **Test users** et accéder à la page **Résumé**.
Sur la page **Résumé**, vous verrez des informations sur l’application, les adresses e-mail et les autorisations configurées.
3. Sélectionnez le type **Application Web**.
4. Dans la section **URI de redirection autorisés**, sélectionnez **+ Ajouter un URI**.
5. Dans le champ qui s’affiche, indiquez l’URI de redirection :
```
https://
6. Cliquez sur **Create**.
La boîte de dialogue qui s’affiche contient les valeurs **Client ID** et **secret client**.
Ces données sont obligatoires pour configurer le tokenmanagement service dans Vantage. Vous pouvez les enregistrer immédiatement ou les copier plus tard en accédant à **APIs & Services > Credentials** et en sélectionnant l’identifiant du client OAuth 2.0 que vous avez créé.
### Publication et vérification
Le statut de publication de l’application est affiché dans la section **APIs & Services > OAuth consent screen**.
Les applications ayant le statut **Testing** sont uniquement accessibles aux utilisateurs ajoutés à la liste des testeurs. La publication d’une application est la seule façon de la rendre accessible à tout utilisateur disposant d’un compte Google.
Cliquez sur **Publish app**. Le scope `https://mail.google.com/` autorise l’application à accéder à des données utilisateur confidentielles ; un message indiquant que l’application doit être vérifiée s’affichera donc.
Pour vérifier l’application, vous devrez fournir :
* Un lien officiel vers la politique de confidentialité de l’application
* Une vidéo YouTube montrant l’objectif déclaré de la collecte des données utilisateur Google via l’application
* Un texte adressé à Google expliquant pourquoi vous avez besoin d’accéder à des données utilisateur confidentielles
* Une liste complète de tous vos domaines vérifiés dans Google Search Console
Cliquez sur **Confirm**. Le statut de votre application passera à **In Production**.
Le bouton **Prepare for verification** apparaîtra également, afin que vous puissiez fournir toutes les données requises pour la vérification.
## Enregistrement de l’application dans Microsoft Azure
Pour créer une application, vous devez disposer d’un tenant Azure Active Directory avec les autorisations d’enregistrement d’application et de modification requises.
Vous pouvez passer au répertoire approprié sur la page **Portal settings | Directories + subscriptions**.
### Enregistrement de l’application
1. Accédez à la page **App registrations**.
2. Cliquez sur **New registration**.
3. Indiquez un nom pour votre application et sélectionnez les types de comptes pris en charge.
5. Cliquez sur **Register**.
### Configuration des autorisations de l’application
1. Accédez à l’onglet **API permissions**.
2. Cliquez sur **Add permission**.
3. Dans la boîte de dialogue qui s’ouvre, sélectionnez la section **Microsoft Graph**.
4. Sélectionnez **Delegated permissions**.
5. Ajoutez les autorisations suivantes :
* `email`
* `IMAP.AccessAsUser.All`
* `offline_access`
* `openid`
* `profile`
6. Cliquez sur **Add permissions**. La boîte de dialogue se ferme et les autorisations sélectionnées s’affichent.
### Création de secrets client
1. Accédez à l’onglet **Authentification**.
2. Dans la section **Implicit grant and hybrid flows**, cochez **ID tokens (used for implicit and hybrid flows)**.
3. Cliquez sur **Save** en haut de l’écran.
4. Accédez à l’onglet **Certificates & secrets**, puis cliquez sur **New client secret**.
5. Dans la boîte de dialogue qui s’ouvre, indiquez un nom pour le secret client ainsi qu’une date d’expiration.
Vous aurez également besoin d’un identifiant client, que vous pouvez copier depuis le champ **Application (client) ID** dans l’onglet **Vue d’ensemble**. L’icône de copie apparaît lorsque vous survolez la valeur de l’identifiant avec le curseur.
### Vérification de l’application
Pour rendre l’application accessible aux utilisateurs de n’importe quel tenant Azure AD, une vérification est nécessaire. Cette vérification n’est pas nécessaire si seuls des comptes d’un même tenant Azure AD sont utilisés.
Seuls les participants au Microsoft Partner Network peuvent effectuer cette vérification.
1. Accédez à l’onglet **Image de marque et propriétés**.
2. Vérifiez que le domaine est spécifié dans le champ **Domaine de l’éditeur**. Si nécessaire, configurez votre domaine en cliquant sur **Configurer un domaine**.
## Fourniture des informations d’identification à Consul
Si Vantage est déjà installé, vous devez utiliser Consul pour saisir manuellement les identifiants de compte générés pour l’authentification auprès du service de messagerie Microsoft et/ou Google.
Les fonctionnalités spécifiques au protocole OAuth 2.0 sont décrites dans le service TokenManagement.
3. Sélectionnez le service **tokenmanagement**.
4. Accédez à la section **oAuthClientConfiguration**.
5. Sélectionnez le service pour lequel vous souhaitez renseigner les données utilisateur (**google** ou **microsoft**).
6. Sélectionnez la clé **clientId**.
7. Copiez-collez la valeur du Client ID que vous avez enregistrée précédemment dans le champ de saisie, puis cliquez sur **Save**.
8. Répétez les étapes 6 et 7 pour la clé **clientSecret**.
Si nécessaire, répétez les étapes 5 à 8 pour un autre service de messagerie électronique.
9. Redémarrez le service **tokenmanagement** en exécutant la commande suivante :
```bash theme={null}
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
```
## Mise à jour du secret client
La valeur du secret client est utilisée pour l’identification du client côté serveur et constitue une information confidentielle. Pour des raisons de sécurité, cette valeur doit être mise à jour périodiquement. Certains services, comme Azure Active Directory, limitent sa durée de validité.
Une fois qu’un nouveau secret client a été créé, la valeur de la clé Consul correspondante doit également être mise à jour.
### Mise à jour du secret client dans Google
1. Accédez à la Google Cloud Console et sélectionnez le projet approprié.
2. Dans le menu de gauche, sélectionnez **APIs & Services > Credentials**.
3. Dans la section **OAuth 2.0 Client IDs**, sélectionnez l’identifiant utilisé pour l’authentification lors de la connexion au serveur IMAP.
4. Cliquez sur **Reset secret**.
5. Cliquez sur **Reset** dans la boîte de dialogue qui s’affiche. Cela met à jour la valeur du secret client et invalide sa valeur précédente.
6. Téléchargez le fichier JSON contenant les identifiants. Vous pouvez également copier la valeur du secret client à droite de l’écran.
### Mise à jour du secret client dans Microsoft Azure
1. Accédez à la page **App registrations** et sélectionnez l’application utilisée pour l’authentification avec le serveur IMAP.
2. Accédez à l’onglet **Certificates & secrets** et cliquez sur **New client secret**.
3. Dans la boîte de dialogue qui s’ouvre, indiquez un nom pour le secret client ainsi que sa date d’expiration.
4. Cliquez sur **Add**. La boîte de dialogue se ferme alors et les informations sur le nouveau secret client s’affichent. Il est important de copier et d’enregistrer la **Value**, car vous ne pourrez plus y accéder après avoir fermé la page.
5. Si le secret client actuel n’a pas encore expiré, vous pouvez le supprimer afin que seul le nouveau secret client puisse être utilisé pour identifier le client.
### Mise à jour du secret client dans Consul
Suivez les étapes indiquées dans [Fourniture des informations d’identification à Consul](#passing-credentials-to-consul), à l’exception des étapes 6 et 7 (copie de la valeur `clientId`).