> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/gestao-de-equipe/passkeys.md).

# Passkeys

**Caminho:** Configuracoes -> Gestao de Equipe -> aba correspondente

\[\[FOTO]]

### Aba: Passkeys

#### Finalidade

Visao **administrativa** de todas as passkeys (WebAuthn) do tenant (ou de todos os tenants, se Master): estatisticas, filtro, ativar/desativar e remover. O usuario comum gerencia as proprias passkeys em outra tela de perfil; aqui o admin opera o inventario.

\[\[FOTO]]

#### O que aparece na tela

| Bloco                  | Para que serve                                                               |
| ---------------------- | ---------------------------------------------------------------------------- |
| Filtro Tenant (Master) | Restringe usuarios/passkeys                                                  |
| Selecionar usuario     | Filtra lista a um usuario                                                    |
| Busca                  | Filtra texto na tabela                                                       |
| Estatisticas           | Total de usuarios, usuarios com passkeys, total de passkeys, passkeys ativas |
| Lista (tabela/cards)   | Inventario                                                                   |

#### Colunas da lista

| Coluna        | Para que serve                                       |
| ------------- | ---------------------------------------------------- |
| Usuario       | Nome + e-mail (ou "Usuario nao encontrado")          |
| Dispositivo   | `deviceName` + tipo de autenticador (icone por tipo) |
| Registrado em | `createdAt`                                          |
| Ultimo uso    | `lastUsedAt` ou "Nunca usado"                        |
| Status        | Ativa / Inativa                                      |
| Acoes         | Alternar status / Remover                            |

#### Acoes

| Acao                  | Detalhe                                             |
| --------------------- | --------------------------------------------------- |
| Ativar / Desativar    | Toggle `isActive`                                   |
| Remover               | Confirmacao com usuario + dispositivo; irreversivel |
| Alternar tabela/cards | Preferencia salva localmente                        |

**Nao ha criacao de passkey nesta aba** - o registro ocorre no fluxo do proprio usuario (navegador + biometria/chave).

#### Regras / validacoes / erros comuns

| Regra                 | Detalhe                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| Lista vazia           | Mensagem pede selecionar usuario ou indica ausencia de passkeys                                   |
| Remocao               | Confirmacao obrigatoria                                                                           |
| Master sem filtro     | Pode carregar escopo amplo; filtro tenant recomendado                                             |
| Conflito com 2FA TOTP | Em config pessoal: TOTP e Passkey sao mutuamente exclusivos (mensagem em `totp.passkeyConflict*`) |

#### Quem acessa

Admin (`requiresAdmin`). Master: filtro por tenant.

***