OAuth - Google - complemento de cuenta de servicio (obsoleto) para la nube Jitterbit y grupos de agentes privados

Introducción

El complemento Jitterbit OAuth - Google - Service Account se utiliza para autenticar con la despliegue de OAuth 2 de Google para las 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 que el complemento se ejecuta 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 expiración se devuelve en la variable global google.oauth.token.expireSeconds.

Estas variables globales se pueden utilizar en otras partes del proyecto. Por ejemplo, google.oauth.token.auth se puede utilizar dentro de una URL HTTP o un encabezado 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 alcance el número de segundos de expiración.

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
• Objetivo HTTP de Design Studio
• Integration Studio conexión HTTP
• Integration Studio actividad HTTP

La salida del complemento no es compatible con Integration StudioConstructor de conectores. En cambio, en Integration Studio Puedes utilizar 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. Descargar y agregar el complemento
2. Asociar el complemento con un grupo de agentes
3. Establecer variables globales para el complemento
4. Ejecutar 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.

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

Asociar el complemento con un grupo de agentes

Si usa un grupo de agentes en la nube, puede omitir este paso, ya que el complemento Jitterbit OAuth - Google - Service Account ya está asociado con los grupos de agentes en la 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 en todos los agentes privados dentro del grupo de agentes privados. Para asociar el complemento:

1. Inicie sesión en el portal Harmony y vaya a la 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, utilice 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 explica a continuación en Ejecutar el complemento en un Jitterbit Script), o se pueden configurar en un secuencia de comandos separado que se encuentra antes 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>

Ejecutar el complemento en un Jitterbit Script

Este complemento se puede ejecutar desde un Jitterbit Script de cualquier 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 expiración se devuelve en la variable global google.oauth.token.expireSeconds.

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

``` title="Setting Input Variables and Executing the Plugin" // 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("plugin:http://www.jitterbit.com/plugins/pipeline/user/OAuthGoogleServiceAccount"); `` | Nombre | Descripción | |------------------------------|------------------ -------------------------------------------------- --| |google.oauth.token.auth| El token de autenticación de Google. | |google.oauth.expireSeconds`| La cantidad de segundos hasta que caduque el token de autenticación de Google. |

Completar la configuración de la operación

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

• Fuente HTTP de Design Studio
• Objetivo HTTP de Design Studio
• Integration Studio conexión HTTP
• Integration Studio actividad HTTP

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 objetivo HTTP.

También se puede ingresar en las Propiedades HTTP avanzadas del origen o destino HTTP, en el área Encabezados de solicitud:

De manera similar, en Integration 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 un Parámetro de solicitud o un Encabezado de solicitud en una actividad HTTP.