Arquitetura
Intervêm quatro componentes:
Nunca deve existir uma chave de API da Didit nem um segredo na sua aplicação: a chave publicável é pública, e a troca do código é protegida por PKCE em vez de um segredo do cliente.
Páginas alojadas ou os seus próprios ecrãs
Escolha onde as pessoas introduzem o e-mail, a palavra-passe ou o código. A definição ésign_in_ui (hosted por omissão, ou own), e pode alterá-la mais tarde.
As chaves de acesso pertencem à origem de início de sessão da sua aplicação.
Os métodos de chaves de acesso dos SDKs funcionam apenas em páginas servidas a partir dessa origem. Por isso, nos seus próprios ecrãs num domínio diferente, encaminhe as pessoas para a página alojada para usar chaves de acesso.
Escolha o seu SDK
Sem um SDK, implemente você mesmo o fluxo de código de autorização com PKCE: o início rápido em JavaScript mostra o contrato completo.
Proteja o seu backend
Uma verificação da sessão no frontend controla apenas o que mostra. O seu backend toma todas as decisões com base num token verificado.- Verifique o token de acesso em cada pedido. Valide a assinatura ES256 com o JWKS do seu emissor e, depois,
iss,aud,expetyp: at+jwt. Rejeite um token cujoactnão sejanull, a menos que a rota aceite agentes de IA. Consulte verificar um token no seu servidor. - Verifique a sessão ativa antes de uma ação sensível. Um token de acesso mantém-se válido até expirar, no máximo 5 minutos.
GET /session/falha de imediato quando a sessão foi revogada, ficou inativa ou expirou, quando a pessoa foi bloqueada ou quando a sessão deixa de cumprir a sua política de MFA. Consulte verificar a sessão. - Peça uma verificação adicional quando a ação for arriscada. Antes de um pagamento a beneficiário, de uma nova conta bancária ou de uma alteração de e-mail ou de telefone, pergunte à Didit se a pessoa tem de voltar a verificar-se, e atue apenas com base num step-up
approvedque o seu backend tenha lido por si próprio. Consulte step-up antes de ações sensíveis. - Obtenha o
vendor_dataa partir do token verificado, nunca de um campo enviado pelo navegador, e use-o nas verificações e transações da pessoa.
Sessões
Altere as durações em Authentication > Security and sessions, ou por API, nas definições da aplicação.

Authentication > Sign-ins > Active sessions, com Revoke em cada sessão.
Aplicações nativas
A Didit só redireciona as pessoas para uma aplicação nativa através de um redirecionamento HTTPS: não aceita esquemas de URL personalizados.- iOS: configure o redirecionamento como um domínio associado, com
webcredentialsno seuapple-app-site-association. - Android: configure o redirecionamento como um App Link, com o seu
assetlinks.json. - Registe cada URL de redirecionamento em Authentication > Security and sessions, tal como um callback web.
PUT native-apps/ na API de gestão de autenticação.
A Didit inclui-as depois na lista do apple-app-site-association e do assetlinks.json que disponibiliza na sua origem de início de sessão.
MANAGEMENT_BASE é o endereço da API de gestão da sua aplicação, e uma chave de API com o âmbito authentication e permissão write pode fazer a chamada.
A chamada substitui ambas as listas, por isso envie as duas:
Os guias de início rápido para iOS e Android mostram o lado da aplicação.
Ligar a verificação de identidade e a monitorização de transações
Cada pessoa tem um valorvendor_data, nos seus tokens e na sua sessão.
Use-o como vendor_data ao criar uma sessão de verificação ou ao submeter uma transação, e a consola mostra os inícios de sessão, as verificações e as transações da mesma pessoa.
- Para verificar pessoas no registo ou novamente antes de um pagamento, sem criar um fluxo de verificação, use a identidade verificada.
- Os eventos de início de sessão chegam automaticamente às regras de eventos e às vistas de fraude. Não envie os seus próprios eventos
auth.loginpara os mesmos inícios de sessão. - Um início de sessão bem-sucedido nunca aprova uma verificação ou uma transação: trate a decisão de cada produto separadamente.
Receber eventos de início de sessão
Subscreva um destino do webhook para os tiposauth.* de que precisa, como auth.new_device ou auth.account_locked.
Deduplique por auth_event.event_id e verifique a assinatura tal como faz para qualquer webhook da Didit.
Consulte eventos e webhooks para ver todos os tipos e o respetivo payload.
Migrar utilizadores existentes
Se os seus utilizadores já tiverem contas noutra plataforma de identidade ou na sua própria base de dados, importe-os antes de mudar o início de sessão. Importe os hashes de palavra-passe dos utilizadores sempre que a origem os fornecer, mantenha as ligações sociais e guarde os seus IDs de utilizador comoexternal_id, que passa a ser o vendor_data de cada utilizador.
Nada muda para os utilizadores até mudar a sua aplicação para a Didit.
Lista de verificação antes de passar para produção
- A autenticação está ativada na sua aplicação Live, na página Products.
- Os seus URLs de redirecionamento
https://de produção e as origens permitidas estão registados na aplicação Live. Uma aplicação Live não aceita endereçoshttp://. - Cada método de início de sessão social usa o ID de cliente e o segredo da sua própria aplicação: as credenciais de teste da Didit só funcionam no Sandbox.
- A sua configuração de produção tem a chave publicável Live (
pk_live_) e o seu emissor Live. - A sua política de MFA, a duração da sessão, o tempo limite de inatividade, o comprimento da palavra-passe e a política de registo estão como pretende. Consulte as definições da aplicação.
- A proteção contra bots está ativada, com a verificação de palavras-passe comprometidas.
- O seu backend verifica todos os tokens de acesso e chama
GET /session/antes de ações sensíveis. - A sua identidade visual, os textos das páginas e as ligações para os termos e para a política de privacidade estão definidos. Se planeia usar um domínio personalizado, ative-o antes de as pessoas começarem a adicionar chaves de acesso.
- O seu destino do webhook está subscrito aos tipos
auth.*que trata. - Testou na aplicação Live o registo, o início de sessão de quem já tem conta, o cancelamento, o fluxo de palavra-passe esquecida, a MFA, a expiração de sessão, o fim de sessão e uma sessão revogada.