Skip to content

README.md

Latest commit

 

History

History
188 lines (116 loc) · 3.76 KB

README.md

File metadata and controls

188 lines (116 loc) · 3.76 KB
Raw

🖋️ API de Assinatura de Documentos

Java Spring Boot Status

Uma API REST para assinatura digital e verificação de documentos, garantindo integridade, autenticidade e segurança.

📌 Sumário

🚀 Endpoints

1️⃣ Assinar Documento

POST /documetos/asinaturas

Assina digitalmente o documento.

Request Body:

json { "conteudo": "Texto ou conteúdo do documento" }

Response:

json { "conteudo": "Texto ou conteúdo do documento", "assinatura": "Base64 da assinatura digital" }

2️⃣ Verificar Assinatura

POST /documetos/asinaturas/verificar

Verifica se a assinatura de um documento é válida.

Request Body:

json { "conteudo": "Texto ou conteúdo do documento", "assinatura": "Base64 da assinatura digital" }

Response:

json true

3️⃣ Obter Algoritmo de Assinatura

GET /documetos/asinaturas/algoritimo

Retorna o algoritmo utilizado para assinatura.

Response:

json "SHA256withRSA"

🗂 Modelo de Documento

public Documento(String conteudo, String assinatura) {
    this.conteudo = conteudo;
    this.assinatura = assinatura;
}

// getters e setters

}

  • conteudo: Conteúdo do documento a ser assinado.
  • assinatura: Assinatura digital codificada em Base64.

💻 Exemplos de Requisição

Assinar Documento:

bash curl -X POST http://localhost:8080/documetos/asinaturas
-H "Content-Type: application/json"
-d '{"conteudo":"Meu documento importante"}'

Verificar Assinatura:

bash curl -X POST http://localhost:8080/documetos/asinaturas/verificar
-H "Content-Type: application/json"
-d '{"conteudo":"Meu documento importante","assinatura":"<assinatura_base64>"}'

Obter Algoritmo:

bash curl http://localhost:8080/documetos/asinaturas/algoritimo

⚙️ Requisitos

  • Java 25 ou superior
  • Spring Boot 3.5.x ou superior
  • Certificado digital de teste auto-assinado incluso no projeto (PKCS#12 .pfx)

🏃 Execução

  1. Configure seu certificado digital no KeyStoreUtils.
  2. Compile e execute a aplicação:

bash ./mvnw spring-boot:run

  1. Acesse os endpoints via Postman, cURL ou front-end.

🔐 Observações

  • Suporta RSA, EC e Ed25519.
  • A assinatura é codificada em Base64 para transporte seguro.
  • O algoritmo é definido automaticamente baseado no tipo e tamanho da chave privada.
  • Ideal para sistemas que exigem compliance em assinatura digital.

📌 Estrutura de Pastas

src/
├─ main/
   ├─ java/
   │  └─ br/com/lrbarros/assinador/
   │     ├─ controller/AssinaturaDocumetosController.java
   │     ├─ service/AssinadorService.java
   │     ├─ model/Documento.java
   │     └─ util/KeyStoreUtils.java
   └─ resources/

📝 Observações Técnicas

  • AssinadorService é responsável por inicializar as chaves, assinar e verificar documentos.

  • O algoritmo de assinatura é escolhido automaticamente:

    • RSA >= 3072 bits → RSASSA-PSS
    • RSA < 3072 bits → SHA256withRSA
    • EC <= 256 bits → SHA256withECDSA
    • EC > 256 bits → SHA384withECDSA
    • Ed25519 → Ed25519

  • As assinaturas são feitas utilizando java.security.Signature com parâmetros corretos para cada algoritmo.

  • As exceções relacionadas a criptografia são encapsuladas em CryptoException.