Certisign Certificados
Certisign Assinaturas
Quem depende do certificado digital para peticionar, assinar contratos ou enviar documentos ao Poder Judiciário já deve ter esbarrado em uma mensagem parecida com esta: “o token não foi reconhecido como cartão Java”. O erro costuma aparecer justamente quando o prazo está apertado. Mas, na maioria dos casos, tem solução.
Neste artigo, explicamos o que causa esse erro, por que o Java é essencial para a assinatura digital e como resolver, passo a passo, tanto no painel do Java quanto na configuração do assinador.
Veja também: Como solucionar o certificado não listado no navegador
O que é o erro “token não foi reconhecido como cartão Java”?
Essa mensagem aparece quando o navegador ou uma aplicação de assinatura tenta se comunicar com o token ou smartcard onde está instalado o certificado digital. No entanto não consegue reconhecer o dispositivo como uma mídia criptográfica válida.
Na prática, o Java funciona como uma ponte entre o navegador e o hardware do certificado. Quando essa ponte falha, o sistema não consegue “enxergar” o token, mesmo se estiver corretamente conectado ao computador. O resultado é o erro de Java no PJe, que impede a assinatura de petições, documentos e demais atos processuais.
É importante diferenciar esse erro de uma falha no próprio certificado: normalmente, o problema não está no token, e sim na comunicação entre o Java, o driver do dispositivo e o navegador.
Por que o Java é necessário para assinar documentos digitais?
O Java é a tecnologia usada por diversos sistemas públicos e privados, com destaque para o PJe e o PJeOffice. Eles executam os chamados “applets” ou módulos de assinatura diretamente no navegador. É ele quem intermedia a leitura do certificado digital instalado no token ou smartcard, o que permite a assinatura com validade jurídica de um documento.
Sem o Java corretamente instalado, atualizado e configurado, o navegador não consegue acessar o módulo criptográfico do token.
Por isso, mesmo advogados e profissionais que já usam certificado digital há anos podem enfrentar o erro sempre que trocam de computador, atualizam o sistema operacional ou instalam uma nova versão do Java.
Essa dependência técnica explica por que tantos usuários buscam por “PJeOffice não reconhece certificado” ou “falha ao carregar módulo PKCS11 Java”. Ambos são sintomas do mesmo problema de raiz: a comunicação entre Java, driver e token não foi estabelecida corretamente.
Causas comuns do erro “token não reconhecido como cartão Java”
Alguns cenários respondem pela maioria dos casos:
- Versão do Java incompatível ou desatualizada, sem suporte ao módulo de segurança exigido pelo sistema.
- Exceção de segurança não configurada no painel do Java, bloqueando o acesso ao site ou à aplicação do assinador.
- Driver do fabricante do token ausente, desatualizado ou corrompido. Cada modelo de token ou smartcard (SafeNet, GD, ePass, entre outros) exige seu próprio driver.
- Biblioteca PKCS11 não localizada pelo assinador. Ou seja, o caminho do arquivo .dll (Windows) ou .so (Linux) não está apontado corretamente nas configurações.
- Divergência entre a arquitetura do Java (32 ou 64 bits) e a do navegador ou do driver instalado, impedindo o carregamento do módulo.
- Token não reconhecido pelo próprio sistema operacional, geralmente por falta do driver ou por uma porta USB com mau contato.
Identificar qual dessas situações se aplica ao seu caso é o primeiro passo para resolver o erro sem precisar reinstalar tudo do zero.
Como resolver o erro “token não foi reconhecido como cartão Java”?
Antes de qualquer configuração mais técnica, vale seguir esta sequência de verificação:
- Confirme o reconhecimento do token pelo Windows. Verifique no Gerenciador de Dispositivos se ele aparece sem ícones de alerta. Se não aparecer, reinstale o driver do fabricante antes de seguir para os próximos passos.
- Atualize o Java para a versão mais recente compatível com o sistema utilizado (por exemplo, o PJe costuma indicar a versão homologada em seu portal).
- Reinicie o navegador e o computador após qualquer instalação ou atualização. Grande parte dos erros de cache do Java se resolve apenas com esse passo.
- Configure a exceção de segurança no painel do Java, liberando o endereço do sistema utilizado.
- Aponte corretamente a biblioteca do driver (PKCS11) no assinador, para garantir que o caminho do arquivo .dll ou .so está correto.
- Verifique a compatibilidade entre a arquitetura do Java e do navegador (32 ou 64 bits), e ajuste conforme necessário.
Os dois pontos abaixo, com exceção de segurança e biblioteca do driver, costumam concentrar a maioria dos casos. Por isso, detalhamos cada um separadamente.
Como configurar a exceção de segurança no painel do Java?
O Java bloqueia, por padrão, a execução de aplicações que não estejam em sua lista de exceções. É uma medida de segurança que, sem a configuração correta, impede o carregamento do módulo de assinatura.
Veja como configurar Java para certificado digital neste ponto específico:
- Abra o Painel de Controle do Java (procure por “Java” no menu iniciar do Windows ou acesse pelo Painel de Controle).
- Vá até a aba Segurança.
- Clique em Editar Lista de Sites (ou “Exception Site List”).
- Adicione o endereço do sistema que você utiliza para assinar — por exemplo, o endereço do PJe ou do portal do assinador — sempre iniciando com http:// ou https://.
- Clique em OK e reinicie o navegador.
Esse ajuste costuma resolver boa parte dos casos em que o erro aparece assim que a aplicação tenta se conectar ao token.
Como apontar a biblioteca do driver (.dll ou .so) no assinador?
Mesmo com o Java configurado, o assinador (como o PJeOffice) precisa saber onde está o arquivo do driver responsável por conversar com o token, a chamada biblioteca PKCS11. Sem esse caminho definido corretamente, o sistema apresenta a falha ao carregar módulo PKCS11 Java.
No Windows, esse arquivo tem extensão .dll e normalmente fica na pasta de instalação do driver do fabricante do token (por exemplo, em C:\Windows\System32\ ou na pasta específica do fabricante). No Linux, o equivalente é um arquivo .so.
Passo a passo geral para configurar o PJE Office Pro
- Localize o ícone do PJe Office Pro. No Windows, ele geralmente fica na barra de tarefas, na parte de baixo da tela. No Mac, aparece na barra superior.
- Clique no ícone e selecione Configuração de Certificado. Na tela seguinte, clique na engrenagem para ver a lista de certificados disponíveis.
- Escolha o tipo de certificado: A1 (é preciso ter o arquivo .pfx salvo no computador) ou A3 (cartão, token ou nuvem).
- Se for certificado A1: clique em Localizar, abra o explorador de arquivos, selecione o arquivo .pfx e clique em Abrir.
- Confirme o local do arquivo e clique em OK.
- Insira a senha do certificado e clique em OK. O certificado aparecerá na tela. Clique em OK e faça o teste de acesso no site do tribunal que utiliza o PJe Office.
- Se for certificado A3: clique em Busca automática para localizar a DLL ou dylib correspondente.
- Selecione o nome do arquivo correspondente à mídia (cartão, token ou nuvem) e clique em OK. Com o certificado listado, clique em OK e realize o teste no site do tribunal.
- Na tela de acesso, clique em Certificado Digital e libere a permissão de uso. Em algumas aplicações, essa etapa pede um segundo fator de autenticação enviado por SMS.
- Insira a senha da mídia e clique em OK para concluir.
Versão 32 bits vs 64 bits: qual Java você deve usar?
Um dos pontos que mais gera confusão é a arquitetura do Java. Isso porque o Java, o navegador e o driver do token precisam estar na mesma arquitetura para que a comunicação funcione. Misturar versões de 32 e 64 bits é uma causa frequente do erro, mesmo se você seguiu todos os passos corretamente.
Como regra geral:
- Se o seu navegador é de 64 bits, instale o Java de 64 bits.
- Se o seu navegador é de 32 bits, instale o Java de 32 bits.
- O driver do token também deve ser compatível com a arquitetura escolhida.
Em caso de dúvida sobre a versão do navegador, verifique diretamente nas configurações ou na seção “Sobre” do próprio navegador. Ter as duas versões do Java instaladas ao mesmo tempo não costuma causar conflito, desde que o navegador utilizado aponte para a versão correta durante a execução do módulo de assinatura.
A Certisign está aqui para te ajudar
Se mesmo assim a dificuldade persistir, conte com o suporte da Certisign para resolver o problema ou esclarecer qualquer dúvida.
