3.1 KiB
3.1 KiB
Catálogo Estruturado de Erros
O CyberCore Signer adota um sistema unificado e determinístico de códigos de erro (CcspErrorCode) compartilhados entre o agente Java desktop, o protocolo CCSP/1 e o SDK Web em JavaScript.
1. Tabela de Erros Estruturados
| Código de Erro | Descrição Detalhada | Ação Recomendada para a Aplicação Web |
|---|---|---|
CERTIFICATE_NOT_FOUND |
O certificado indicado pelo certificate_hint não foi localizado. |
Solicite ao usuário selecionar novamente o certificado via getCertificates(). |
CERTIFICATE_EXPIRED |
O certificado selecionado expirou. | Oriente o usuário a renovar o certificado digital junto à autoridade certificadora. |
CERTIFICATE_INVALID |
O certificado possui estrutura corrompida ou ainda não é válido. | Verificar a data e integridade do arquivo/dispositivo. |
PRIVATE_KEY_NOT_AVAILABLE |
O certificado está presente mas a chave privada não está acessível. | Em tokens A3, verifique se o middleware/driver está instalado corretamente. |
TOKEN_NOT_FOUND |
Nenhum dispositivo ou leitor compatível foi localizado. | Solicite ao usuário conectar o token USB ou inserir o smartcard no leitor. |
TOKEN_REMOVED |
O token USB ou cartão foi removido fisicamente durante a assinatura. | Peça ao usuário reconectar o token e reiniciar a operação de assinatura. |
PIN_REQUIRED |
O token exige PIN para liberar a chave privada e nenhum PIN foi fornecido. | Exibir campo de solicitação de PIN na tela. |
PIN_INCORRECT |
O PIN digitado está incorreto. | Informar o usuário e alertar sobre o risco de bloqueio de PUK após 3 tentativas. |
PKCS11_ERROR |
Falha no driver ou biblioteca PKCS#11 do fabricante. | Verificar a instalação do SafeSign, SafeNet ou OpenSC. |
SIGNATURE_FAILED |
Erro durante a geração dos bytes da assinatura digital. | Tentar novamente ou reiniciar o agente desktop. |
APPLICATION_NOT_AUTHORIZED |
A aplicação web teve autorização recusada pelo usuário. | Informar o usuário que é necessário aceitar a notificação na tela do agente. |
REQUEST_EXPIRED |
O timestamp ou expires_at da requisição expirou. |
Gerar nova requisição de assinatura com timestamp atualizado. |
REPLAY_DETECTED |
O nonce informado já foi processado anteriormente. | Sempre gerar um UUID único para cada chamada de assinatura. |
INVALID_ORIGIN |
O cabeçalho Origin não confere com o cadastro da aplicação. |
Conectar-se com a URL e protocolo autorizados. |
UNSUPPORTED_ALGORITHM |
Algoritmo solicitado não é suportado pelo agente ou certificado. | Utilizar algoritmo padrão homologado (SHA256withRSA). |
USER_CANCELLED |
O usuário clicou em Cancelar ou fechou a janela do CyberCore. | Tratar como cancelamento voluntário sem mensagem de erro alarmante. |
PROVIDER_NOT_AVAILABLE |
O provedor criptográfico necessário não está ativo no sistema operacional. | Verificar a integridade do Windows Certificate Store ou Java Runtime. |
COMMUNICATION_ERROR |
Erro interno de socket ou timeout de rede local. | Verificar se a porta 21325 não está bloqueada por antivírus local. |