CoWitness

CoWitness é uma ferramenta projetada para funcionar como um servidor HTTP, HTTPS e DNS. Ela permite servir páginas web, registrar requisições HTTP e personalizar respostas DNS. Este README fornece uma visão geral dos recursos e instruções sobre como compilar e usar a ferramenta CoWitness.

Recursos

• Servidor HTTP: O CoWitness inclui um servidor HTTP que escuta na porta 80. Ele pode servir arquivos estáticos do diretório de trabalho atual. Cada requisição HTTP é registrada, incluindo o endereço IP do cliente, o recurso solicitado e o user agent.

• Servidor HTTPS: Além do servidor HTTP, o CoWitness também fornece um servidor HTTPS que escuta na porta 443. Semelhante ao servidor HTTP, ele serve arquivos estáticos e registra cada requisição.

• Servidor DNS: O CoWitness funciona como um servidor DNS, escutando na porta 53. Ele permite personalizar respostas DNS, incluindo registros NS e A. Requisições DNS são registradas, incluindo o endereço IP do cliente e o domínio solicitado.

• Registro de logs: O CoWitness cria arquivos de log para requisições HTTP e DNS. Os logs são anexados aos arquivos existentes, permitindo rastrear e analisar a atividade do servidor.

• Modo silencioso: O CoWitness pode ser executado em modo silencioso passando o argumento de linha de comando -q. Nesse modo, o banner de arte ASCII não será exibido.

Pré-requisitos 📝

Antes de usar o CoWitness, garanta que você possui os seguintes requisitos:

• Linguagem de programação Go instalada no seu sistema, obtenha-a AQUI go 1.21 é necessário se você compilar a partir do código-fonte.
• Acesso à internet para baixar as dependências Go.
• Um servidor remoto com endereço IP público.

Compilação 👨🏼‍🔧

Siga estes passos para instalar e compilar o CoWitness:

1. Clone o repositório do CoWitness do GitHub:

git clone https://github.com/your-username/CoWitness.git

2. Acesse o diretório do CoWitness:

cd CoWitness

3. Compile o executável do CoWitness:

make -f Makefile build

Este comando compila o código-fonte do CoWitness e cria um arquivo executável para amd64 e arm64.

Instalação 👨🏻‍💻

Para usar o CoWitness em um servidor remoto, siga estes passos:

1. Escolha um nome de domínio para o seu ambiente de testes.
2. Configure um servidor remoto e obtenha um endereço IP público para ele.
3. Registre seus name servers para apontar para o endereço IP público. (Consulte a documentação do seu registrador de domínio para obter instruções sobre como configurar name servers.)
4. Crie glue records para associar o endereço IP ao seu servidor remoto. Esta etapa pode variar dependendo do seu provedor de DNS. Consulte a documentação deles para obter orientações sobre como criar glue records.
5. Garanta que as portas 80 e 53 estejam disponíveis no servidor remoto. Configure qualquer firewall ou configurações de rede para permitir conexões de entrada nessas portas.
6. Transfira o executável do CoWitness para o servidor remoto usando um método seguro, como SCP ou SFTP.

Conecte-se ao servidor remoto via SSH:

ssh username@your-server-ip

Uma maneira fácil de instalar o cowitness é obter o pacote de build automatizado aqui que você pode então usar curl ou wget no seu sistema ou copiar o arquivo via scp do seu sistema.

cowitness

Personalização ⚒️

Você pode personalizar o CoWitness para atender às suas necessidades específicas. Aqui estão algumas modificações possíveis:

• Alterar as portas padrão: Consulte a ajuda de uso dos flags da CLI para alterar as portas padrão

• Modificar os caminhos dos arquivos de log: Você pode alterar os caminhos dos arquivos de log HTTP e DNS (http.log e dns.log) atualizando as chamadas os.OpenFile no código-fonte.

Comunidade e Contribuições

Aceitamos contribuições e feedback da comunidade. Se você encontrar algum problema ou tiver sugestões de melhorias, abra uma issue ou envie um pull request no nosso repositório do GitHub!

Licença

O CoWitness é distribuído sob a Licença MIT.