OAuth - Google - Cuenta de Servicio¶

Introducción¶

El complemento Jitterbit OAuth - Google - Cuenta de servicio se utiliza para autenticarse con la despliegue de OAuth 2 de Google para cuentas de servicio de Google. Hay una guía paso a paso para configurar una cuenta de servicio de Google disponible en la documentación de Google Uso de OAuth 2.0 para aplicaciones de servidor a servidor.

Después de ejecutar el complemento en un Jitterbit Script, el token de autenticación se devuelve en la variable global google.oauth.token.auth y el número de segundos de vencimiento se devuelve en la variable global google.oauth.token.expireSeconds.

Estas variables globales luego se pueden utilizar en otras partes del proyecto. Por ejemplo, google.oauth.token.auth se puede utilizar dentro de una URL o encabezado HTTP para proporcionar los detalles de autenticación a Google. La variable google.oauth.token.expireSeconds se puede utilizar para almacenar en caché el token de autorización hasta que se cumpla el número de segundos de vencimiento.

Uso¶

Si bien este complemento se puede ejecutar en cualquier Jitterbit Script, las variables globales que devuelve son compatibles con la configuración de estos extremos:

• Fuente HTTP de Design Studio
• Destino HTTP de Design Studio
• Conexión HTTP de Cloud Studio
• Actividad HTTP de Cloud Studio

La salida del complemento no es compatible con Cloud Studio Connector Builder. En su lugar, en Cloud Studio puedes usar Google Docs, Google Drive, o Google Sheets conectores, que ya proporcionan un medio de autenticación con el servicio de Google durante la configuración del extremo.

Pasos¶

Esta página detalla los pasos para utilizar el complemento OAuth - Google - Cuenta de servicio:

1. Descargue y agregue el complemento
2. Asociar el complemento con un Grupo de Agentes
3. Establecer variables globales para el complemento
4. Ejecute el complemento en un Jitterbit Script
5. Completar la configuración de la operación

Descargue y Agregue el Complemento¶

El complemento Jitterbit OAuth - Google - Cuenta de servicio debe descargarse en el enlace que se proporciona a continuación y agregarse a la organización (consulte Agregar nuevos complementos en Personalizaciones > Complementos).

• OAuth - Google - Cuenta de servicio 1.0.0.0 (ZIP)

Asociar el Complemento con un Grupo de Agentes¶

Si utiliza un Grupo de Agentes en Nube, puede omitir este paso, ya que el complemento Jitterbit OAuth - Google - cuenta de servicio ya está asociado con los Grupos de Agentes en Nube de Jitterbit de forma predeterminada.

Si utiliza un Grupo de Agentes Privados, debe asociar este complemento proporcionado por Jitterbit con su Grupo de Agentes Privados. Esto hará que el complemento esté disponible para todos los Agentes Privados dentro del Grupo de Agentes Privados. Para asociar el complemento:

1. Inicie sesión en el Portal de Harmony y vaya a Management Console. Luego use el menú en la parte superior izquierda para navegar a Personalizaciones > Complementos.
2. En la tabla, busque la fila "Jitterbit OAuth - Google - Cuenta de servicio". En el extremo derecho, use el menú desplegable Acción para seleccionar Asociar Grupo de Agentes.
3. En la ventana emergente, seleccione su Grupo de Agentes Privados y haga clic en Guardar.

Establecer Variables Globales para el Complemento¶

Para que este complemento sea funcional, se deben configurar las variables globales requeridas como entrada por el complemento.

Estas variables globales se pueden configurar en el mismo secuencia de comandos que ejecuta el complemento (que se trata a continuación en Ejecutar el complemento en un Jitterbit Script), o se pueden configurar en un secuencia de comandos separado que se encuentra más temprano en la cadena de operación (para que las variables se inicialicen antes de la ejecución del complemento).

A continuación se proporciona una modelo de secuencia de comandos, seguida de documentación sobre cada una de las variables globales de entrada que se pueden utilizar con el complemento:

<trans>
// Input variables
$google.oauth.privateKey = "-----BEGIN PRIVATE KEY-----\nABCDEfg...HIJKLMN\n-----END PRIVATE KEY-----\n";
$google.oauth.clientEmail = "example@example-123456.iam.gserviceaccount.com";
$google.oauth.accountScopes = "https://www.googleapis.com/auth/bigquery";
$google.oauth.serviceAccountUser = '';
</trans>

Ejecute el Complemento en un Jitterbit Script¶

Este complemento se puede ejecutar desde un Jitterbit Script de cualquier tipo de secuencia de comandos llamando a la función Jitterbit Script RunPlugin().

Las variables globales necesarias como entrada para el complemento se pueden especificar dentro del mismo secuencia de comandos en el que se ejecuta el complemento. Por ejemplo, el contenido del secuencia de comandos utilizado para la modelo en Establecer variables globales para el complemento podría incluirse en un único secuencia de comandos que también ejecute el complemento.

Después de ejecutar el complemento, el token de autenticación se devuelve en la variable global google.oauth.token.auth y el número de segundos de vencimiento se devuelve en la variable global google.oauth.token.expireSeconds.

Cada una de estas partes del secuencia de comandos se proporciona en esta modelo:

<trans>
// Input variables
$google.oauth.privateKey = "-----BEGIN PRIVATE KEY-----\nABCDEfg...HIJKLMN\n-----END PRIVATE KEY-----\n";
$google.oauth.clientEmail = "example@example-123456.iam.gserviceaccount.com";
$google.oauth.accountScopes = "https://www.googleapis.com/auth/bigquery";
$google.oauth.serviceAccountUser = '';

// Output variables
$google.oauth.token.auth = '';
$google.oauth.token.expireSeconds = '';

// Executing the plugin
RunPlugin("<TAG>plugin:http://www.jitterbit.com/plugins/pipeline/user/OAuthGoogleServiceAccount</TAG>");
</trans>

Complete la Configuración de la Operación¶

Las variables globales devueltas por el secuencia de comandos del complemento se pueden usar en otras partes del proyecto para la autenticación con Google. Estas variables globales se admiten oficialmente dentro de la configuración de estos extremos:

• Fuente HTTP de Design Studio
• Destino HTTP de Design Studio
• Conexión HTTP de Cloud Studio
• Actividad HTTP de Cloud Studio

En una configuración típica en Design Studio, la variable global google.oauth.token.auth se puede utilizar dentro de una URL o encabezado HTTP para proporcionar los detalles de autenticación a Google.

Esto se puede concatenar con el alojar de Google en el campo URL de una fuente HTTP o destino HTTP.

Alternativamente, se puede ingresar en el origen o destino HTTP Propiedades HTTP avanzadas en el área Encabezados de solicitud:

De manera similar, en Cloud Studio, la variable global google.oauth.token.auth se puede utilizar en una conexión HTTP dentro del campo Encabezados de solicitud. Alternativamente, se puede especificar como Parámetro de solicitud o Encabezado de solicitud en una actividad HTTP.