Configuração da autenticação da conta de serviço para Google Cloud Platform (GCP)

Neste tópico:

Pré-requisitos

Para fornecer o arquivo da conta de serviço, você deve primeiro criar um projeto do Google Cloud Platform (GCP). Consulte a documentação GCP para saber como criar um projeto GCP.

Criação de uma chave de conta de serviço

O procedimento a seguir descreve como criar uma conta de serviço:

  1. Para abrir o criador da conta de serviço, selecione APIs & Services » Credentials no seu projeto GCP.

  2. Selecione Create credentials » service account.

  3. No formulário Service account details, digite o nome de uma conta de serviço de sua preferência.

  4. Clique em Done para criar a conta de serviço.

  5. Depois de criar uma conta de serviço, encontre-a na lista da seção Credentials e pressione seu nome para gerenciar a conta de serviço.

  6. Selecione Keys » Add key » Create a new key.

  7. Na exibição de seleção do tipo de chave, escolha o tipo JSON recomendado e pressione Create para salvar o arquivo de chave da conta de serviço, que será necessário durante a configuração do conector.

Formatação da chave da conta de serviço

A chave da conta de serviço baixada na etapa anterior pode ser usada para preencher automaticamente o formulário ao configurar o conector, usando a funcionalidade arrastar e soltar no assistente de configuração.

Caso a chave privada seja inserida manualmente, ela deve primeiro ser formatada corretamente.

Exemplo de chave de conta de serviço, no formato JSON:

{
  "type": "service_account",
  "project_id": "your-project-id0809",
  "private_key_id": "7a7df777f88...f7f7s8d7f7s",
  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADC9ON1OA4JjRidj\n/7O5Ioq+L2112946/CsXsfiHFwIQQedWt\nQ75sl7M5lHTsVQtIdtBcGJXvk5/7CHOmtkn6w\n2dRoyCWv2bknmogZIy3fssMolwVaZ15cmsuB0\nwTI81dojSVwrzPshiYY9lfugdVZ2uiFcw4haWo8o\nUhg2tHOWyveoFN2RF03kUfdnEfhAAmXKZai\nWkd49r+jAgMBAAECggEAIP/5TIE9LJ4QAZcXG2sEQl7GldrQho0nuAOVkEtzQsuP\ndmgbFYU39qinuLc83GF/Ghr3PdswzQTKeKCvZZXhQ4FpYk9VhyQr6iTKv6bBD8du\nMrF2LKknax1eCFG81o0A+zOvo\npMrJl/9EOOVJKnifhH7kdS/JRqHXEzQUGkpOWSs6ep7MGN4+vLv+GlZqIIgEGwmW\nJN/72+5bLiaL9T7If1+/T/sa\n-----END PRIVATE KEY-----\n",
  "client_email": "testclientemail.gserviceaccount.com",
  "client_id": "2345345634546456",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/you-project.....",
  "universe_domain": "googleapis.com"
}
Copy

Para a chave privada, apenas o texto entre —–BEGIN PRIVATE KEY—–, —–END PRIVATE KEY—– é relevante.

Para transformar uma chave privada no formato aceitável pelo conector, faça o seguinte:

  1. Abra a chave baixada na etapa anterior em um editor de texto.

  2. Copie o conteúdo do campo private_key.

  3. Exclua os marcadores —–BEGIN PRIVATE KEY—– e —–END PRIVATE KEY—–.

  4. Exclua todos os caracteres \n (nova linha) do arquivo. Geralmente há mais de 10 ocorrências em uma determinada chave.

  5. Salve o arquivo para uso posterior.

Após as edições, sua chave deve se parecer com:

MIIEvgIBADC9ON1OA4JjRidj/7O5Ioq+L2112946/CsXsfiHFwIQQedWtQ75sl7M5lHTsVQtIdtBcGJXvk5/7CHOmtkn6w2dRoyCWv2bknmogZIy3fssMolwVaZ15cmsuB0wTI81dojSVwrzPshiYY9lfugdVZ2uiFcw4haWo8oUhg2tHOWyveoFN2RF03kUfdnEfhAAmXKZaiWkd49r+jAgMBAAECggEAIP/5TIE9LJ4QAZcXG2sEQl7GldrQho0nuAOVkEtzQsuPdmgbFYU39qinuLc83GF/Ghr3PdswzQTKeKCvZZXhQ4FpYk9VhyQr6iTKv6bBD8duMrF2LKknax1eCFG81o0A+zOvopMrJl/9EOOVJKnifhH7kdS/JRqHXEzQUGkpOWSs6ep7MGN4+vLv+GlZqIIgEGwmWJN/72+5bLiaL9T7If1+/T/sa
Copy

Concessão de acesso da conta de serviço ao Google Analytics

A conta de serviço precisa de acesso a todas as propriedades do Google Analytics que o conector usará. O procedimento a seguir descreve como conceder acesso:

  1. Abra o console do Google Analytics e escolha uma propriedade que será usada pelo conector.

  2. Selecione a guia Property access management.

  3. Adicione o e-mail da conta de serviço como Viewer.

  4. Repita esse processo para todas as propriedades que serão utilizadas no conector.