Configurações de administrador: gerenciar clientes OAuth

No Looker, os administradores podem usar a página Gerenciar clientes OAuth para gerenciar o acesso OAuth 2.0 baseado em identidade para aplicativos externos sem criar chaves de API ou usar o API Explorer. Neste documento, descrevemos como ativar aplicativos pré-configurados, registrar clientes OAuth personalizados e gerenciar a revogação de tokens.

A página Gerenciar clientes OAuth está localizada na seção Autenticação do painel Administrador do Looker. Ele oferece uma interface centralizada para conceder acesso a ferramentas para desenvolvedores, como a CLI do Looker, clientes do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) de agentes de IA e conectores de business intelligence (BI).

Observação: se você tiver uma permissão que dá acesso apenas a algumas páginas no painel de admin, como manage_schedules, manage_themes ou see_admin, mas não tiver a função de administrador, as páginas descritas aqui talvez não apareçam para você no painel de admin.

Requisitos

Para acessar e gerenciar a página Gerenciar clientes OAuth, os seguintes requisitos precisam ser atendidos:

• Sua instância do Looker precisa ser hospedada pelo Looker. As instâncias do Looker hospedadas pelo cliente não são compatíveis.
• Você precisa ter o papel de administrador na sua instância do Looker.

Visão geral

A página Gerenciar clientes OAuth organiza os aplicativos cliente em duas guias:

• Biblioteca de aplicativos: um catálogo de aplicativos OAuth pré-configurados e gerenciados pelo Looker, incluindo clientes do Protocolo de Contexto de Modelo (MCP) de agentes de IA, conectores de Business Intelligence (BI) e ferramentas para desenvolvedores.
• Clientes personalizados: uma interface de gerenciamento para registrar e configurar seus próprios aplicativos cliente OAuth personalizados com URIs de redirecionamento de callback personalizáveis e controles de acesso de grupo.

Uma barra de pesquisa na parte de cima da página permite filtrar aplicativos nas duas guias em tempo real.

Guia "Biblioteca de aplicativos"

A guia Biblioteca de aplicativos contém clientes OAuth pré-configurados que são mantidos pelo Looker. Recomendamos que você verifique a guia Biblioteca de aplicativos antes de criar um cliente personalizado. Se a ferramenta que você quer conectar já estiver pré-configurada na biblioteca, será possível ativá-la sem registrar um novo cliente personalizado, a menos que você precise de um URI de redirecionamento ou uma porta diferente.

A biblioteca de aplicativos inclui clientes pré-configurados para as seguintes integrações:

• Clientes MCP de agentes de IA: Cursor, VS Code, Claude Code, Claude Desktop, ChatGPT, CLI do Gemini, Cline, Windsurf, Antigravity e a extensão do Looker para VS Code.
• Conectores de BI: páginas conectadas, Data Studio, Tableau Desktop, Microsoft Power BI e Microsoft Excel.
• Ferramentas para desenvolvedores: CLI do Looker.

Como ativar e desativar aplicativos de biblioteca

Cada aplicativo cliente pré-configurado na Biblioteca de Aplicativos tem uma chave Ativar:

• Ativar: ative a chave para permitir que os usuários se autentiquem no Looker usando o OAuth no aplicativo cliente.
• Desativar: desative a chave para bloquear as solicitações de autorização desse aplicativo cliente. A desativação de um aplicativo revoga e invalida imediatamente todos os tokens OAuth ativos que foram emitidos para os usuários desse aplicativo.

Observação: não é possível excluir os aplicativos pré-configurados na Biblioteca de aplicativos. Eles só podem ser ativados ou desativados.

O ID do cliente de cada aplicativo cliente pré-configurado é exibido na linha correspondente. É possível copiar o ID do cliente para usar em configurações do lado do cliente, mas o ID do cliente para aplicativos de biblioteca é imutável e não pode ser modificado.

Sincronização com a página "Conectores de BI"

O status de ativação dos conectores de BI (incluindo as páginas conectadas, o Data Studio, o Tableau Desktop, o Microsoft Power BI e o Microsoft Excel) é sincronizado automaticamente entre as páginas Gerenciar clientes OAuth e Conectores de BI:

• Mudar o status de ativação de uma chave de conector de BI na página Gerenciar clientes OAuth atualiza automaticamente a chave correspondente na página Conectores de BI.
• Mudar o status de ativação de uma chave de conector de BI na página Conectores de BI atualiza automaticamente o status na página Gerenciar clientes OAuth.

Observação: a página Conectores de BI continua disponível para configurar a opção de saída Ativar o link rápido das Páginas Conectadas.

URIs de redirecionamento e configurações de porta dinâmica

O Looker exige que os URIs de redirecionamento do OAuth correspondam exatamente aos valores registrados e não aceita URIs de redirecionamento com caracteres curinga.

• Conectores de BI padrão: use URIs de redirecionamento pré-configurados e imutáveis que correspondam aos endpoints de autenticação oficiais do serviço.
• Agente de IA e clientes MCP: algumas ferramentas de IA usam portas locais dinâmicas ou temporárias por padrão ao iniciar um redirecionamento OAuth (como Claude Code ou Cline). Para acomodar essas ferramentas, o Looker pré-registra uma porta padrão fixa para cada cliente de biblioteca (por exemplo, a porta 8080 para o Claude Code e o Cline ou a porta 7777 para a CLI do Gemini).

Para usar um cliente de biblioteca pré-configurado que exige uma porta fixa, escolha uma das seguintes opções:

1. Configure o cliente para usar a porta estática pré-registrada: nas configurações do aplicativo cliente ou nas flags de inicialização, especifique a porta pré-registrada (por exemplo, execute o Claude Code com --callback-port 8080).
2. Registrar um cliente personalizado: se você quiser usar uma porta diferente ou um URL de callback personalizado, registre um novo cliente na guia Clientes personalizados com o URI de redirecionamento de sua preferência.

Guia "Clientes personalizados"

Na guia Clientes personalizados, você pode registrar e administrar aplicativos cliente OAuth 2.0 personalizados para ferramentas internas, integrações proprietárias ou aplicativos de terceiros que não estão disponíveis na biblioteca de aplicativos.

Registrar um cliente OAuth personalizado

Para registrar um novo cliente OAuth personalizado, siga estas etapas:

1. No painel Admin, acesse a seção Authentication e selecione Manage OAuth Clients.
2. Selecione a guia Clientes personalizados.
3. Clique em Add New.
4. No painel lateral, preencha os seguintes campos:
   • ID do cliente: insira um identificador de string exclusivo para o aplicativo. O ID do cliente não pode começar com com.looker., que é reservado para aplicativos gerenciados pelo Looker.
   • Nome do cliente: insira um nome de exibição descritivo para o aplicativo.
   • Descrição (opcional): insira uma breve descrição explicando a finalidade do aplicativo.
   • URIs de redirecionamento: insira um ou mais URIs de callback autorizados (por exemplo, https://mycompany.com/oauth/callback ou http://localhost:8080/callback). É possível inserir vários URIs de redirecionamento para oferecer suporte a diferentes ambientes ou portas.
   • Restringir ao ID do grupo (opcional): insira o ID numérico de um grupo de usuários do Looker. Se um ID numérico for especificado, somente os usuários que pertencem a esse grupo poderão autorizar e autenticar no Looker usando esse aplicativo.
5. Clique em Adicionar para criar o cliente personalizado.

Como ver os detalhes do cliente

Para ver informações detalhadas sobre qualquer aplicativo cliente personalizado, siga estas etapas:

1. Na guia Clientes personalizados, clique no ícone de divisa chevron_right na linha do cliente na tabela.
2. Um painel lateral é aberto, mostrando o nome do cliente, o ID do cliente, a descrição, a lista completa de URIs de redirecionamento autorizados e, se configuradas, as restrições de ID do grupo.

Editar um cliente personalizado

Para atualizar um aplicativo cliente OAuth personalizado, siga estas etapas:

1. Na guia Clientes personalizados, localize o aplicativo cliente e clique no ícone edit Editar na linha dele.

2. No painel lateral de edição, atualize os campos Nome do cliente, Descrição, URIs de redirecionamento ou Restringir ao ID do grupo, conforme necessário.

   Observação: o campo ID do cliente não pode ser modificado após o registro. Se você precisar mudar o ID do cliente, exclua o cliente e registre um novo.

3. Clique em Update to save your changes.

Como excluir um cliente personalizado

Para remover um aplicativo cliente OAuth personalizado, siga estas etapas:

1. Na guia Clientes personalizados, localize o aplicativo cliente e clique no ícone delete Excluir (lixeira) na linha dele.
2. Na caixa de diálogo de confirmação, clique em Excluir.

Aviso: excluir um cliente personalizado remove permanentemente o registro do cliente do Looker e invalida imediatamente todos os códigos de autorização do OAuth, tokens de acesso e tokens de atualização ativos que foram emitidos para esse aplicativo.

Invalidação e segurança de tokens

Para manter a segurança em todos os aplicativos conectados, o Looker aplica automaticamente a revogação de tokens. Quando um administrador exclui um aplicativo cliente personalizado ou desativa um aplicativo na guia Biblioteca de aplicativos ou Clientes personalizados, o Looker revoga imediatamente todos os tokens de atualização do OAuth ativos que foram emitidos para todos os usuários desse aplicativo. Todos os códigos de autorização associados a esse aplicativo são invalidados permanentemente.

Observação : nos casos de exclusão ou desativação de um aplicativo, não é possível gerar novos tokens de acesso, e os tokens de acesso já emitidos expiram em 60 minutos.

Se um usuário ou aplicativo tentar se conectar usando credenciais revogadas, o Looker vai negar a autorização e retornar um erro indicando que o cliente OAuth não foi encontrado ou não está ativado.