Autenticação (Logto)
Autenticação gerenciada compatível com OIDC, com login social, tokens JWT e um console de administração completo.
Criar um servidor de autenticação
Para criar uma nova instância de autenticação:
- Acesse a seção Servidores de autenticação no dashboard do sh0.
- Clique em Criar servidor auth.
- Digite um nome para sua instância de autenticação (por exemplo, “my-app-auth”).
- Selecione o servidor de banco de dados PostgreSQL ao qual conectá-la.
- Clique em Criar. O sh0 implanta uma instância do Logto com SSL automático.
my-app-auth.sh0.app). Escolha um nome descritivo.Conexão ao PostgreSQL
Cada instância do Logto exige um servidor de banco de dados PostgreSQL para armazenar dados de usuários, sessões e configuração. O sh0 automaticamente:
- Cria um banco de dados dedicado no seu servidor PostgreSQL.
- Configura a string de conexão para o Logto.
- Executa as migrações iniciais do Logto.
Os dados dos seus usuários nunca saem do seu servidor. Eles ficam armazenados na mesma instância PostgreSQL que você controla.
Console de administração
Cada instância do Logto inclui um console de administração completo, acessível no seu domínio de autenticação. No console, você pode:
- Gerenciar usuários (criar, editar, excluir, redefinir senhas).
- Configurar a experiência de login (identidade visual, cores, logotipo).
- Configurar aplicações e suas URIs de redirecionamento.
- Adicionar conectores de login social (Google, GitHub etc.).
- Visualizar logs de auditoria e a atividade das sessões.
- Ativar a autenticação multifator (MFA, baseada em TOTP).
Métodos de login
O Logto oferece suporte nativo a vários métodos de login:
| Método | Descrição |
|---|---|
| E-mail + senha | E-mail e senha tradicionais, com verificação de e-mail |
| Sem senha (e-mail) | Link mágico ou código de verificação por e-mail |
| Login social | Google, GitHub, Apple, Discord e outros |
| Telefone + SMS | Código de verificação por SMS (requer um conector de SMS) |
Conectores sociais
Para adicionar um provedor de login social, abra o console de administração do Logto, acesse Conectores e adicione um novo conector social. Você precisará do ID do cliente e do segredo OAuth do provedor (por exemplo, Google Cloud Console, GitHub Developer Settings).
Integração de SDKs
O Logto oferece SDKs oficiais para os frameworks mais populares:
| Plataforma | Pacote |
|---|---|
| Navegador (SPA) | @logto/browser |
| React | @logto/react |
| Next.js | @logto/next |
| Vue | @logto/vue |
| Node.js (Express) | @logto/express |
| Python | logto-sdk-python |
A integração básica exige dois valores de configuração: o endpoint (seu domínio de autenticação) e o appId (obtido no console de administração do Logto).
Verificação de JWT
O Logto emite tokens OIDC padrão (token de acesso, token de ID, token de atualização). Para verificar os tokens na sua API:
- Obtenha o JWKS em
https://<your-auth>.sh0.app/oidc/.well-known/openid-configuration. - Verifique a assinatura do token usando a chave pública.
- Verifique as claims
iss,audeexp.