> ## 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 início de sessão em 10 minutos

> Ative a Autenticação Didit numa sandbox, inicie sessão com a página alojada e valide o token de acesso no seu servidor.

Este guia rápido põe o Didit Authentication a funcionar de ponta a ponta em cerca de 10 minutos.
Você regista um URL de retorno numa aplicação sandbox, ativa um método de início de sessão, inicia a sessão de uma pessoa através da página de início de sessão alojada, valida o token de acesso no seu servidor e vê o início de sessão na consola.

## Pré-requisitos

* Uma conta Didit com uma aplicação Sandbox. Criar uma conta é gratuito, e todas as aplicações Sandbox têm a Autenticação ativada.
* Node.js 20 ou superior, e uma aplicação web que possa ser executada em `http://localhost:3000`.

## Passos

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

Na [Business Console](https://business.didit.me), use o seletor de aplicações para selecionar a sua aplicação **Sandbox** e, em seguida, abra **Authentication**.

Uma aplicação Sandbox aceita URLs de retorno `http://localhost` e as credenciais de teste do Didit para o início de sessão social, e nunca é faturada.
Uma aplicação Live ativa o Authentication a partir da página **Products**: veja [preparar a sua aplicação](https://docs.didit.me/pt/authentication/overview.md#prepare-a-sua-aplicação).

**2. Registe o seu URL de retorno e a sua origem**

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

| O quê | Valor |
| - | - |
| URL de redirecionamento | `http://localhost:3000/auth/callback` |
| Origem permitida | `http://localhost:3000` |

O Didit só redireciona uma pessoa para um URL de redirecionamento que tenha registado, carácter a carácter.
A origem permitida permite que o navegador troque o código com a origem do Didit da sua aplicação.

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

URLs de redirecionamento e origens permitidas, em Authentication > Security and sessions.

**3. Ative um método de início de sessão**

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

Se quiser, adicione também **Passkeys**, ou um método de início de sessão social com as **credenciais de teste do Didit**, que funcionam no Sandbox sem uma aplicação própria.
Cada método está descrito em [métodos de início de sessão](https://docs.didit.me/pt/authentication/sign-in-methods.md).

![A página Sign-in methods na Didit Business Console, com o cartão da página de início de sessão alojada, os métodos sem palavra-passe e com palavra-passe e uma pré-visualização em tempo real da página alojada](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é-visualização em tempo real da página alojada.

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

Abra **Authentication > Developers** e copie a **Publishable key**.
Numa aplicação Sandbox, começa por `pk_test_`.

A chave publicável é pública e identifica a origem de início de sessão do Didit da sua aplicação.
Nunca coloque a **Secret key** em código executado no navegador ou em aplicações móveis.

**5. Instale o SDK e inicie sessão**

```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 alojada pede um endereço de e-mail e envia um código de seis dígitos.
Introduza o código, e o Didit redireciona-o para o seu URL de retorno, que troca o código de utilização única pelos tokens da sessão.
Um primeiro início de sessão com um endereço sem conta cria uma, porque a política de registo predefinida permite que qualquer pessoa se registe.

![A página de início de sessão alojada num telemóvel, com um botão de passkey e campos de e-mail e palavra-passe](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 início de sessão alojada num telemóvel. Mostra apenas os métodos que ativou.

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

Envie o token de acesso de `auth.getToken()` para o seu backend, no cabeçalho `Authorization` do pedido, e verifique-o aí em cada pedido protegido:

```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` verifica a assinatura ES256 com base nas chaves publicadas pelo seu emissor, bem como o emissor e a expiração.
Os tokens de acesso duram no máximo 5 minutos, e `auth.getToken()` renova-os por si.
Noutras linguagens, verifique o mesmo token com os [SDKs de servidor](https://docs.didit.me/pt/integration/server-sdks/overview.md) ou com qualquer biblioteca JWT, como mostra [tokens e JWKS](https://docs.didit.me/pt/authentication/tokens-and-jwks.md#verifique-um-token-no-seu-servidor).

**7. Veja o início de sessão na consola**

Abra **Authentication > Sign-ins**.
O seu início de sessão aparece listado com o resultado, o método, o dispositivo, a localização e o risco, junto aos inícios de sessão de exemplo com que cada sandbox começa.
A pessoa aparece em **Users**.

![A página Sign-ins na Didit Business Console, com a lista de tentativas de início de sessão, o estado, a pessoa, o método, o dispositivo, a localização, o risco e a hora](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: todas as tentativas, com filtros por estado, método e risco.

Para receber a atividade de início de sessão no seu servidor, subscreva um [destino de webhook](https://docs.didit.me/pt/integration/webhooks.md) aos eventos `auth.signup` e `auth.login`. Veja [eventos e webhooks](https://docs.didit.me/pt/authentication/events-and-webhooks.md).

## Antes de entrar em produção

1. Ative a Autenticação para a sua aplicação Live na página **Products**.
2. Registe os seus URL de redirecionamento e origens de produção `https://` nessa página: uma aplicação Live aceita apenas `https://`.
3. Substitua as credenciais de teste da Didit para o início de sessão social pelo ID do cliente e pelo segredo da sua própria aplicação.
4. Copie a chave publicável Live (`pk_live_`) para a sua configuração de produção.
5. Percorra a [lista de verificação para entrada em produção](https://docs.didit.me/pt/authentication/integration-guide.md#lista-de-verificação-antes-de-passar-para-produção).

## Próximos passos

> [card] [Guia de integração](https://docs.didit.me/pt/authentication/integration-guide.md)
>
> Ecrãs alojados ou os seus próprios ecrãs, armazenamento de tokens, sessões, autenticação adicional e resolução de problemas.

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

> [card] [iOS, Android, React Native e Flutter](https://docs.didit.me/pt/authentication/quickstarts/ios.md)
>
> Início de sessão nativo com o navegador do sistema, chaves de acesso e armazenamento protegido.

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


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