Claims de token OIDC/JWT | Cadisa Systems

O Aura Home usa tokens OIDC/JWT fornecidos pelo portal do cliente por meio do callback de token do SDK. O backend valida o emissor, a audiência, a assinatura e a expiração do token antes de liberar o acesso protegido ao perfil ou ao chat.

Claims obrigatórias

Claim	Obrigatória	Finalidade	Exemplo
`iss`	Sim	Identifica o emissor confiável do token.	`https://customer.okta.com/oauth2/default`
`aud`	Sim	Identifica o client ID ou a audiência da API esperados.	`aura-home`
`sub`	Sim	Identificador estável do usuário no provedor de identidade do cliente.	`00u123customer`
`exp`	Sim	Expiração do token; tokens expirados são rejeitados.	`1770000000`

Claims recomendadas

Claim	Finalidade
`email`	Útil para exibição, suporte ao cliente e fluxos de busca de usuários.
`name`	Nome de exibição opcional do usuário autenticado.
`iat`	Data e hora de emissão, para diagnóstico e verificação da idade do token.
`nonce`	Recomendado em fluxos OIDC baseados em navegador para reduzir o risco de replay.

Callback de token do SDK

AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://aura.customer-domain.com/",
  auth: {
    mode: "oidc",
    getToken: async () => {
      const token = await customerIdentity.getIdToken();
      return token;
    }
  }
});

Regras de manuseio seguro

Não coloque tokens em query strings.
Não insira tokens em atributos HTML, variáveis CSS, logs, payloads de analytics ou capturas de tela.
Renove os tokens na camada de identidade do cliente, e não dentro do iframe do Aura Home.
Mantenha a validade dos tokens curta e conte com a sessão do portal para a renovação.

Falhas de validação

Falha	O que verificar
Emissor inválido	O `iss` do token deve corresponder à configuração do emissor OIDC do runtime.
Audiência inválida	O `aud` do token deve corresponder ao client ID ou à audiência da API configurados.
Token expirado	Renove o token antes de retorná-lo em `getToken`.
Identidade ausente	Confirme que o `sub` é estável e que o `email` está presente quando exigido pelo fluxo do cliente.