Configuração da autenticação OAuth para Google Cloud Platform (GCP)¶

Sobre a autenticação de cliente OAuth fornecida pelo cliente¶

Um aplicativo que se autentica no Google usando OAuth 2.0 precisa fornecer dois objetos no GCP:

• A tela de consentimento do OAuth que informa aos usuários quem está solicitando acesso aos seus dados e que tipo de dados os usuários estão permitindo que seu aplicativo acesse.

• ID do cliente OAuth usado para autenticar um aplicativo no Google. Isso é necessário quando você deseja acessar recursos de propriedade do seu usuário final.

Para a versão preliminar privada do Snowflake Connector for Google Analytics Raw Data, você deve fornecer sua própria tela de consentimento do OAuth e o ID do cliente para autenticação. Em uma versão futura, a tela de consentimento será fornecida.

Pré-requisitos¶

Para fornecer a tela de consentimento do OAuth e o ID do cliente OAuth, você deve primeiro criar um projeto do Google Cloud Platform (GCP). Consulte a documentação GCP para saber como criar um projeto GCP.

Configuração da tela de consentimento do OAuth¶

1. Para abrir o criador da tela de consentimento do OAuth, selecione APIs & Services » OAuth consent screen em seu projeto GCP.

2. Selecione o tipo de usuário.

   Você poderá selecionar o tipo de usuário Internal somente se o projeto GCP pertencer a uma organização e os usuários do conector forem membros da mesma organização.

   O tipo de usuário External faz com que a autenticação expire em sete dias. Se você escolher esse tipo, será necessário renovar a autenticação semanalmente.

3. Selecione Create.

4. Forneça a seguinte informação:

   • Nome do aplicativo: Conector Snowflake para dados brutos do Google Analytics

   • E-mail de suporte ao usuário: seu endereço de e-mail

   • Informações de contato do desenvolvedor: seu endereço de e-mail

5. Selecione Save and continue.

6. Selecione Add or remove scopes » Manually add scopes. Copie os seguintes endereços:

   https://www.googleapis.com/auth/bigquery.readonly
   https://www.googleapis.com/auth/cloudplatformprojects.readonly
   

   Copy

7. Para adicionar os escopos, cole cada endereço em uma caixa de diálogo e selecione Add to table.

8. Selecione Update.

Para o tipo de usuário External:

1. Selecione Test users » Add users.

2. Insira os endereços de e-mail dos usuários que têm permissão para usar o conector.

3. Selecione Add.

Para finalizar a configuração, selecione Save and continue » Back to dashboard.

Configuração do ID do cliente OAuth¶

O procedimento a seguir descreve como configurar o ID do cliente OAuth:

1. Para abrir o criador da tela de consentimento do OAuth, selecione APIs & Services » Credentials em seu projeto GCP.

2. Selecione Create credentials » OAuth client ID.

3. Na lista suspensa Application type, selecione Web application.

4. Na caixa Name, insira o seguinte nome: Conector Snowflake para dados brutos do Google Analytics ID.

5. Selecione Authorized redirect URIs » Add URI.

6. Na interface Snowflake Connector for Google Analytics Raw Data, vá para a terceira etapa da configuração do conector: Authentication. Escolha OAuth2 e copie o valor da caixa Redirect URL.

7. Volte para a interface do GCP e cole o valor na caixa de URI.

8. Selecione Create.

9. Copie os valores Your Client ID e Your Client Secret.

10. Cole os valores nas caixas correspondentes na interface do Snowflake Connector for Google Analytics Raw Data.

11. Selecione Sign in.

Como evitar a expiração da sessão da tela de consentimento do OAuth¶

O procedimento a seguir descreve como evitar a expiração da sessão da tela de consentimento do OAuth:

1. No menu do Google Admin Console, selecione Security » Access and data control » Google Cloud session control.

2. Na seção Reauthentication policy, marque a caixa de seleção Exempt Trusted apps.

3. No menu do Google Admin Console, selecione Security » API Controls » App Access Control.

4. Na seção Configured apps, selecione Add app » OAuth App Name Or Client ID.

5. Copie o ID do cliente criado em Configuração do ID do cliente OAuth e cole-o na caixa.

6. Selecione Search.

7. Selecione o nome do aplicativo Snowflake Connector for Google Analytics Raw Data.

8. Marque a caixa de seleção OAuth Client ID criada e clique em Select.

9. Na seção Scope, selecione All users.

10. Selecione Continue.

11. Na seção Access to Google Data, selecione Trusted.

12. Selecione Continue.

13. Na tela Review, selecione Finish.