3. Espere a que aparezca una notificación indicando que su proyecto se ha creado.
2. En el menú del lado izquierdo de la pantalla, seleccione **APIs & Services > OAuth consent screen**.
3. Seleccione el tipo de usuario **External** y haga clic en **Create**.
4. Especifique un nombre para la aplicación. En el campo de lista desplegable **User support email**, seleccione su dirección de Gmail.
5. Especifique el correo electrónico del desarrollador en la sección **Developer contact information**, en la parte inferior de la página, y haga clic en **Save and continue**.
6. Haga clic en **Add or remove scopes**. Se abrirá el cuadro de diálogo **Update selected scopes** a la derecha.
7. Copie y pegue el siguiente texto en el campo **Manually add scopes**, en la parte inferior del cuadro de diálogo, y haga clic en **Add to table**:
```
openid https://www.googleapis.com/auth2/userinfo.email https://www.googleapis.com/auth2/userinfo.profile https://mail.google.com/
```
9. Haga clic en **Save and continue** en la parte inferior de la pantalla.
10. Haga clic en **Save and continue** para omitir la configuración de la página **Test users** e ir a la página **Summary**.
En la página **Summary**, verá información sobre la aplicación, las direcciones de correo electrónico y los permisos configurados.
3. Selecciona el tipo **Web application**.
4. En la sección **Authorized redirect URIs**, selecciona **+ Add URI**.
5. En el campo que aparecerá, especifica la URI de redirección:
```
https://
6. Haga clic en **Create**.
El cuadro de diálogo emergente que aparecerá contendrá los valores de **Client ID** y **secreto de cliente**.
Estos datos son necesarios para configurar el servicio tokenmanagement en Vantage. Puede guardarlos de inmediato o copiarlos más tarde; para ello, vaya a **APIs & Services > Credentials** y seleccione el identificador del cliente OAuth 2.0 que creó.
### Publicación y verificación
El estado de publicación de la aplicación se muestra en la sección **APIs & Services > OAuth consent screen**.
Las aplicaciones con estado **Testing** solo están disponibles para los usuarios que se hayan añadido a la lista de testers. Solo al publicar una aplicación esta queda disponible para cualquier usuario con una cuenta de Google.
Haz clic en **Publish app**. El alcance `https://mail.google.com/` permite que la aplicación acceda a datos confidenciales del usuario, por lo que se mostrará un mensaje indicando que la aplicación debe verificarse.
Para verificar la aplicación, deberás proporcionar:
* Un enlace oficial a la política de privacidad de la aplicación
* Un vídeo de YouTube que demuestre el propósito declarado de obtener datos de usuarios de Google mediante la aplicación
* Un texto dirigido a Google con una descripción de por qué necesitas acceso a datos confidenciales del usuario
* Una lista completa de todos tus dominios verificados en Google Search Console
Haz clic en **Confirm**. El estado de tu aplicación cambiará a **In Production**.
También aparecerá el botón **Prepare for verification**, que te permitirá proporcionar todos los datos necesarios para la verificación.
## Registrar la aplicación en Microsoft Azure
Para crear una aplicación, se requiere un tenant de Azure Active Directory con permisos para registrar y editar aplicaciones.
Puede cambiar al directorio correcto en la página **Portal settings | Directories + subscriptions**.
### Registrar la aplicación
1. Vaya a la página **App registrations**.
2. Haga clic en **New registration**.
3. Especifique un nombre para la aplicación y seleccione los tipos de cuenta admitidos.
5. Haz clic en **Register**.
### Configuración de permisos de la aplicación
1. Vaya a la pestaña **API permissions**.
2. Haga clic en **Add permission**.
3. En el cuadro de diálogo que se abre, seleccione la sección **Microsoft Graph**.
4. Seleccione **Delegated permissions**.
5. Agregue los siguientes permisos:
* `email`
* `IMAP.AccessAsUser.All`
* `offline_access`
* `openid`
* `profile`
6. Haga clic en **Add permissions**. Esto cerrará el cuadro de diálogo y mostrará los permisos seleccionados.
### Creación de secretos de cliente
1. Vaya a la pestaña **Autenticación**.
2. En la sección **Concesión implícita y flujos híbridos**, marque **Tokens de ID (usados para flujos implícitos e híbridos)**.
3. Haga clic en **Guardar** en la parte superior de la pantalla.
4. Vaya a la pestaña **Certificados y secretos** y haga clic en **Nuevo secreto de cliente**.
5. En el cuadro de diálogo que se abrirá, especifique un nombre para el secreto de cliente y una fecha de expiración.
También necesitará el identificador del cliente, que puede copiar del campo **ID de la aplicación (cliente)** en la pestaña **Información general**. El icono de copia aparecerá cuando pase el cursor sobre el valor del identificador.
### Verificación de la aplicación
Para que la aplicación esté disponible para los usuarios de cualquier tenant de Azure AD, es necesario verificarla. La verificación no es necesaria si se usan cuentas de un único tenant de Azure AD.
Solo los participantes de Microsoft Partner Network pueden completar la verificación.
1. Vaya a la pestaña **Branding & properties**.
2. Verifique que el dominio esté especificado en el campo **Publisher domain**. Si es necesario, configure el dominio haciendo clic en **Configure a domain**.
## Introducción de credenciales en Consul
Si Vantage ya está instalado, debe usar Consul para introducir manualmente las credenciales de la cuenta generadas para la autenticación del servicio de correo electrónico de Microsoft y/o Google.
Las funciones específicas del protocolo OAuth 2.0 se describen en el servicio TokenManagement.
3. Seleccione el servicio **tokenmanagement**.
4. Vaya a la sección **oAuthClientConfiguration**.
5. Seleccione el servicio para el que desea especificar los datos de usuario (**google** o **microsoft**).
6. Seleccione la clave **clientId**.
7. Copie y pegue en el campo de entrada el valor de Client ID que guardó antes y haga clic en **Save**.
8. Repita los pasos 6 y 7 para la clave **clientSecret**.
Si es necesario, repita los pasos del 5 al 8 para otro servicio de correo electrónico.
9. Reinicie el servicio **tokenmanagement** ejecutando el siguiente comando:
```bash theme={null}
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
```
## Actualización del secreto de cliente
El valor del secreto de cliente se utiliza para identificar al cliente en el servidor y constituye información confidencial. Por motivos de seguridad, este dato debe actualizarse periódicamente. Algunos servicios, como Azure Active Directory, limitan el período de validez de este tipo de datos.
Una vez creado un nuevo secreto de cliente, también debe actualizarse el valor de la clave de Consul correspondiente.
### Actualización del secreto de cliente en Google
1. Vaya a Google Cloud Console y seleccione el proyecto correspondiente.
2. En el menú de la izquierda, seleccione **APIs & Services > Credentials**.
3. En la sección **OAuth 2.0 Client IDs**, seleccione el identificador que se usa para autenticarse al conectarse al servidor IMAP.
4. Haga clic en **Reset secret**.
5. Haga clic en **Reset** en el cuadro de diálogo emergente. Esto actualizará el valor del secreto de cliente y recuperará su valor anterior.
6. Descargue el archivo JSON que contiene las credenciales. Como alternativa, copie el valor del secreto de cliente desde el lado derecho de la pantalla.
### Actualización del secreto de cliente en Microsoft Azure
1. Vaya a la página **App registrations** y seleccione la aplicación utilizada para la autenticación mediante el servidor IMAP.
2. Vaya a la pestaña **certificados y secretos** y haga clic en **New client secret**.
3. En el cuadro de diálogo que se abrirá, especifique un nombre para el secreto de cliente y su fecha de vencimiento.
4. Haga clic en **Add**. Esto cerrará el cuadro de diálogo y mostrará información sobre el nuevo secreto de cliente. Es importante que copie y guarde el **Value**, ya que no podrá volver a acceder a él una vez que cierre la página.
5. Si el secreto de cliente actual aún no ha vencido, puede eliminarlo para asegurarse de que solo se utilice el nuevo secreto de cliente para identificar al cliente.
### Actualizar el secreto de cliente en Consul
Siga los pasos indicados en [Introducción de credenciales en Consul](#passing-credentials-to-consul), excepto los pasos 6 y 7 (copiar el valor de clientId).