Criar um cliente e credenciais OAuth para uma instância do Looker (Google Cloud Core)

Esta página de documentação explica como configurar seu cliente OAuth e associar manualmente as credenciais OAuth à sua instância durante a criação dela.

Quando criar credenciais do OAuth

Os seguintes tipos de instâncias do Looker (Google Cloud Core) exigem que você crie credenciais OAuth e as associe à instância durante a criação dela, mesmo que queira usar um método de autenticação diferente para autenticar seus usuários na instância:

Além disso, se você quiser adicionar um domínio personalizado a uma instância do Looker (Google Cloud Core) que usa conexões seguras públicas, as credenciais do OAuth precisam ser criadas e associadas manualmente à instância ao configurar o domínio personalizado.

As instâncias do Looker (Google Cloud Core) que usam apenas conexões públicas seguras não exigem que você crie ou associe credenciais OAuth à instância. Para esse tipo de instância, o Looker (Google Cloud Core) atribui um cliente e um secret OAuth gerenciados pelo Looker.

Funções exigidas

Para usar o console Google Cloud e criar e editar credenciais OAuth, você precisa das seguintes permissões. Para ocultar a lista de permissões, recolha a seção Permissões necessárias.

Permissões necessárias

  • clientauthconfig.*
    • clientauthconfig.brands.create
    • clientauthconfig.brands.delete
    • clientauthconfig.brands.get
    • clientauthconfig.brands.list
    • clientauthconfig.brands.update
    • clientauthconfig.clients.create
    • clientauthconfig.clients.createSecret
    • clientauthconfig.clients.delete
    • clientauthconfig.clients.get
    • clientauthconfig.clients.getWithSecret
    • clientauthconfig.clients.list
    • clientauthconfig.clients.listWithSecrets
    • clientauthconfig.clients.undelete
    • clientauthconfig.clients.update
  • oauthconfig.*
    • oauthconfig.clientpolicy.get
    • oauthconfig.testusers.get
    • oauthconfig.testusers.update
    • oauthconfig.verification.get
    • oauthconfig.verification.submit
    • oauthconfig.verification.update

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos. Para mais informações sobre a concessão de papéis, consulte a página Gerenciar o acesso a projetos, pastas e organizações na documentação do Identity and Access Management (IAM).

Antes de criar uma instância do Looker (Google Cloud Core)

Antes de criar uma instância do Looker (Google Cloud Core), conclua as etapas descritas nestas seções:

Gerar o ID e a chave secreta do cliente OAuth

Primeiro, crie um cliente OAuth e gere o ID do cliente e a chave secreta do cliente para esse cliente. Esses valores são necessários durante a criação da instância do Looker (Google Cloud Core).

É possível configurar o cliente OAuth em qualquer projeto Google Cloud . Não precisa ser o mesmo projeto da instância do Looker (Google Cloud Core). No entanto, a API Looker (Google Cloud core) precisa ser ativada nesse projeto.

Para criar o cliente e as credenciais dele, siga estas etapas:

  1. Acesse o projeto em que você quer criar o cliente OAuth.
  2. Acesse APIs e serviços > Credenciais.
  3. Na página Credenciais, clique em Criar credenciais.
  4. No menu suspenso, selecione ID do cliente OAuth.
  5. No menu suspenso Tipo de aplicativo, selecione Aplicativo da Web.
  6. No campo Nome, insira um nome para o cliente OAuth.
  7. Neste momento, não é necessário adicionar URIs nas seções Origens JavaScript autorizadas ou URIs de redirecionamento autorizados.
  8. Clique em Criar.

Depois de clicar em Criar, uma janela Cliente OAuth criado vai aparecer. Essa janela mostra o ID e a chave secreta do cliente criados para seu cliente OAuth. Esses valores serão necessários quando você criar a instância do Looker (Google Cloud Core).

Se quiser, clique em Fazer o download do JSON para baixar as informações de credencial em um arquivo JSON. Para fechar a janela, clique em OK.

Em seguida, configure a tela de permissão. A tela de permissão é mostrada a um usuário da instância do Looker (Google Cloud Core) no primeiro login e em qualquer momento em que a autorização expirar ou for revogada pelo usuário.

Siga as instruções na página de documentação Configurar a tela de permissão OAuth e escolher escopos. Ao configurar a tela, preencha as seguintes configurações conforme descrito:

  • Na seção Branding, em Domínios autorizados, o domínio precisa corresponder ao da instância do Looker (Google Cloud Core) que usa as credenciais OAuth. Se você for criar um domínio personalizado para sua instância do Looker (Google Cloud Core) e souber o domínio que vai atribuir a ela, insira-o agora. Caso contrário, deixe esse campo em branco. Ele será preenchido automaticamente quando você adicionar o URI de redirecionamento autorizado depois que a instância do Looker (Google Cloud Core) for criada.

  • Na seção Público-alvo, em Tipo de usuário, selecione uma das seguintes opções:

Durante a criação da instância do Looker (Google Cloud Core)

Ao criar a instância do Looker (Google Cloud Core), adicione o ID e a chave secreta do cliente OAuth na seção Credenciais do aplicativo OAuth. Não é possível criar uma instância sem credenciais do OAuth. Para encontrar o ID e a chave secreta do cliente OAuth, navegue até o cliente OAuth no console do Google Cloud .

Depois de criar uma instância do Looker (Google Cloud Core)

Siga as instruções abaixo para concluir a configuração. Quando você adiciona um URI de redirecionamento autorizado, ele é incluído na tela de permissão OAuth como um domínio autorizado.

Adicionar o URI de redirecionamento autorizado ao cliente OAuth

Se ainda não tiver feito isso, siga estas etapas para inserir o URL da instância recém-criada do Looker (Google Cloud Core) no cliente OAuth.

  1. Depois de criar uma instância do Looker (Google Cloud Core), encontre e copie o URL dela. Você pode encontrar o URL na página Instâncias.

  2. No console Google Cloud , acesse APIs e serviços > Credenciais.

  3. No título IDs do cliente OAuth 2.0, clique no nome do cliente que você criou.

  4. Na seção URIs de redirecionamento autorizados, clique em Adicionar URI.

  5. Cole o URL da instância do Looker (Google Cloud Core) no campo URIs. Adicione /oauth2callback ao final do URL. Por exemplo: https://uuid.looker.app/oauth2callback.

    Se você for configurar a autorização do OAuth para o BigQuery, também poderá adicionar um segundo URI de redirecionamento que aponta para o URL da instância do Looker (Google Cloud Core) seguido por /external_oauth/redirect adicionado ao final do URL. Por exemplo: https://uuid.looker.app/external_oauth/redirect.

  6. Clique em Salvar.

A atualização pode levar de cinco minutos a algumas horas para entrar em vigor.

Gerenciar usuários

Depois que o cliente OAuth for configurado e a instância do Looker (Google Cloud Core) for criada, você poderá fazer login nela usando o OAuth. Em seguida, escolha o método de autenticação para sua instância.

Se você usa o OAuth como método de autenticação principal, siga as etapas descritas na página de documentação Usar o OAuth do Google para autenticação de usuários do Looker (Google Cloud Core) e conclua a configuração do OAuth para autenticação de usuários.

Depois de configurar o método de autenticação, você pode adicionar ou remover usuários pelo provedor de identidade e gerenciá-los no Looker.

Ver o tipo de credenciais do OAuth da sua instância

As credenciais do OAuth não são listadas diretamente na página de configuração da instância do console do Google Cloud . Clique em Editar na página de configuração da instância para ver a seção Credenciais do aplicativo OAuth.

Se as credenciais OAuth estiverem definidas como Gerenciadas pelo Looker, o Looker (Google Cloud Core) vai atribuir credenciais OAuth gerenciadas pelo Looker à sua instância durante a criação dela, e o ID do cliente e a chave secreta do cliente não serão mostrados.

Se as credenciais do OAuth estiverem definidas como Manual, credenciais personalizadas foram adicionadas à sua instância durante ou após a criação dela. O ID e a chave secreta do cliente não são mostrados. Em vez disso, a seção exibe marcadores de posição ****.

Editar o cliente OAuth de uma instância do Looker (Google Cloud Core)

Se quiser, siga estas etapas para adicionar, editar ou mudar as credenciais do OAuth da sua instância do Looker (Google Cloud Core):

  1. Configure o novo cliente ou as credenciais.
  2. No console do Google Cloud , na página Instâncias, clique no nome de uma instância para abrir a página DETALHES.
  3. Na página DETALHES, clique em Editar.
  4. Na página Editar instância do Looker (Google Cloud Core), navegue até a seção Credenciais do aplicativo OAuth e selecione Manual, se ainda não estiver selecionado.
  5. Insira os novos valores nos campos ID do cliente OAuth e Chave secreta do cliente OAuth.
  6. Clique em Salvar.

Se as credenciais do seu aplicativo OAuth estiverem definidas como Gerenciadas pelo Looker, não será possível adicionar ou editar credenciais. Mude para a configuração Manual para editar ou adicionar credenciais.

A seguir