feat: initial commit - cybercore signer desktop agent

2026-10-11 08:20:24 -03:00
commit ccfa358f97
206 changed files with 23952 additions and 0 deletions
@@ -0,0 +1,48 @@
+# 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`:
+
+```bash
+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.