Esta página foi traduzida automaticamente. Leia a versão original em inglês aqui.
As chaves de acesso agora são suportadas por 20% dos 100 principais sites do mundo e 53% dos consumidores globais ativaram as chaves de acesso em pelo menos uma conta, de acordo com o FIDO Alliance Authentication Barometer 2024. Amazon, WhatsApp, Coinbase, TikTok, Facebook, LinkedIn e X/Twitter adicionaram suporte desde 2023.

Cheatsheet de Passkeys. Guias práticos, padrões de implementação e KPIs para programas de passkeys.
A especificação WebAuthn Level 3 da W3C define uma
série de exceções DOM, mas os navegadores reúnem propositadamente a maioria das falhas
(cancelamento pelo utilizador, tempos limite, autenticadores inelegíveis) no
NotAllowedError genérico para evitar vazamentos de privacidade, de acordo com as
W3C Privacy Considerations.
Muitas partes confiáveis também definem as suas próprias mensagens de erro, pois não há
muitas das melhores práticas demonstradas além das
diretrizes de UX da FIDO Alliance. Este guia
mapeia as formulações mais comuns voltadas para o consumidor para uma causa clara e uma
correção prática, com capturas de ecrã tanto do lançamento original quanto das versões
mais recentes do iOS e
Android.
Discuta notícias e dúvidas sobre passkeys em r/passkey.
Se a sua chave de acesso do Google não funcionar no seu dispositivo, a primeira verificação é se o navegador, o SO e os serviços do Google Play estão todos numa versão atual, uma vez que a maioria das regressões são corrigidas dentro de um ou dois lançamentos.
Artigos recentes
📖
WebAuthn Relying Party ID (rpID) e passkeys: domínios e apps nativos
♟️
Por que você precisa de observabilidade da autenticação para o CIAM
🔑
Credenciais de sessão vinculadas ao dispositivo (DBSC) explicadas
♟️
Estratégia de chaves de acesso: por que a sua implementação de chaves de acesso falhará
♟️
Problemas do Dia 2 das Chaves de Acesso: 5 Riscos após o Lançamento
As chaves de acesso são credenciais sem palavra-passe baseadas na WebAuthn API e na especificação subjacente CTAP 2.2 da FIDO Alliance. A W3C padronizou o WebAuthn Level 1 em março de 2019, o Level 2 em abril de 2021 e o Level 3 em 2024. A adoção atingiu aproximadamente mil milhões de credenciais registadas nos principais ecossistemas até o quarto trimestre de 2024, segundo o FIDO Alliance Authenticate 2024.
Teste passkeys em uma demo ao vivo.
O dispositivo gera um par de chaves único no momento do registo. Apenas a chave pública é enviada à parte confiável, enquanto a chave privada permanece dentro da área segura, do TPM ou do TEE. Ao iniciar sessão, o servidor envia um desafio, o dispositivo desbloqueia a chave privada com o Face ID, o Touch ID ou o Windows Hello, assina o desafio e retorna a assinatura. A parte confiável verifica isso com a chave pública.
Como a chave privada nunca sai do dispositivo, o phishing e a reutilização de palavras-passe deixam de funcionar como vetores de ataque. Do ponto de vista do utilizador, todo o fluxo é um único prompt biométrico.
Veja quantas pessoas realmente usam passkeys.
Porta-chaves em iCloud ativado:
O porta-chaves em iCloud é o local de armazenamento para as credenciais nos dispositivos Apple e está presente no iOS 16, no iPadOS 16 e no macOS Ventura 13 ou posterior. A Apple reportou cerca de 2,2 mil milhões de dispositivos ativos no início de 2024, dos quais mais de 90% executam o iOS 16 ou posterior, de acordo com o painel de controlo de programadores da Apple. Para ativar o porta-chaves em iCloud, navegue até as definições do seu dispositivo, selecione o seu ID Apple, vá ao iCloud e de seguida ative o porta-chaves do iCloud (leia mais aqui). Conforme a documentação do programador da Apple, contas do iCloud com o porta-chaves ativado são forçadas a usar MFA.
iOS 16 ou macOS Ventura obrigatório:
O iOS 16 foi lançado em 12 de setembro de 2022 e o macOS Ventura 13 em 24 de outubro de 2022. No iOS 18 o armazenamento mudou para uma aplicação dedicada, Palavras-passe, que é o motivo pelo qual alguns prompts agora exibem "Palavras-passe" em vez de "Porta-chaves em iCloud". De acordo com o suporte da Apple, os utilizadores em versões de SO mais antigas não podem criar ou usar chaves de acesso de forma alguma.
Assine nosso Substack de passkeys para receber as últimas novidades.
Configuração do Windows Hello:
O Windows Hello é necessário para criar ou usar chaves de acesso em dispositivos Windows 10 e Windows 11. Conforme a documentação de chaves de acesso do Windows da Microsoft, a build 22631 do Windows 11 (novembro de 2024) apresentou a UI nativa para chaves de acesso e a versão 25H2 do Windows 11 (novembro de 2025) adicionou o suporte a gestores de chaves de acesso de terceiros, como o 1Password e o Bitwarden. O Windows Hello aceita uma impressão digital, um reconhecimento facial ou um PIN de 6 dígitos. Configure-o em Definições > Contas > Opções de início de sessão (leia mais aqui).
Android versão 9 ou posterior:
O Android 9 (Pie) foi lançado em 6 de agosto de 2018 e é o mínimo para o Credential Manager API. Segundo o painel de distribuição do Android, o Android 9 e posterior executam em cerca de 95% dos dispositivos Android ativos em 2026. Versões mais antigas não podem usar chaves de acesso de todo porque carecem do StrongBox Keymaster e do Gestor de Credenciais.
Serviços do Google Play atualizados:
Os Serviços do Google Play na versão 23.40 ou posterior são necessários para o Gestor de Credenciais. Os serviços do Google Play atualizam aproximadamente a cada 4 a 6 semanas e a maioria dos problemas de "chave de acesso do Google não funciona" tem origem numa versão antiga. Atualize os serviços do Google Play e o WebView do sistema em Definições > Aplicações e tente novamente.
Em todas as plataformas, mantenha o navegador numa versão atual. O Safari, o Chrome e o Edge publicam atualizações estáveis semanalmente e a maioria das regressões são corrigidas no espaço de um ou dois lançamentos.
Veja quantas pessoas realmente usam passkeys.
Rastreamos cerca de 15 padrões de erro recorrentes em clientes do iOS, do Android e do Windows, que em conjunto representam a maior parte dos pedidos de suporte ao cliente observados nas principais partes confiáveis. As próximas 6 secções agrupam esses erros por causa raiz: porta-chaves do iCloud e a aplicação Palavras-passe da Apple, nenhuma credencial disponível, código QR e fluxos entre dispositivos, problemas específicos do Windows, problemas específicos do Android e a categoria genérica do WebAuthn ou do navegador.
Cada entrada inclui capturas de ecrã do lançamento original, assim como das versões mais recentes do iOS e do Gestor de Credenciais do Android, a causa mais provável e uma solução que tem funcionado para outros. Quando for útil, a entrada referencia a especificação WebAuthn Level 3 da W3C, as especificações da FIDO Alliance ou a documentação da plataforma relevante da Apple, da Microsoft e do Gestor de Credenciais do Android.
Este grupo cobre os dois erros que os dispositivos da Apple mostram quando o Porta-chaves em iCloud não está configurado corretamente. Ambos são mostrados pelo sistema e não pela parte confiável. O porta-chaves do iCloud é um requisito rigoroso para chaves de acesso no iOS 16, no iPadOS 16 ou no macOS Ventura 13 e posterior, de acordo com a documentação de programadores da Apple. No iOS 18 o armazenamento mudou para a nova aplicação Palavras-passe, motivo pelo qual o texto mudou.
No iOS mais recente o texto diz "Para usar chaves de acesso, tem de ativar o porta-chaves em iCloud" e o caminho foi alterado para Definições > Conta Apple > iCloud > Palavras-passe e Porta-chaves:
No iOS mais recente, o pedido agora apresenta a marca da nova aplicação Palavras-passe e lê-se "Não há chaves de acesso correspondentes guardadas em Palavras-passe para...":
Estes erros surgem quando a credencial que o utilizador espera não está no dispositivo atual, já foi registada ou foi eliminada num dos lados e no outro não. As propriedades WebAuthn AllowCredentials e excludeCredentials impulsionam grande parte deste comportamento do lado do servidor.
No Android, o mesmo erro é exibido pelos serviços do Google Play com a indicação "Nenhuma chave de acesso disponível. Não existem chaves de acesso para a <parte confiável> neste dispositivo" e um recurso de alternativa para "Usar um dispositivo diferente":
O fluxo de código QR usa o transporte híbrido do FIDO (também designado híbrido CTAP 2.2). De acordo com as especificações FIDO CTAP, os dois dispositivos trocam um segredo de uso único através do código QR e depois comunicam-se via Bluetooth Low Energy a uma distância máxima de aproximadamente 3 metros. É exigido que o Bluetooth esteja ligado e que haja proximidade; em caso contrário, o fluxo falha de forma silenciosa.
No iOS mais recente, a folha de código QR para partilha entre dispositivos exibe agora a mensagem "Ler Código QR. Leia este código QR com um dispositivo compatível para iniciar a sessão em...":
No Android, o Gestor de Credenciais mostra o mesmo fluxo com "Sem início de sessão disponível" apresentando a opção de Mostrar código QR e uma alternativa para Abrir Gestor de palavras-passe do Google:
As builds do Windows enviaram várias regressões relacionadas a chaves de acesso nos últimos 18 meses. De acordo com a documentação de chaves de acesso do Windows da Microsoft, a compilação 22631 (novembro de 2024) adicionou a interface de utilizador nativa de chaves de acesso e a versão 25H2 do Windows 11 (novembro de 2025) integrou suporte para o gestor de chaves de acesso de terceiros. Ambas as mudanças redefiniram algum estado do Windows Hello.
C:\Windows\ServiceProfiles\LocalService\AppData\Local\Microsoft\Ngc), reinscrevendo o
Windows Hello. A ligação nas contas da Microsoft em sistema operativo Windows tem de
ficar assinalada num modelo de "melhor esforço", preservando ativamente pelo menos um
acesso via MFA que não exija as chaves
de acesso.A API de Gestor de Credenciais em Android exige os serviços do Google Play versão 23.40 ou superior e depende dum bloqueio de ecrã seguro na validação dos utilizadores, a julgar pela documentação do Gestor de Credenciais do Android. Os dispositivos não dispõem da funcionalidade se os referidos bloqueios de ecrã se encontrarem por aplicar.
Estes são erros reportados especificamente em navegadores ou associados a limitações
inerentes na comunicação com o WebAuthn. Estas
ocorrências têm sido formuladas intencionalmente de forma genérica na salvaguarda dos
dados pessoais. Os navegadores reportam o cruzamento em 10 a 14 variações de exceções da
DOM à especificação da W3C num NotAllowedError global na mesma linha para cancelar as
recusas no fluxo por tempo esgotado e da plataforma nas recusas do ambiente por si mesmo.
As chaves de acesso removem a classe de vulnerabilidades associadas a palavras-passe ao substituir os segredos partilhados por criptografia de chave pública. Implementações no mundo real relatam um início de sessão 4x a 6x mais rápido em comparação à palavra-passe e OTP, com o Verizon's 2024 Data Breach Investigations Report a atribuir 68% das violações a um elemento humano não malicioso, incluindo abuso de credenciais. A redução dessa área de superfície é o objetivo principal.
Na prática, os 15 erros acima são os responsáveis pela maior parte dos pedidos de assistência ao consumidor que encontramos na comunidade de chaves de acesso, e um bom trabalho de resolução de problemas é essencial a uma maior adoção das chaves de acesso. Seguir as melhores práticas de criação e as melhores práticas de início de sessão reduz significativamente as taxas de erro. Para se manter atualizado no manuseio de erros e nos detalhes de implementação, subscreva o Substack das chaves de acesso ou integre e atue diretamente junto à comunidade no Slack.
Corbado é a Passkey Intelligence Platform para times de CIAM que rodam autenticação consumer em escala. Mostramos o que logs de IDP e ferramentas genéricas de analytics não enxergam: quais dispositivos, versões de SO, navegadores e gerenciadores de credenciais suportam passkeys, por que os registros não viram logins, onde o fluxo WebAuthn falha e quando uma atualização de SO ou navegador quebra silenciosamente o login — tudo sem substituir Okta, Auth0, Ping, Cognito ou seu IDP interno. Dois produtos: Corbado Observe adiciona observabilidade para passkeys e qualquer outro método de login. Corbado Connect entrega passkeys gerenciados com analytics integrado (junto ao seu IDP). VicRoads roda passkeys para mais de 5M de usuários com Corbado (+80% de ativação de passkey). Fale com um especialista em Passkeys →
Este pedido aparece quando o Windows Hello está desativado ou não há TPM disponível, fazendo com que o sistema recorra à autenticação por chave de segurança de hardware. A ativação do Windows Hello nas definições de início de sessão do seu dispositivo resolve isso, mas deve primeiro criar uma chave de acesso do Windows Hello antes de usá-la para iniciar sessão.
Este erro geralmente resulta de uma falha na aplicação, um problema temporário no servidor ou definições de dispositivo incompatíveis. Reiniciar a aplicação ou o dispositivo e verificar se há atualizações do sistema operativo e da aplicação geralmente resolve. Se o problema for do lado do servidor, recomenda-se esperar e tentar novamente mais tarde.
Os erros de tempo limite ocorrem quando o servidor demora muito para responder, geralmente devido à instabilidade da rede ou à alta carga do servidor. A verificação da sua ligação à internet é o primeiro passo. Se a conectividade for estável, o problema é provável que seja do lado do servidor e tentar novamente após uma curta espera deve resolvê-lo.
A exclusão de uma chave de acesso do lado do cliente, como do porta-chaves do iCloud ou do Gestor de palavras-passe do Google, sem removê-la também nas definições da conta da parte confiável causa erros de "nenhuma chave de acesso correspondente". O servidor ainda detém a chave pública e espera a credencial, portanto, a eliminação do lado do cliente e do lado do servidor é necessária antes de registar uma nova chave de acesso.
NotAllowedError é o erro genérico do WebAuthn que os navegadores retornam quando uma
cerimónia de chave de acesso não foi concluída. Pode significar cancelamento pelo
utilizador, tempo limite, um gesto de utilizador em falta, uma origem bloqueada ou um
autenticador de plataforma que recusou o pedido. Os navegadores ocultam a causa exata por
motivos de privacidade. Tentar novamente o fluxo após uma ação direta do utilizador e
confirmar a biometria ou o PIN geralmente
resolve.
No iOS 18 e posterior, o local de armazenamento mudou para a nova aplicação Palavras-passe, por isso a redação mudou de "Porta-chaves em iCloud" para "Palavras-passe". O erro significa que a credencial está em falta neste dispositivo ou que a sincronização do iCloud não está ativa. Confirme que o porta-chaves do iCloud está ativado em todos os dispositivos Apple usados pelo mesmo ID Apple, force uma sincronização ao desativar e ativar o porta-chaves do iCloud e, de seguida, tente iniciar sessão novamente. Se não existir nenhuma credencial, registe uma nova a partir das definições de conta da parte confiável.
O Gestor de Credenciais do Android mostra este pedido quando não há nenhuma credencial correspondente armazenada para a parte confiável no dispositivo atual. Normalmente, ele oferece a opção de "Mostrar código QR" para usar uma chave de acesso de outro dispositivo por meio do transporte híbrido FIDO, além de uma alternativa para abrir o Gestor de palavras-passe do Google. Escaneie o código QR com um telemóvel que já tenha a credencial, inicie sessão com um método de alternativa ou registe uma nova credencial no dispositivo atual a partir das definições da conta da parte confiável.
O fluxo entre dispositivos é o transporte híbrido do FIDO definido no CTAP 2.2. O navegador do computador mostra um código QR contendo um segredo de uso único. Um telemóvel escaneia-o com a câmara e depois conecta-se novamente através de Bluetooth Low Energy a uma distância máxima de cerca de 3 metros. Após o utilizador confirmar no telemóvel, a cerimónia do WebAuthn é concluída no computador. Tanto o Bluetooth quanto a proximidade são necessários, caso contrário, o fluxo falha silenciosamente com mensagens genéricas de "Ocorreu um erro" ou "Não foi possível iniciar sessão".
Artigos relacionados
Índice