Guia de Conexão do Google Sheets Usando Autenticação JWT¶

Visão Geral¶

Este guia descreve os requisitos do sistema e instruções para conectar o Vinyl a um servidor de banco de dados do Google Sheets usando autenticação JWT. O método de autenticação JWT ignora a tela de consentimento do usuário.

Este tipo de conexão suporta acesso bidirecional aos dados, incluindo regras de negócios do Vinyl CRUD.

Para conectar seus servidores, você deve ter o Vinyl 3.2 instalado.

Requisitos de Sistema¶

• Servidor de banco de dados do Google Sheets

• JWT

Navegador da Web do Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Limitações e Recursos Suportados¶

Para utilizar esta conexão, recomendamos ter a versão Vinyl 3.2.32441+ instalada.

Instruções de Conexão¶

Configurar o Google Sheets no Console do Google¶

1. Navegue até o Console do Google: https://console.cloud.google.com/apis/dashboard

2. Ative a API do Google Sheets clicando em Ativar APIs e serviços e pesquisando no Google Sheets

3. No painel, configure o OAuth em Credenciais

   

4. Clique em Criar credenciais na parte superior da tela e escolha Conta de serviço

5. Dê um nome à conta de serviço e clique no botão Criar e continuar

   

6. Atribua a papel de Proprietário e clique no botão Concluído na parte inferior da página

   

7. Agora que a conta de serviço foi criada, precisamos gerar um JWT. Permanecendo nesta página Contas de serviço, clique na conta de serviço que acabamos de criar. Neste exemplo é “Google Sheets”.

   

8. Na página da conta de serviço, navegue até a aba Chaves na parte superior da página. Em seguida, clique em Adicionar chave e depois em Criar nova chave.

   

9. Você verá um pop-up perguntando em qual formato deseja que a chave esteja, selecione JSON. A chave JSON será baixada automaticamente.

   

10. Abra a Planilha Google à qual você está tentando se conectar e compartilhe o acesso com ela à conta de serviço recém-criada

    

Configurar Arquivo JWT no Servidor de Aplicativos¶

1. Depois de baixar o arquivo JWT, navegue até o servidor do aplicativo em que sua instância do Vinyl reside

2. Precisamos colocar o arquivo JWT no diretório ou pasta Vinyl, neste exemplo ele reside em C:\inetpub\wwwroot\Vinyl\, isso pode ser diferente dependendo de como sua instância está configurada.

3. Copie o arquivo JWT e coloque-o no diretório Vinyl

4. Feito isso, reinicie o IIS

Configurar o Google Sheets em Vinyl¶

1. Crie um servidor de dados do Google Sheets a partir de IDE > Data Servers > + Servidor

   1. Nome do servidor: Forneça um nome

   2. Tipo: Google Sheets

   3. Nome do arquivo: UUID do URL da Planilha Google Exemplo: https://docs.google.com/spreadsheets/d/Spreadsheet_UUID_Here

   4. Provedor de segurança: deixe vazio ou em branco

2. Clique em Salvar

3. Clique no botão Configurações avançadas

   

4. É aqui que você configurará o esquema de autenticação para usar JWT e apontar para o local do arquivo JWT. Por exemplo:

   AuthScheme=OAuthJWT;InitiateOAuth=GetAndRefresh;OAuthJWTCertType=GoogleJSON;OAuthJWTCert=C:\inetpub\wwwroot\Vinyl\JWT_File_Name.json
   

5. Clique em Salvar

Teste a Conexão¶

Clique no botão Testar conexão em Teste