Como criar um cliente Google OAuth 2.0 para Bencher Self-Hosted
Se você estiver usando o Bencher Cloud, pode simplesmente inscrever-se ou entrar usando o botão Google
.
Para o Bencher Self-Hosted, você precisará ter um plano Bencher Plus Enterprise, criar seu próprio cliente Google OAuth2 e atualizar sua configuração do console e configuração do servidor da API.
Criar um cliente Google OAuth 2.0
- Cadastre-se no Google API Console
- Navegue até a página
Credentials
na barra lateral à esquerda - Crie um
OAuth 2.0 Client ID
- Clique em
➕ Create Credentials
>OAuth client ID
- Configure a tela de consentimento
- Começar
- Informações do app
- Nome do app
- Escolha um nome (ex:
Bencher for My Enterprise
)
- Escolha um nome (ex:
- E-mail de suporte ao usuário
- Escolha um endereço de e-mail
- Nome do app
- Público
Internal
- Disponível apenas para usuários dentro da sua organização. Você não precisará submeter seu app para verificação.
- Informações de contato
- Adicione seu endereço de e-mail
- Esses endereços de e-mail são para o Google notificar você sobre quaisquer alterações no seu projeto.
- Adicione seu endereço de e-mail
- Finalizar
- Concorde com a Google API Services User Data Policy
- Informações do app
- Começar
- Clique em
Create OAuth Client
- Tipo de aplicação
- Selecione
Web application
- Nome
- Escolha um nome (ex:
Bencher for My Enterprise
)
- Escolha um nome (ex:
- Selecione
- Origens JavaScript autorizadas
- Insira a URL do seu Bencher Console (ex:
https://bencher.example.com
)
- Insira a URL do seu Bencher Console (ex:
- URIs de redirecionamento autorizados
- Insira a URL do seu Bencher Console com sufixo
/auth/google
(ex:https://bencher.example.com/auth/google
)
- Insira a URL do seu Bencher Console com sufixo
- Clique em
Create
- Tipo de aplicação
- Cliente OAuth criado
- Anote o
Client ID
(ex:012345-abcd6789envs.apps.googleusercontent.com
) - Anote o
Client Secret
(ex:GOCSPX-abcdefgh1234567890wxyz
) - Clique em
OK
- Anote o
- Clique em
🐰 Clientes Google OAuth inativos podem ser excluídos se não forem usados por 6 meses. Você será notificado sobre a exclusão por inatividade pelo Google e poderá restaurar clientes até 30 dias após a exclusão.
Configuração do cliente Google OAuth
Interface do Console
Defina a variável de ambiente OAUTH_GOOGLE
como true
quando executar a imagem Docker bencher-console
. (ex: OAUTH_GOOGLE=true
)
Se o Client ID estiver ausente, os botões do Google não aparecerão na interface.
Servidor da API
Adicione o client_id
e o client_secret
à seção plus.google
da configuração do servidor.
Se a seção do Google estiver ausente, o servidor irá falhar em qualquer solicitação de autenticação do Google.
🐰 Parabéns! Você aprendeu como configurar um cliente Google OAuth2! 🎉