Erros PKCS#11: diagnóstico e solução

Sintoma: o token está conectado, mas o sistema/aplicativo não o vê.

Soluções, em ordem:

1. Troque a porta USB (prefira USB direto na placa-mãe — evite hub)
2. Reinicie o serviço de smart card: no Windows, net stop SCardSvr && net start SCardSvr; no Linux, sudo systemctl restart pcscd
3. Reinstale o middleware da AC emissora
4. Teste o token em outro computador para descartar defeito físico
5. Se tem mais de um middleware instalado, remova o que não usa

Sintoma: aplicação informa "módulo PKCS#11 não foi encontrado" ou "falha ao carregar biblioteca".

Verifique o caminho da biblioteca:

Se o arquivo existe, o problema é permissão ou aplicação apontando para caminho errado. Se não existe, reinstale o middleware.

Chrome e Edge usam o repositório de certificados do Windows. Se o middleware está instalado mas o certificado não aparece:

1. Abra certmgr.msc → Pessoal → Certificados
2. Se o certificado não está lá, o middleware não registrou. Reinstale marcando "Typical" ou "Complete"
3. No macOS, o certificado aparece em Keychain Access → login → Certificates
4. Feche TODAS as instâncias do navegador antes de reabrir

Firefox tem repositório próprio. Configure PKCS#11 manualmente:

1. Configurações → Privacidade e Segurança → Certificados
2. Clique em "Dispositivos de Segurança"
3. Clique em "Carregar"
4. Nome do módulo: SafeSign (ou SafeNet, etc.)
5. Nome do arquivo: caminho da DLL/dylib/so conforme listado acima
6. Clique OK. O certificado passa a aparecer em "Seus Certificados"

Três tentativas erradas de PIN bloqueiam o token. Para desbloquear:

1. Abra o utilitário do middleware (SafeSign Token Admin / SafeNet Authentication Client Tools)
2. Procure opção "Desbloquear token" ou "Reset PIN"
3. Use o código PUK fornecido pela sua Autoridade Certificadora na entrega do certificado
4. Defina um novo PIN

Atenção: se o PUK também for bloqueado (geralmente 10 tentativas), o token é "brickado" — o certificado precisa ser re-emitido pela AC.

Sintoma: token intermitente, às vezes detectado, às vezes não.

Causa: SafeSign + SafeNet + outro, todos rodando ao mesmo tempo, disputam o serviço de cartão inteligente.

Solução:

1. Painel de Controle → Programas → desinstale todos os middlewares
2. Reinicie o computador
3. Instale apenas o middleware correto para o seu token
4. Reinicie novamente

Se o certificado aparece no Token Admin mas a assinatura falha no app SignDocs Brasil desktop:

1. Confirme que o token está inserido durante a operação
2. Verifique se a senha (PIN) digitada está correta — sem espaços extras
3. Teste criar uma nova sessão do SignDocs Brasil e assinar novamente
4. Se persistir, contate suporte pelo chat em app.signdocs.com.br

No Linux, o daemon pcscd precisa estar rodando para o token funcionar.

Se pcsc_scan lista o token, o hardware está OK — o problema está no middleware ou na aplicação.