Se quiser modificar/desenvolver o Artemis, leia primeiro Desenvolvimento.

Artemis é um software experimental, em desenvolvimento ativo - use por sua conta e risco.

Para conversar sobre o Artemis, entre no servidor Discord!

Cooperação e conferências

Artemis foi apresentado no BlackHat USA 2024 em Las Vegas e no BlackHat Europe 2025 em Londres. Para mais informações sobre o Artemis no BlackHat, clique aqui e aqui.

O projeto também foi apresentado na 71ª Reunião do TF-CSIRT em Copenhague, na 69ª Reunião do TF-CSIRT em Bucareste e na conferência CONFidence, entre outras.

Cooperação

O desenvolvimento do Artemis foi apoiado pelo Google Summer of Code 2024 e 2025.

Funcionalidades

Para uma lista atualizada de funcionalidades, consulte a documentação.
A mais importante é a possibilidade de exportar facilmente relatórios como:

Os seguintes endereços contêm dados de sistema de controle de versão:

• https://subdomain1.example.com:443/.git/

Tornar um repositório de código público pode permitir que um invasor aprenda o funcionamento interno de um sistema e, se contiver senhas ou chaves de API, também obter acesso não autorizado. Esses dados não devem estar disponíveis publicamente.

Os seguintes endereços contêm versões antigas do Joomla:

• https://subdomain2.example.com:443 - Joomla 2.5.4

Se um site não for mais usado, recomendamos desativá-lo para eliminar o risco de exploração de vulnerabilidades conhecidas em versões antigas do Joomla. Caso contrário, recomendamos atualizações regulares do núcleo e dos plugins do Joomla.

A possibilidade de preparar automaticamente tais relatórios nos permitiu notificar entidades em nossa circunscrição sobre centenas de milhares de vulnerabilidades.

Capturas de tela

Desenvolvimento

Para iniciar uma versão modificada localmente do Artemis, execute:

Este script copia automaticamente o arquivo de ambiente de exemplo (env.example) para .env se ele não existir. Você pode então configurar as configurações no arquivo .env de acordo com suas necessidades. Isso inclui personalizar o user-agent definindo a variável CUSTOM_USER_AGENT, bem como outros parâmetros relevantes. Para uma lista completa das variáveis de configuração e suas descrições, consulte a seção de Configuração na documentação.

A imagem do Artemis é então construída localmente (a partir do código que você está desenvolvendo), não baixada do Docker Hub. Para web, você também poderá ver os resultados das modificações no código na página sem recarregar o contêiner inteiro.

Testes

Para executar os testes, use:

[!WARNING] Evite usar python -m unittest diretamente como command: em docker-compose.test.yaml. Quando o Python é executado como PID 1, os subprocessos, especialmente binários Go como Nuclei, sofrem de I/O lento ou degradado porque o PID 1 lida com sinais e stdout/stderr de forma diferente. Use unittest-parallel, pois seus processos de trabalho evitam o problema do PID 1.

Formatação de código

Artemis usa pre-commit para executar linters e formatar o código. pre-commit é executado no CI para verificar se o código está formatado corretamente.

Para executar localmente, use:

Para configurar pre-commit para que seja executado antes de cada commit, use:

Modificando dependências

Usamos pip-tools para gerenciar dependências. Para adicionar ou atualizar uma dependência:

1. Modifique requirements.in (ou docs/requirements.in para dependências de documentação),
2. Execute ./scripts/compile-requirements para gerar o(s) arquivo(s) requirements.txt congelado(s),
3. Faça commit de ambos os arquivos .in e .txt.

Construindo a documentação

Para construir a documentação, use:

Como escrever meu próprio módulo?

Por favor, consulte a documentação.

Contribuindo

Contribuições são bem-vindas! Agradeceremos tanto ideias para novos módulos do Artemis (adicionadas como issues no GitHub) quanto pull requests com novos módulos ou melhorias de código.

Por mais óbvio que pareça, lembramos gentilmente que, ao contribuir para o Artemis, você concorda que a Licença BSD de 3 Cláusulas se aplicará automaticamente à sua contribuição, sem a necessidade de declarações adicionais.

Desenvolvimento

Antes de abrir um PR, certifique-se de instalar o pre-commit:

• pre-commit install

E execute-o contra suas alterações.

Contribuidores

Muito obrigado às seguintes pessoas que contribuíram para o desenvolvimento do Artemis, especialmente o clube de ciências KN Cyber da Universidade de Tecnologia de Varsóvia que iniciou o projeto!