Pular para o conteúdo

Introdução

O Authio é uma plataforma de identidade e acesso construída sobre OpenID Connect e OAuth 2.0: login, tokens e controle de acesso para as suas aplicações e APIs, hospedados para você.

O Authio cuida de tudo entre uma pessoa e a sua aplicação: as telas de login, passkeys e multifator, as sessões, os tokens em que as suas APIs confiam e as regras que decidem quem pode fazer o quê. Você configura tudo no console, conecta as suas aplicações com um cliente OpenID Connect padrão ou com um dos nossos SDKs, e o Authio faz o resto.

Tudo é organizado em realms. Um realm é um tenant isolado, com usuários, aplicações, chaves de assinatura, sessões e políticas próprios, de modo que produção, homologação e cada um dos seus clientes convivem lado a lado sem enxergar uns aos outros.

Como ele se encaixa na sua arquitetura

  1. A sua aplicação envia a pessoa ao Authio

    Quando alguém clica em Entrar, a sua aplicação redireciona a pessoa para o login hospedado do realm com um pedido de autorização padrão (fluxo authorization code com PKCE).

  2. O Authio autentica a pessoa

    O login hospedado executa os passos que você configurou para aquele client — senha, passkey, código de uso único, aprovação por push no celular — e aplica as políticas do realm no caminho.

  3. A sua aplicação recebe os tokens

    O Authio devolve o navegador com um código que a sua aplicação troca por um ID token (quem é a pessoa), um access token (o que ela pode chamar) e, quando você pede, um refresh token.

  4. As suas APIs validam o access token

    Cada API confere a assinatura do token contra as chaves públicas do realm (JWKS), a audiência e os escopos ou papéis. Para um token válido, não é preciso chamar o Authio.

Os blocos de construção

ConceitoO que é
ContaA sua empresa no Authio: a assinatura, a equipe que a administra e todos os realms dela.
RealmUm tenant isolado, com emissor, chaves, usuários, clients e políticas próprios.
ClientUma aplicação que faz login de pessoas ou chama APIs: aplicação web, SPA, app mobile, serviço.
UsuárioUma pessoa que entra em um realm. Uma conta por pessoa em cada realm, compartilhada por todos os clients daquele realm.
Papéis e escoposO que um usuário ou uma aplicação pode fazer, levado nos tokens que o Authio emite.
OrganizaçãoUm grupo de usuários dentro de um realm — em geral um dos seus clientes B2B — com membros e papéis próprios.
Servidor de recursoUma API para a qual os tokens são emitidos, identificada pela sua audiência.

Cada um deles é explicado em Conceitos principais.

Plataforma compartilhada ou ambiente dedicado

A maioria das equipes usa o Authio na plataforma compartilhada: você se cadastra, começa um trial de 14 dias sem cartão e já cria realms. Equipes que precisam de infraestrutura própria escolhem o plano Dedicado: o Authio provisiona um ambiente completo — API, console, banco de dados e cache — só para aquela conta, em domínio próprio, e o console passa a ser o lugar de acompanhar e operar esse ambiente.

Os dois rodam o mesmo produto. Tudo nesta documentação vale para ambos, e a seção Ambiente dedicado cobre o que é específico de operar o seu.

Para onde ir agora

Cookies de analytics

Gostaríamos de medir como o console é usado, com o Google Analytics, para enxergar em quais telas as pessoas travam. Isso grava um cookie que reconhece este navegador na sua próxima visita.

Recusar não muda mais nada. Os cookies que mantêm você conectado e lembram o seu idioma e o seu tema são necessários para o console funcionar, e ficam de qualquer forma. Ler a Política de Privacidade