Skip to content

README.md

Latest commit

 

History

History
118 lines (78 loc) · 3.21 KB

README.md

File metadata and controls

118 lines (78 loc) · 3.21 KB

FilePack API

Esse projeto é a continuação do projeto apresentado no artigo do Blog DevSuperior, nessa continuação iremos abordar esses temas em live:

  • Provisionar infraestrutura completa via CloudFormation
  • Validar distribuição Multi-AZ das tasks
  • Realizar teste de carga com k6 para acionar o scaling
  • Observar métricas e logs no CloudWatch

O detalhamento do conteúdo e passo a passo está em DEMO.md.

API Spring Boot para empacotamento e criptografia de múltiplos arquivos em um único arquivo ZIP protegido por senha.

📋 Descrição

FilePack API é uma aplicação que recebe múltiplos arquivos via upload e gera um arquivo ZIP criptografado, protegido com a senha fornecida pelo usuário. Ideal para cenários onde é necessário:

  • Agrupar múltiplos arquivos em um único pacote
  • Proteger arquivos sensíveis com criptografia
  • Facilitar o download de múltiplos documentos simultaneamente
  • Garantir segurança no transporte de dados

🚀 Como Executar a Aplicação

Pré-requisitos

  • Java 25 ou superior
  • Maven 3.6+
  • GitBash

Compilar e Executar

# Compilar o projeto
./mvnw clean package

# Executar a aplicação
./mvnw spring-boot:run

A aplicação estará disponível em: $SERVICE_URL

🔧 Endpoint da API

URL: POST /api/filepack

Parâmetros:

  • files (multipart/form-data): Arquivos para empacotar (múltiplos)
  • password (string): Senha para criptografar o ZIP

Resposta:

  • Arquivo ZIP criptografado para download
  • Content-Type: application/zip

📝 Exemplos de Uso com cURL

Nota: Os arquivos de exemplo estão localizados na pasta data/ na raiz do projeto.

Configurar URL do Serviço

Antes de executar os testes, defina a variável SERVICE_URL de acordo com seu ambiente:

Executando localmente:

export SERVICE_URL="http://localhost:8080"

Executando na AWS (substitua pelo endereço do seu ALB):

export SERVICE_URL="http://seu-alb-123456.us-east-1.elb.amazonaws.com"

Exemplo 0: Validação Básica (1 arquivo)

Quando usar: Validação inicial, verificar se a API está funcionando, testes de conectividade

Tamanho do upload: ~170 KB

curl -X POST $SERVICE_URL/api/filepack \
  -F "files=@data/infrastructure_config.xml" \
  -F "password=teste123" \
  --output validation_pack.zip

🔓 Como Descompactar o ZIP Resultante

No Windows com GitBash e 7zip

"C:\Program Files\7-Zip\7z.exe" x validation_pack.zip -pteste123 -oextracted/

No Linux/Mac

# Usando unzip
unzip -P teste123 validation_pack.zip

# Ou extrair para um diretório específico
unzip -P teste123 validation_pack.zip -d extracted/

Nota: A senha usada para descompactar deve ser a mesma fornecida no parâmetro password durante a criação do ZIP.

🔒 Segurança

  • O ZIP gerado utiliza criptografia AES
  • As senhas não são armazenadas no servidor
  • Cada requisição gera um novo arquivo ZIP
  • Recomenda-se usar senhas fortes (mínimo 8 caracteres, com letras, números e símbolos)

📄 Licença

Este projeto foi desenvolvido para fins educacionais como parte do blog DevSuperior.