Como configurar as Credenciais Google no Lúmina Orbe
Entenda quais informações são necessárias para conectar o Lúmina Orbe aos serviços Google, onde encontrar cada credencial e como configurar corretamente o processo de autenticação OAuth.
Alguns recursos avançados do Lúmina Orbe podem utilizar serviços de terceiros, como APIs de IA, serviços Google ou serviços de mapas. Essas conexões são configuradas pelo próprio cliente, e eventuais custos cobrados pelos respectivos provedores são de responsabilidade do cliente.
O que é necessário para a configuração?
Caso o administrador opte por utilizar os recursos Google disponibilizados pelo Lúmina Orbe, a integração utiliza credenciais fornecidas pelo Google Cloud e uma autorização OAuth para estabelecer a comunicação segura entre o site e os serviços Google correspondentes.
O Google Cloud é um serviço externo administrado pelo próprio Google. O Lúmina Orbe não fornece uma conta Google Cloud nem cria ou administra as credenciais utilizadas pelo cliente.
Na configuração do Lúmina Orbe, o administrador poderá encontrar os campos necessários para informar as credenciais da aplicação e a propriedade do Google Analytics 4, quando esse recurso for utilizado.
Onde criar as credenciais?
Quando o cliente optar por utilizar uma integração Google, as credenciais correspondentes são criadas no ambiente Google Cloud. O administrador deve utilizar um projeto Google Cloud associado à conta que realizará a integração.
O administrador cria e administra a aplicação no Google Cloud e depois informa ao Lúmina Orbe os dados necessários para estabelecer a conexão. A conta e a utilização dos serviços Google permanecem sob responsabilidade do próprio cliente.
Client ID e Client Secret
O Client ID e o Client Secret pertencem à aplicação OAuth criada no Google Cloud. Eles identificam a aplicação que solicitará autorização para acessar os serviços Google correspondentes.
Projeto Google Cloud
Selecione ou crie o projeto Google Cloud que será utilizado pela integração.
APIs e serviços
Habilite os serviços Google necessários para a integração utilizada pelo Lúmina Orbe.
Credencial OAuth
Crie uma credencial do tipo OAuth adequada à aplicação que realizará a autenticação.
Dados da aplicação
O Google disponibilizará o Client ID e o Client Secret associados à credencial.
Não publique o Client Secret em páginas públicas, documentos acessíveis ao público ou código-fonte exposto no navegador.
Como encontrar o GA4 Property ID?
O GA4 Property ID identifica a propriedade do Google Analytics 4 que será utilizada pelo Lúmina Orbe, caso o cliente opte por utilizar os recursos correspondentes.
Ele não deve ser confundido com o Measurement ID utilizado em determinadas configurações de acompanhamento. O campo do Lúmina Orbe solicita especificamente o Property ID.
Ele é obtido dentro da administração da propriedade correspondente no Google Analytics. Essa propriedade pertence à conta Google administrada pelo próprio cliente.
Como funciona o OAuth Google?
O OAuth é o mecanismo utilizado para permitir que o administrador autorize o Lúmina Orbe a acessar os recursos Google correspondentes à integração.
O processo não exige que a senha da conta Google seja armazenada pelo Lúmina Orbe. A autorização ocorre dentro do ambiente do Google.
O Client ID e o Client Secret identificam a aplicação. O OAuth conduz o processo de autorização entre essa aplicação e a conta Google.
O que é a Redirect URI?
A Redirect URI é o endereço para o qual o Google retorna o usuário depois que o processo de autorização OAuth é concluído.
No Lúmina Orbe, esse endereço é gerado automaticamente pelo próprio sistema por meio da estrutura de autenticação Google.
Não altere caracteres, parâmetros ou o endereço apresentado na tela de configuração.
Na credencial OAuth criada no Google Cloud, a Redirect URI deverá ser cadastrada no campo correspondente às URIs de redirecionamento autorizadas.
Esse endereço corresponde à estrutura de callback utilizada atualmente pelo Lúmina Orbe.
Onde inserir as informações?
Depois de criar as credenciais no Google Cloud e identificar a propriedade GA4, os dados devem ser informados na área de configuração Google do Lúmina Orbe, caso o administrador opte por utilizar essa integração.
Client ID
Informe o Client ID fornecido pelo Google Cloud.
Client Secret
Informe o Client Secret associado à mesma credencial OAuth.
GA4 Property ID
Informe o identificador da propriedade Google Analytics 4 correspondente.
Salvar
Salve as configurações para que o Lúmina Orbe possa utilizar as credenciais informadas.
Depois da configuração: autorizar o Google
Com as credenciais configuradas, o Lúmina Orbe poderá iniciar o processo de autorização OAuth.
Ao selecionar a opção para conectar o Google, o administrador será direcionado ao ambiente de autenticação do Google.
A existência das credenciais OAuth, por si só, não concede acesso às propriedades. As permissões correspondentes precisam estar disponíveis para a conta que realiza a autorização.
Conferindo se a configuração está correta
Antes de concluir a configuração, confira os principais pontos da integração.
- O projeto correto foi selecionado no Google Cloud.
- As APIs necessárias estão habilitadas.
- O Client ID pertence à credencial OAuth utilizada.
- O Client Secret corresponde ao mesmo Client ID.
- O GA4 Property ID corresponde à propriedade Google Analytics correta.
- A Redirect URI foi cadastrada exatamente como apresentada pelo Lúmina Orbe.
- A conta Google possui as permissões necessárias.
Por isso, quando a conexão não for estabelecida, a primeira verificação deve ser a correspondência entre as credenciais, a Redirect URI, o projeto Google Cloud e a conta utilizada na autorização.
Acessos rápidos aos serviços Google
Os links abaixo direcionam o administrador diretamente aos ambientes oficiais utilizados durante a configuração. Esses serviços pertencem ao Google e são administrados pelo próprio cliente.
Em resumo
A integração com serviços Google é opcional no Lúmina Orbe. Caso o administrador opte por utilizar esses recursos, as credenciais são criadas no Google Cloud e administradas pelo próprio cliente.
O administrador poderá precisar informar o Client ID, o Client Secret e o GA4 Property ID, conforme o recurso Google utilizado. A Redirect URI é fornecida pelo Lúmina Orbe e deve ser cadastrada exatamente como apresentada na configuração OAuth.
Depois dessas etapas, a autorização OAuth permite que a conta Google conceda ao Lúmina Orbe acesso aos recursos correspondentes, respeitando as permissões definidas pelo próprio Google.