> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido de autenticação: primeiro login em 10 minutos

> Ative a Autenticação Didit em uma aplicação sandbox, faça login com a página hospedada e verifique o token de acesso no seu servidor.

Este guia de início rápido coloca o Didit Authentication para funcionar de ponta a ponta em cerca de 10 minutos.
Você registra uma URL de retorno em uma aplicação sandbox, ativa um método de login, autentica uma pessoa com a página de login hospedada, verifica o token de acesso dela no seu servidor e vê o login no console.

## Pré-requisitos

* Uma conta Didit com uma aplicação Sandbox. Criar uma conta é gratuito, e toda aplicação Sandbox tem Autenticação ativada.
* Node.js 20 ou superior, e um aplicativo web que você possa executar em `http://localhost:3000`.

## Steps

**1. Abra sua aplicação de sandbox**

No [Business Console](https://business.didit.me), use o seletor de aplicações para escolher sua aplicação **Sandbox** e depois abra **Authentication**.

Uma aplicação Sandbox aceita callbacks em `http://localhost` e as credenciais de teste da Didit para login social, e nunca é cobrada.
Uma aplicação de produção ativa o Authentication pela página **Products**: veja [preparar sua aplicação](https://docs.didit.me/pt-br/authentication/overview.md#prepare-sua-aplicação).

**2. Registre seu callback e sua origem**

Abra **Authentication > Security and sessions > Redirect URLs and allowed origins** e adicione:

| Item | Valor |
| - | - |
| Redirect URL | `http://localhost:3000/auth/callback` |
| Allowed origin | `http://localhost:3000` |

A Didit só redireciona uma pessoa para uma URL de redirecionamento que você registrou, caractere por caractere.
A origem permitida possibilita que o navegador troque o código com a origem da Didit da sua aplicação.

![O cartão Redirect URLs and allowed origins no Didit Business Console, ao lado da lista de permissões e de bloqueios e da URL de login](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

Redirect URLs and allowed origins, em Authentication > Security and sessions.

**3. Ative um método de login**

Abra **Authentication > Sign-in methods** e ative **Email code**.
Uma aplicação nova começa com todos os métodos desativados, e a página hospedada oferece apenas os métodos que você ativar.

Adicione também **Passkeys**, se quiser, ou um método de login social com as **credenciais de teste da Didit**, que funcionam no Sandbox sem um aplicativo próprio.
Cada método é descrito em [métodos de login](https://docs.didit.me/pt-br/authentication/sign-in-methods.md).

![A página Sign-in methods no Didit Business Console, com o cartão da página de login hospedada, os métodos sem senha e com senha e uma prévia ao vivo da página hospedada](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

Authentication > Sign-in methods, com uma prévia ao vivo da página hospedada.

**4. Copie sua chave publicável**

Abra **Authentication > Developers** e copie a **Publishable key**.
Em uma aplicação Sandbox, ela começa com `pk_test_`.

A chave publicável é pública e identifica a origem de login da Didit da sua aplicação.
Nunca coloque a **Secret key** em código de navegador ou de aplicativo móvel.

**5. Instale o SDK e faça login**

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

Clique no seu botão: a página hospedada pede um endereço de e-mail e envia um código de seis dígitos.
Digite o código, e a Didit redireciona você de volta ao seu callback, que troca o código de uso único pelos tokens da sessão.
No primeiro login, uma conta é criada para um endereço que ainda não tenha uma conta, porque a política padrão de cadastro permite que qualquer pessoa se cadastre.

![A página de login hospedada em um celular, com um botão de passkey e campos de e-mail e senha](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

A página de login hospedada em um celular. Ela mostra apenas os métodos que você ativou.

**6. Verifique o token no seu servidor**

Envie o token de acesso de `auth.getToken()` para o seu backend no cabeçalho `Authorization` e verifique-o lá em cada requisição protegida:

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

`verifyToken` confere a assinatura ES256 com as chaves publicadas do seu emissor, o emissor e a expiração.
Os tokens de acesso duram no máximo 5 minutos, e `auth.getToken()` os renova para você.
Outras linguagens verificam o mesmo token com os [SDKs de servidor](https://docs.didit.me/pt-br/integration/server-sdks/overview.md) ou com qualquer biblioteca JWT, como mostra [tokens e JWKS](https://docs.didit.me/pt-br/authentication/tokens-and-jwks.md#verificar-um-token-no-seu-servidor).

**7. Veja o login no console**

Abra **Authentication > Sign-ins**.
Seu login aparece com o resultado, o método, o dispositivo, a localização e o risco, ao lado dos logins de exemplo com que toda sandbox começa.
A pessoa aparece em **Users**.

![A página Sign-ins no Didit Business Console, listando as tentativas de login com estado, pessoa, método, dispositivo, localização, risco e horário](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

Authentication > Sign-ins: cada tentativa, com filtros por estado, método e risco.

Para receber a atividade de login no seu servidor, assine um [destino do webhook](https://docs.didit.me/pt-br/integration/webhooks.md) para `auth.signup` e `auth.login`. Veja [eventos e webhooks](https://docs.didit.me/pt-br/authentication/events-and-webhooks.md).

## Antes de ir para produção

1. Ative a Autenticação para a sua aplicação Live na página **Products**.
2. Registre ali as suas URLs de redirecionamento e origens `https://` de produção: uma aplicação Live aceita somente `https://`.
3. Substitua as credenciais de teste do Didit para login social pelo ID do cliente e pelo segredo do seu próprio aplicativo.
4. Copie a chave publicável Live (`pk_live_`) para a sua configuração de produção.
5. Siga o [checklist para entrar em produção](https://docs.didit.me/pt-br/authentication/integration-guide.md#checklist-para-colocar-em-produção).

## Próximos passos

> [card] [Guia de integração](https://docs.didit.me/pt-br/authentication/integration-guide.md)
>
> Telas hospedadas ou próprias, armazenamento de tokens, sessões, elevação de autenticação e solução de problemas.

> [card] [React e Next.js](https://docs.didit.me/pt-br/authentication/quickstarts/nextjs.md)
>
> Componentes, hooks, cookies HttpOnly e `auth()` no servidor.

> [card] [iOS, Android, React Native e Flutter](https://docs.didit.me/pt-br/authentication/quickstarts/ios.md)
>
> Login nativo com o navegador do sistema, passkeys e armazenamento protegido.

> [card] [Proteção contra bots](https://docs.didit.me/pt-br/authentication/bot-protection.md)
>
> Ative as políticas que bloqueiam bots e a tomada de conta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.