Introdução
O Usher é um fornecedor de identidade: trata do início de sessão nas suas apps, mantém as contas das pessoas em segurança e diz à sua app quem elas são. Faz tudo isto com OpenID Connect e OAuth 2.1, por isso funciona com as bibliotecas que já usa.
O que o Usher faz
Um arrumador tem duas tarefas à porta: confere o bilhete e indica o lugar. O Usher faz as mesmas duas tarefas pela sua app:
- Autenticação. As pessoas provam quem são no Lobby, a página de início de sessão alojada pelo Usher, com uma chave-passe, um código por e-mail, uma ligação mágica, uma conta social ou uma palavra-passe.
- Autorização. A sua app recebe tokens que dizem quem é a pessoa e o que ela aceitou partilhar, e a sua API pode verificá-los.
As peças
| Peça | O que é |
|---|---|
| O Lobby | A página de início de sessão alojada. Indica sempre a app para onde a pessoa vai. |
| Conta Usher | O que cada pessoa tem: o e-mail, as chaves-passe, o segundo fator e os dispositivos com sessão iniciada. |
| Usher Console | Onde cria projetos e ambientes, regista aplicações e faz a gestão dos utilizadores. |
| SDK e componentes | @usher/nextjs, com <SignIn /> e <UserButton />. Chega com o SDK. |
Como se integra na sua app
Cada ambiente que cria é um emissor OpenID Connect independente, com um endereço próprio:
Emissor
https://<handle>.usherid.comA sua app envia as pessoas para esse emissor para iniciarem sessão e recebe-as de volta com um código, que troca por tokens. É o fluxo normalizado de código de autorização com PKCE, e cada um dos seus passos está descrito no documento de descoberta do emissor:
Documento de descoberta
https://<handle>.usherid.com/.well-known/openid-configurationPor onde começar
Guia rápido: Next.jsAdicione o início de sessão a uma app Next.js com o App Router.
Guia rápido: qualquer biblioteca OIDCAs definições de que qualquer cliente OpenID Connect precisa.
ConceitosEspaços de trabalho, projetos, ambientes, emissores e tokens.
SegurançaComo os ambientes são mantidos separados e como os segredos são selados.