Centro de soporte de Workiva

Con el conector de almacenamiento en la nube de Google®, puedes utilizar comandos en cadena para gestionar archivos y carpetas en cubos de almacenamiento en la nube de Google.

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para habilitar la conexión, el conector utiliza la API JSON de almacenamiento en la nube de Google. Para configurar el conector, necesitarás:

• Una aplicación Google Cloud dedicada al conector
• El depósito predeterminado de Google Cloud Storage con el que interactuar

Para asegurar la conexión, la aplicación puede utilizar el consentimiento OAuth o las Credenciales predeterminadas de la aplicación (ADC) para la autenticación. Dependiendo del método de autenticación, también necesitarás:

• Si consiente OAuth, el identificador y el secreto de cliente de la aplicación
• Si el ADC con un CloudRunner, una cuenta de servicio dedicada para la aplicación y sus application_default_credentials.json archivo de credenciales

  Nota: Si ADC con un GroundRunner en Google Compute Engine, Google Kubernetes Engine (GKE), App Engine, Cloud Run, o Cloud Functions, el conector puede autenticarse a través de la cuenta de servicio predeterminada de la aplicación.

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

Crear una aplicación de Google Cloud

Para establecer el conector, crea primero una aplicación de Google Cloud dedicada al conector. Para conectarse a su aplicación, el conector utiliza el consentimiento de Google Cloud ADC u OAuth.

Paso 1. Seleccionar o crear un proyecto

En la consola de Google Cloud Platform (GCP), selecciona o crea un proyecto para utilizarlo con el conector. Para crear un proyecto:

1. En la barra de herramientas, haz clic en Selecciona un proyecto o el nombre del proyecto actual y, a continuación, haz clic en Nuevo proyecto.
   
2. En Nombre del proyecto, introduce un nombre que sea único para ayudar a identificar la integración.
3. En Ubicación, selecciona tu organización para que otros puedan utilizar el proyecto.
4. Haz clic en Crear.
   
   

Paso 2. Activar el acceso al servicio

1. Desde APIs & Services, selecciona Biblioteca.
   
2. Busca y selecciona Almacenamiento en la nube, y haz clic en Activar.
   
   

Etapa 3. Crea o recupera las credenciales de autenticación de la aplicación.

Para autenticar la aplicación, crea y recupera sus credenciales para el consentimiento de Google Cloud ADC u OAuth.

Valores predeterminados de las credenciales de la aplicación Google Cloud (ADC)

Si la aplicación se ejecuta en un entorno de Google Cloud, como Compute Engine, Kubernetes Engine, App Engine, Cloud Run o Cloud Functions, puedes utilizar su cuenta de servicio predeterminada para la autenticación. Si no, crea una cuenta de servicio y descarga su archivo de credenciales para la autenticación:

1. En la consola de Google Cloud Platform (GCP), abre Crea la clave de la cuenta de servicio.
   
2. En Cuenta de servicio, selecciona Nueva cuenta de servicio.
3. Introduce un nombre que sea único para ayudar a identificar la cuenta de servicio.
4. En Rol, selecciona Almacenamiento en la nube, Admin. de objetos de almacenamiento.
5. Debajo de Tipo de clave, selecciona JSON.
6. Haz clic en Crear. Las descargas de archivo de la cuenta de servicio application_default_credentials.json. Cuando configures el conector, subirás este archivo como recurso.
   
   

Consentimiento OAuth

Para autenticar la aplicación utilizando el consentimiento OAuth:

1. Desde APIs & Services, selecciona Pantalla de consentimiento OAuth.
2. En la pestaña de la pantalla de consentimiento de OAuth, selecciona Interno, y haz clic en Crear.
   
3. En Información de la aplicación, introduce el nombre de la aplicación y la Dirección de correo electrónico del soporte del usuario para ayudar a identificar la aplicación al autenticar el conector.
4. Debajo de Dominio de la aplicación, añade un dominio autorizado de wdesk.com.
   
5. En Información de contacto del desarrollador, introduce la dirección de correo electrónico a la que Google debe enviar cualquier actualización relativa al proyecto, y haz clic en Guardar y continuar.
6. Debajo de Ámbitos y Información opcional, haz clic en Guardar y continuar sin añadir ningún ámbito ni información opcional.

   Nota: No se requieren ámbitos ni información opcional para una aplicación con usuarios internos.

7. En Resumen, revisa y edita los detalles de la pantalla de consentimiento de OAuth según sea necesario, y haz clic en Volver al panel.
8. En la pestaña Credenciales, haz clic en Crear credenciales, y selecciona ID de cliente OAuth.
   
9. Debajo de Tipo de aplicación, selecciona Aplicación web.
   
10. Introduce un nombre que sea único para ayudar a identificar las credenciales OAuth.
11. Debajo de Orígenes autorizados de JavaScript:
    • En Norteamérica, añade https://h.app.wdesk.com.
    • En la Unión Europea, añadir https://h.eu.wdesk.com.
12. En URI de redirección autorizados:
    • En Norteamérica, añade https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback.
    • En la Unión Europea, añade https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback.
13. Haz clic en Crear, y anota el identificador y el secreto del cliente.

Establecer el conector de almacenamiento en la nube de Google con las credenciales predeterminadas de la aplicación.

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. Debajo de Conector Conexión, selecciona Google Cloud Storage y el corredor para utilizar el conector.
   
3. En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.
4. En Tipo de Autenticación, selecciona Estándar.
5. Para autenticarte con el archivo de credenciales de la aplicación: 
   • Debajo de Recursos, sube el archivo de credenciales de la aplicación web Google del conector.
   • Debajo de Autenticación, introduce el nombre del archivo de credenciales, como application_default_credentials.json.

   Nota: Para autenticarte utilizando una cuenta de servicio predeterminada, deja en blanco Recursos y Autenticación.

6. En Propiedades, introduce el cubo de almacenamiento en la nube predeterminado para utilizar con el conector si no se especifica mediante un comando.
7. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
8. Para probar la conexión, crea y ejecuta una cadena con el comando Listar Objetos del conector, y comprueba que devuelve un resultado válido.

Establecer el conector de almacenamiento en la nube de Google con consentimiento OAuth

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. Debajo de Conector Conexión, selecciona Google Cloud Storage y el CloudRunner predeterminado.
   
3. En Información básica, introduce un nombre único y una descripción para ayudar a identificar el conector.
4. En Tipo de autenticación, selecciona OAuth 2.0.
5. En OAuth, introduce el ID de cliente y el secreto de la aplicación web de Google del conector.

   Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

6. Haz clic en Conectar y autoriza el acceso del conector a tu cuenta de Google.

   Nota: Para asegurarte de que Google puede autorizar el acceso del conector, habilita las ventanas emergentes del navegador.

7. En Propiedades, introduce el cubo de almacenamiento en la nube predeterminado para utilizar con el conector si no se especifica mediante un comando.
8. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
9. Para probar la conexión, crea y ejecuta una cadena con el comando Listar Objetos del conector, y comprueba que devuelve un resultado válido.

Solución de problemas

Si falla la conexión con Google Cloud Storage:

• Verifica el archivo de credenciales de la aplicación web de Google o las credenciales OAuth.
• Verifica el origen Javascript autorizado de la aplicación:
  • En Norteamérica, añade https://h.app.wdesk.com.
  • En la Unión Europea, añadir https://h.eu.wdesk.com.
• Asegurar el URI de redirección de la aplicación:
  • • En Norteamérica, añade https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback.
    • En la Unión Europea, añade https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback.
• Verifica que la aplicación web tiene habilitado el acceso a la API de almacenamiento en la nube de Google.