Pular para o conteúdo principal

Entenda o fluxo de autenticação OIDC

O Logto é construído com base nos padrões OAuth 2.0 e OpenID Connect (OIDC). Compreender esses padrões de autenticação tornará o processo de integração mais suave e direto.

Fluxo de autenticação do usuário​

Veja o que acontece quando um usuário faz login com o Logto:

Neste fluxo, vários conceitos-chave são essenciais para o processo de integração:

  • Application: Representa seu aplicativo no Logto. Você criará uma configuração de aplicativo no Logto Console para estabelecer uma conexão entre seu aplicativo real e os serviços do Logto. Saiba mais sobre Application.
  • Redirect URI: Após os usuários concluírem a autenticação na página de login do Logto, o Logto os redireciona de volta para seu aplicativo através deste URI. Você precisará configurar o Redirect URI nas configurações do seu Application. Para mais detalhes, veja Redirect URIs.
  • Handle sign-in callback: Quando o Logto redireciona os usuários de volta para seu aplicativo, seu app precisa processar os dados de autenticação e solicitar tokens de acesso e informações do usuário. Não se preocupe — o SDK do Logto faz isso automaticamente.

Esta visão geral cobre o essencial para uma integração rápida. Para um entendimento mais profundo, confira nosso guia Experiência de login explicada.

Fluxo de autenticação máquina para máquina​

O Logto fornece o tipo aplicativo máquina para máquina (M2M) para permitir autenticação direta entre serviços, com base no fluxo de credenciais do cliente OAuth 2.0:

Este fluxo de autenticação máquina para máquina (M2M) é projetado para aplicativos que precisam se comunicar diretamente com recursos sem interação do usuário (portanto, sem interface gráfica), como um serviço de API atualizando dados de usuário no Logto ou um serviço de estatísticas puxando pedidos diários.

Neste fluxo, os serviços se autenticam usando credenciais do cliente — uma combinação de Application ID e Application Secret que identifica e autentica exclusivamente o serviço. Essas credenciais servem como identidade do serviço ao solicitar tokens de acesso ao Logto.

Fluxo de dispositivo (dispositivos com entrada limitada)​

Para dispositivos com capacidades de entrada limitadas (por exemplo, smart TVs, consoles de jogos, ferramentas CLI, dispositivos IoT), o Logto suporta o OAuth 2.0 Device Authorization Grant. O dispositivo exibe um código e uma URL, enquanto o usuário conclui a autenticação em outro dispositivo com navegador:

Neste fluxo:

  • O dispositivo solicita um código de dispositivo ao Logto, recebendo um user_code curto e um verification_uri.
  • O usuário acessa a URL de verificação em outro dispositivo (celular, laptop), insere o código e faz login.
  • O dispositivo faz polling no endpoint de token até o usuário concluir a autorização, então recebe os tokens.

Diferente do fluxo padrão do usuário, o fluxo de dispositivo não requer Redirect URIs ou capacidades de navegador no próprio dispositivo. Saiba mais no Guia rápido do fluxo de dispositivo.

Fluxo de autenticação SAML​

Além do OAuth 2.0 e OIDC, o Logto também suporta autenticação SAML (Security Assertion Markup Language), atuando como um Provedor de Identidade (IdP) para permitir integração com aplicativos corporativos. Atualmente, o Logto suporta o fluxo de autenticação iniciado pelo SP:

Fluxo iniciado pelo SP​

No fluxo iniciado pelo SP, o processo de autenticação começa a partir do Provedor de Serviço (seu aplicativo):

Neste fluxo:

  • O usuário inicia o processo de autenticação a partir do seu aplicativo (Provedor de Serviço)
  • Seu aplicativo gera uma solicitação SAML e redireciona o usuário para o Logto (Provedor de Identidade)
  • Após autenticação bem-sucedida no Logto, uma resposta SAML é enviada de volta para seu aplicativo
  • Seu aplicativo processa a resposta SAML e conclui a autenticação

Fluxo iniciado pelo IdP​

O Logto oferecerá suporte ao fluxo iniciado pelo IdP em versões futuras, permitindo que os usuários iniciem o processo de autenticação diretamente pelo portal do Logto. Fique atento para novidades sobre esse recurso.

Essa integração SAML permite que aplicativos corporativos utilizem o Logto como seu provedor de identidade, suportando tanto provedores de serviço modernos quanto legados baseados em SAML.

Blog: Aplicativos em nuvem seguros com OAuth 2.0 e OpenID Connect

Por que a autenticação única (SSO) para múltiplos aplicativos é melhor

Por que você precisa de um sistema de identidade centralizado para um negócio com múltiplos aplicativos