Google Drive

​

Antes de empezar

• Usa una cuenta de Google que pueda administrar el proyecto de Google Cloud. No necesita acceso al contenido de Drive que importarán los usuarios.
• Conoce la URL pública de tu instancia de Zylon, por ejemplo https://zylon.company.com.
• Guarda el secreto del cliente OAuth en un gestor de secretos seguro. No lo incluyas en el control de versiones. La clave de API de Picker se usa en el navegador, así que restríngela a las APIs requeridas y, cuando corresponda, al origen de Zylon.

​

Crear o seleccionar un proyecto de Google Cloud

1. Abre la consola de Google Cloud.
2. Selecciona un proyecto existente o crea uno nuevo para la integración.
3. Anota el número de proyecto en el panel del proyecto. Zylon lo usa como App ID de Picker.

​

Habilitar las APIs de Google

1. En la consola de Google Cloud, ve a APIs y servicios → Biblioteca.
2. Busca y habilita Google Drive API.
3. Busca y habilita Google Picker API.

​

Crear y restringir una clave de API

1. Ve a APIs y servicios → Credenciales.
2. Selecciona Crear credenciales → Clave de API.
3. Copia la clave; será el valor de apiKey en Zylon.
4. Abre la nueva clave y, en Restricciones de API, selecciona Restringir clave.
5. Selecciona Google Drive API y Google Picker API y guarda la clave.

​

Configurar la pantalla de consentimiento OAuth y el acceso a datos

1. En la consola de Google Cloud, abre Google Auth platform. Completa la configuración obligatoria de Branding y Audience de tu organización.
2. Abre Data Access y selecciona Add or remove scopes.
3. Añade los siguientes scopes y guarda los cambios.

​

Crear un cliente OAuth

1. En Google Auth platform, abre Clients.
2. Selecciona Create client y elige Web application como tipo de aplicación.
3. Asigna un nombre significativo al cliente, por ejemplo Zylon Google Drive.
4. En Authorized redirect URIs, añade la siguiente URL; sustituye el dominio por la URL de tu instancia de Zylon:

https://{your-zylon-domain}/api/app/integration/googledrive/callback

5. Crea el cliente.
6. Copia el Client ID y el Client secret. Los usarás como clientId y clientSecret en la configuración de Zylon.

​

Configurar Zylon

integration:
  googleDrive:
    enabled: true
    clientId: "{Google OAuth client ID}"
    clientSecret: "{Google OAuth client secret}"
    redirectUri: "https://{your-zylon-domain}/api/app/integration/googledrive/callback"
    apiKey: "{Google API key}"
    appId: "{Google Cloud project number}"

sudo zylon-cli sync

​

Solución de problemas

​

La opción de Google Drive no está disponible o el selector se cierra inmediatamente

• Confirma que integration.googleDrive.enabled es true.
• Confirma que apiKey y appId están configurados. Google Picker necesita ambos valores.
• Confirma que Google Drive API y Google Picker API están habilitadas en el mismo proyecto de Google Cloud.

​

Google muestra un error de URI de redirección

• Comprueba que la Authorized redirect URI sea exactamente igual a redirectUri en la configuración de Zylon.
• Confirma que el dominio sea el dominio HTTPS público con el que se accede a Zylon.

​

Un usuario no puede ver o importar un elemento de Drive

• Confirma que el usuario inicia sesión con la cuenta de Google que puede acceder al elemento.
• Confirma que la pantalla de consentimiento incluya todos los scopes de Configurar la pantalla de consentimiento OAuth y el acceso a datos.