cybercore-signer/docs/development-mode.md

Modo de Desenvolvimento e Diagnóstico Detalhado

O CyberCore Signer opera exclusivamente com certificados digitais e provedores criptográficos reais (A1 via arquivos .pfx/.p12, repositório nativo do Windows Windows-MY e tokens/smart cards físicos PKCS#11). Em conformidade com a exigência de segurança de produção, não existem mocks ou certificados sintéticos no agente.

---

1. Ativação do Modo de Desenvolvimento

Para iniciar o agente em modo de desenvolvimento (com logs detalhados e diagnósticos ampliados), utilize o argumento --dev:

java -jar cybercore-signer.jar --dev

Ao iniciar, uma mensagem informativa é registrada no log:

=========================================================
 MODO DE DESENVOLVIMENTO ATIVADO (--dev)
 Logs detalhados ativos. Operação com certificados reais.
=========================================================

---

2. Testando em Ambiente de Desenvolvimento

Para desenvolvedores testarem fluxos completos de assinatura de PDF, XML, arquivos em geral e login digital:

1. Certificados A1 de Teste/Homologação:

   • Adicione um certificado A1 .pfx ou .p12 emitido por uma autoridade de teste ou autoassinado.
   • Pela interface desktop, clique no botão "Importar A1 (.pfx/.p12)" no Dashboard e informe o arquivo e a senha.
   • O certificado ficará disponível imediatamente para todas as operações CCSP/1.

2. Repositório Nativo do Windows (Windows-MY):

   • Instale o certificado no repositório de certificados pessoais do Windows (certmgr.msc).
   • O provedor WindowsCertificateStoreProvider detectará o certificado automaticamente.

3. Tokens USB / Smart Cards (PKCS#11):

   • Conecte o dispositivo físico com middleware homologado (SafeSign, GD Burti, SafeNet, OpenSC, etc.).
   • O provedor Pkcs11CertificateProvider detectará o token e seus slots.

---

3. Garantia de Operação Real

1. Toda assinatura é gerada criptograficamente através dos provedores JCA/JCE reais.
2. A resposta do protocolo CCSP/1 contém assinaturas válidas e certificados X.509 autênticos.
3. Não há certificados simulados ou flags artificiais nas respostas do agente.