Oauth - Google - Service Account¶

Introdução¶

O plug-in Jitterbit Oauth - Google - Service Account é usado para autenticação com a implementação do OAuth 2 do Google para contas de serviço do Google. Um guia passo a passo para configurar uma conta de serviço do Google está disponível na documentação do Google Using OAuth 2.0 for Server to Server Applications.

Após o plugin ser executado em um Jitterbit Script, o token de autenticação é retornado na variável global google.oauth.token.auth e o número de expiração de segundos é retornado na variável global google.oauth.token.expireSeconds.

Essas variáveis globais podem então ser usadas em outras partes do projeto. Por exemplo, google.oauth.token.authpode ser usado em um URL ou cabeçalho HTTP para fornecer os detalhes de autenticação ao Google. a variável google.oauth.token.expireSeconds pode ser usado para armazenar em cache o token de autorização até que o número de segundos de expiração seja atingido.

Uso¶

Enquanto este plugin pode ser executado em qualquer Jitterbit Script, as variáveis globais que ele retorna são suportadas na configuração desses endpoints:

• Fonte HTTP do Design Studio
• Alvo HTTP do Design Studio
• Conexão HTTP do Cloud Studio
• Atividade HTTP do Cloud Studio

A saída do plug-in não é suportada no Cloud Studio Connector Builder. Em vez disso, no Cloud Studio, você pode usar o Google Docs, Google Drive ou Planilhas Google conectores, que já fornecem um meio de autenticação com o serviço do Google durante a configuração do endpoint.

Passos¶

Esta página detalha as etapas para usar o plug-in OAuth - Google - Conta de serviço:

1. Baixe e adicione o plug-in
2. Associar o plug-in a um Grupo de Agentes
3. Definir variáveis globais para o plug-in
4. Executar o plug-in em um Script Jitterbit
5. Conclua a configuração da operação

Baixe e Adicione o Plug-in¶

O plug-in Jitterbit OAuth - Google - Conta de serviço deve ser baixado no link fornecido abaixo e adicionado à organização (consulte Adicionar novos plug-ins em Customizações > Plug-ins).

• OAuth - Google - Conta de serviço 1.0.0.0 (ZIP)

Associar o Plug-in a um Grupo de Agentes¶

Se estiver usando um Grupo de Agentes em Nuvem, você pode pular esta etapa, pois o plug-in Jitterbit OAuth - Google - Service Account já está associado aos Grupos de Agentes em Nuvem do Jitterbit por padrão.

Se estiver usando um Grupo de Agentes Privados, você deve associar este plug-in fornecido pela Jitterbit ao seu Grupo de Agentes Privados. Isso tornará o plugin disponível para todos os Agentes Privados dentro do Grupo de Agentes Privados. Para associar o plug-in:

1. Faça login no Portal Harmony e vá para o Management Console. Em seguida, use o menu no canto superior esquerdo para navegar até Personalizações > Plug-ins.
2. Na tabela, localize a linha "Jitterbit OAuth - Google - Conta de serviço". À direita, use o menu suspenso Action para selecionar Associate Grupo de Agentes.
3. No pop-up, selecione seu Grupo de Agentes Privados e clique em Salvar.

Definir Variáveis Globais para o Plug-in¶

Para que este plug-in seja funcional, as variáveis globais exigidas como entrada pelo plug-in devem ser definidas.

Essas variáveis globais podem ser definidas no mesmo script que executa o plug-in (abordado a seguir em Execute the Plugin in a Jitterbit Script) ou podem ser definidas em um script separado localizado anteriormente na cadeia de operação (para que as variáveis sejam inicializadas antes da execução do plug-in).

Um modelo de script é fornecido abaixo, seguido pela documentação de cada uma das variáveis globais de entrada que podem ser usadas com o plug-in:

<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>

Execute o Plug-in em um Script Jitterbit¶

Este plugin pode ser executado a partir de um Jitterbit Script de qualquer tipo de script chamando a função Jitterbit Script RunPlugin().

As variáveis globais necessárias como entrada para o plug-in podem ser especificadas no mesmo script em que o plug-in é executado. Por exemplo, o conteúdo do script usado para o modelo em Set Global Variables for the Plugin pode ser incluído em um único script que também executa o plug-in.

Após a execução do plugin, o token de autenticação é retornado na variável global google.oauth.token.auth e o número de expiração de segundos é retornado na variável global google.oauth.token.expireSeconds.

Cada uma dessas partes do script é fornecida neste 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>

Conclua a Configuração da Operação¶

As variáveis globais retornadas pelo script do plug-in podem ser usadas em outras partes do projeto para autenticação com o Google. Essas variáveis globais são oficialmente suportadas na configuração desses endpoints:

• Fonte HTTP do Design Studio
• Alvo HTTP do Design Studio
• Conexão HTTP do Cloud Studio
• Atividade HTTP do Cloud Studio

Em uma configuração típica no Design Studio, a variável global google.oauth.token.auth pode ser usado em um URL ou cabeçalho HTTP para fornecer os detalhes de autenticação ao Google.

Isso pode ser concatenado com o hospedar do Google no campo URL de uma origem HTTP ou destino HTTP.

Como alternativa, ele pode ser inserido na origem ou destino HTTP Propriedades avançadas de HTTP na área Cabeçalhos de solicitação:

Da mesma forma, no Cloud Studio, a variável global google.oauth.token.auth pode ser usado em uma conexão HTTP no campo Request Headers. Como alternativa, pode ser especificado como um Parâmetro de solicitação ou um Cabeçalho de solicitação em uma atividade HTTP.