Conhecimento de ataque,
pronto para integrar.

Visão geral

A Arachne expõe uma matriz de ataques a aplicações web inspirada em MITRE ATT&CK. A API mantém os mesmos dados usados pela interface e acrescenta operações de busca, correlação, análise de caminhos e exportação.

Como executar

O servidor não possui dependências externas. Na raiz do projeto:

copiarnpm start
# ou
node server.js

Por padrão, o serviço escuta em http://localhost:8080.

copiarARACHNE_PORT=9000 ARACHNE_API_KEY="sua-chave" node server.js

Autenticação e rate limiting

Quando uma chave é configurada, use um dos formatos abaixo. O método recomendado é o Bearer token.

copiarcurl -H "Authorization: Bearer sua-chave" http://localhost:8080/api/techniques
curl -H "X-API-Key: sua-chave" http://localhost:8080/api/chains
curl "http://localhost:8080/api/chains?api_key=sua-chave"

O servidor responde com 401 para uma chave ausente ou inválida. O limite é por IP e processo; os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset informam o estado. Ao exceder, a resposta é 429.

Convenções

Base URL: http://<host>:<porta>/api. Todas as rotas são somente leitura e aceitam GET. Listas retornam um envelope com data, count e, quando aplicável, pagination.

{
  "data": [],
  "count": 43,
  "pagination": { "total": 43, "limit": 100, "offset": 0, "returned": 43 }
}

Filtros comuns: q (texto), limit (máx. 500), offset, tactic, severity e difficulty.

Modelos de dados

Endpoints

Os exemplos usam a base http://localhost:8080. Respostas de erro seguem { "error": "...", "message": "..." }.

Catálogo

curl http://localhost:8080/api/health

curl "http://localhost:8080/api/tactics?q=recon"
curl http://localhost:8080/api/tactics/TA-W01

curl "http://localhost:8080/api/techniques?severity=4&limit=10"
curl http://localhost:8080/api/techniques/W008

curl "http://localhost:8080/api/chains?difficulty=Avancado"
curl http://localhost:8080/api/chains/CHAIN-004

Análise

curl "http://localhost:8080/api/graph/path?from=W001&to=W022"

curl "http://localhost:8080/api/search?q=xss"

Exportações

curl -H "Authorization: Bearer $KEY" -o arachne.stix.json http://localhost:8080/api/export/stix

Integração com SIEM / SOC

Use o STIX completo para onboarding em MISP, OpenCTI, TheHive ou Elastic. Para enriquecimento em tempo real, consulte uma técnica a partir do id detectado no alerta:

copiarcurl -H "Authorization: Bearer $KEY" \
  http://localhost:8080/api/techniques/W008

A resposta inclui severidade, mitigações, detecção e cadeias relacionadas. Para um playbook acompanhar os próximos passos:

copiarcurl -H "Authorization: Bearer $KEY" \
  http://localhost:8080/api/chains/CHAIN-004/steps

Para threat hunting, use /api/graph/path para explicar como um atacante pode progredir entre duas técnicas. Faça cache no proxy quando apropriado, monitore /api/health e mantenha a API atrás de TLS.

Códigos de erro

{ "error": "not_found", "message": "Técnica W999 não encontrada." }

Referências: STIX 2.1, MITRE ATT&CK, RFC 4180 e RFC 4122. A documentação editável também está em API.md.