-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
690b780
commit 62452bd
Showing
1 changed file
with
136 additions
and
123 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,160 +1,173 @@ | ||
| # OsintIA_Tools.py | ||
| # **OsintIA_Tools.py** | ||
|
|
||
| **OsintIA_Tools.py** é uma ferramenta automatizada de coleta e análise de informações públicas, integrando métodos de **OSINT (Open Source Intelligence)** e inteligência artificial para enriquecer os resultados. Este script foi desenvolvido com foco na **cibersegurança**, permitindo identificar possíveis vulnerabilidades e ameaças em domínios ou organizações. | ||
| **OsintIA_Tools.py** é uma ferramenta automatizada de coleta e análise de informações públicas, integrando métodos de OSINT (*Open Source Intelligence*) e inteligência artificial para enriquecer os resultados. Este script foi desenvolvido com foco na cibersegurança, permitindo identificar possíveis vulnerabilidades e ameaças em domínios ou organizações. | ||
|
|
||
| A ferramenta utiliza várias técnicas e integrações com ferramentas populares para realizar tarefas como resolução de IP, consultas WHOIS, varreduras de portas, coleta de subdomínios, extração de metadados, e muito mais. Além disso, análises avançadas são realizadas com IA (OpenAI API) para interpretar os resultados e sugerir ações. | ||
| A ferramenta utiliza várias técnicas e integrações com ferramentas populares para realizar tarefas como resolução de IP, consultas WHOIS, varreduras de portas, coleta de subdomínios, extração de metadados, e muito mais. Além disso, análises avançadas são realizadas com IA (*OpenAI API*) para interpretar os resultados e sugerir ações. | ||
|
|
||
| --- | ||
|
|
||
| ## Funcionalidades | ||
| ## **O que há de novo na versão 3.1** | ||
|
|
||
| 1. **Resolução de IP com Shodan**: | ||
| - Obtém informações detalhadas do IP utilizando Shodan. | ||
| - Inclui verificações adicionais com `dig` e `ping` como fallback. | ||
| A nova versão do **OsintIA_Tools_v3.1** traz importantes melhorias para otimizar a usabilidade, confiabilidade e riqueza dos relatórios gerados. Aqui estão as principais novidades: | ||
|
|
||
| 2. **Consulta WHOIS com Fallback para Amass**: | ||
| - Realiza consultas WHOIS para obter informações sobre o domínio. | ||
| - Caso falhe, utiliza o Amass para resultados mais abrangentes. | ||
| ### **Melhorias no Código** | ||
| 1. **Geração de Índice HTML Funcional**: | ||
| - O relatório HTML agora inclui um índice interativo, permitindo navegar entre as seções com apenas um clique. | ||
|
|
||
| 3. **Escaneamento de Portas com Nmap**: | ||
| - Identifica portas abertas e serviços rodando no domínio. | ||
| - Resultados analisados por IA para identificar potenciais riscos. | ||
| 2. **Formatação Avançada do Relatório**: | ||
| - A saída dos textos analisados com IA foi aprimorada, apresentando parágrafos claros e organizados, facilitando a leitura e interpretação. | ||
|
|
||
| 4. **Links Indexados com Google Dorks e Photon**: | ||
| - Realiza buscas avançadas usando Google Dorks. | ||
| - Integra Photon para coleta adicional de URLs relacionadas. | ||
| - Analisa os dados coletados com IA para identificar informações sensíveis. | ||
| 3. **Remoção de Códigos ANSI**: | ||
| - Caracteres de escape ANSI, como `[94m`, foram completamente removidos dos resultados das ferramentas, como *Sublist3r* e *WhatWeb*, garantindo um relatório limpo e profissional. | ||
|
|
||
| 5. **Extração de Metadados com Metagoofil**: | ||
| - Busca e baixa arquivos públicos (PDF, DOCX, XLS). | ||
| - Extrai metadados para análise detalhada. | ||
| - Utiliza IA para avaliar os riscos associados aos dados extraídos. | ||
| 4. **Conclusão Final Enriquecida**: | ||
| - Agora, a conclusão do relatório apresenta: | ||
| - Resumo detalhado dos resultados de cada ferramenta (*Shodan*, *Nmap*, *TheHarvester*, entre outras). | ||
| - Identificação de riscos críticos e seu impacto no domínio. | ||
| - Recomendações organizadas por prioridade (*alta*, *média*, *baixa*) para mitigar os riscos. | ||
| - Melhores práticas e ferramentas sugeridas para fortalecer a segurança. | ||
|
|
||
| 6. **Descoberta de Subdomínios com Sublist3r**: | ||
| - Coleta subdomínios associados ao domínio principal. | ||
| - IA analisa os resultados para identificar subdomínios sensíveis ou vulneráveis. | ||
| 5. **Melhorias na Conexão com a API da OpenAI**: | ||
| - Adicionadas pausas estratégicas antes das chamadas à API para maior estabilidade. | ||
| - Implementado um sistema de *retry* com múltiplas tentativas em caso de falha temporária. | ||
|
|
||
| 7. **Detecção de Tecnologias com WhatWeb**: | ||
| - Identifica tecnologias e frameworks utilizados no site. | ||
| - IA avalia potenciais vulnerabilidades relacionadas às tecnologias detectadas. | ||
| 6. **Otimização do DNSEnum**: | ||
| - Utilização de servidores DNS confiáveis (Google, Cloudflare e Quad9). | ||
| - Ajustes no `timeout` e no número de *threads* para reduzir o tempo de execução. | ||
|
|
||
| 8. **Coleta de Informações com TheHarvester**: | ||
| - Recolhe e analisa dados como emails e hosts utilizando fontes como Google, Bing, CertSpotter, entre outras. | ||
| - Inclui análise com IA para identificar dados sensíveis ou riscos. | ||
| 7. **Correções e Estabilidade**: | ||
| - Melhorias na indentação e organização do código para evitar erros como *IndentationError*. | ||
| - Reutilização de funções como `write_section`, garantindo mais eficiência no desenvolvimento e manutenção. | ||
|
|
||
| 9. **Enumeração DNS com DNSEnum**: | ||
| - Realiza consultas DNS detalhadas. | ||
| - Analisa os dados obtidos com IA para identificar potenciais falhas de configuração ou exposições. | ||
| ### **Melhorias no Relatório** | ||
| 1. **Resultados Detalhados por Ferramenta**: | ||
| - Cada ferramenta tem seus resultados apresentados com mais clareza e detalhamento: | ||
| - *Shodan*: Serviços e vulnerabilidades detectadas. | ||
| - *Nmap*: Portas abertas e riscos associados. | ||
| - *TheHarvester*: Subdomínios e pontos de entrada expostos. | ||
| - *DNSEnum*: Possíveis falhas de configuração DNS. | ||
| - Todas as análises foram enriquecidas com IA para identificar riscos e propor soluções práticas. | ||
|
|
||
| 10. **Conclusão Final com IA**: | ||
| - Gera um resumo dos principais achados, riscos e vulnerabilidades identificados. | ||
| - Fornece recomendações práticas de mitigação e melhores práticas de segurança. | ||
| 2. **Navegação Intuitiva**: | ||
| - O índice HTML permite acessar cada seção do relatório de forma rápida e eficiente. | ||
|
|
||
| 3. **Conclusão Final Robusta**: | ||
| - A conclusão apresenta: | ||
| - Resumo executivo dos principais achados. | ||
| - Riscos organizados por prioridade. | ||
| - Recomendações práticas e detalhadas. | ||
|
|
||
| --- | ||
|
|
||
| ## Como Usar | ||
| ## **Funcionalidades** | ||
|
|
||
| ### **Principais Funções** | ||
| - **Resolução de IP com Shodan**: | ||
| - Obtém informações detalhadas do IP utilizando *Shodan*. | ||
| - Inclui verificações adicionais com *dig* e *ping* como fallback. | ||
|
|
||
| - **Consulta WHOIS com Fallback para Amass**: | ||
| - Realiza consultas *WHOIS* para obter informações sobre o domínio. | ||
| - Utiliza o *Amass* como alternativa para consultas mais abrangentes. | ||
|
|
||
| - **Escaneamento de Portas com Nmap**: | ||
| - Identifica portas abertas e serviços rodando no domínio. | ||
| - Resultados analisados por IA para identificar potenciais riscos. | ||
|
|
||
| - **Links Indexados com Google Dorks e Photon**: | ||
| - Realiza buscas avançadas usando Google Dorks. | ||
| - Integra *Photon* para coleta adicional de URLs relacionadas. | ||
| - Analisa os dados coletados com IA para identificar informações sensíveis. | ||
|
|
||
| - **Extração de Metadados com Metagoofil**: | ||
| - Busca e baixa arquivos públicos (PDF, DOCX, XLS). | ||
| - Extrai metadados para análise detalhada. | ||
| - Utiliza IA para avaliar os riscos associados aos dados extraídos. | ||
|
|
||
| - **Descoberta de Subdomínios com Sublist3r**: | ||
| - Coleta subdomínios associados ao domínio principal. | ||
| - IA analisa os resultados para identificar subdomínios sensíveis ou vulneráveis. | ||
|
|
||
| - **Detecção de Tecnologias com WhatWeb**: | ||
| - Identifica tecnologias e frameworks utilizados no site. | ||
| - IA avalia potenciais vulnerabilidades relacionadas às tecnologias detectadas. | ||
|
|
||
| ### Pré-requisitos | ||
| - **Coleta de Informações com TheHarvester**: | ||
| - Recolhe e analisa dados como e-mails e hosts utilizando fontes como Google, Bing, CertSpotter, entre outras. | ||
| - Inclui análise com IA para identificar dados sensíveis ou riscos. | ||
|
|
||
| - **Enumeração DNS com DNSEnum**: | ||
| - Realiza consultas DNS detalhadas utilizando servidores confiáveis. | ||
| - Analisa os dados obtidos com IA para identificar potenciais falhas de configuração ou exposições. | ||
|
|
||
| - **Conclusão Final com IA**: | ||
| - Gera um resumo dos principais achados, riscos e vulnerabilidades identificados. | ||
| - Fornece recomendações práticas de mitigação e melhores práticas de segurança. | ||
|
|
||
| --- | ||
|
|
||
| ## **Como Usar** | ||
|
|
||
| ### **Pré-requisitos** | ||
| Certifique-se de que as seguintes dependências estão instaladas no seu sistema: | ||
|
|
||
| - **Python 3.10+** | ||
| - Bibliotecas Python: | ||
| ```bash | ||
| pip install requests beautifulsoup4 openai | ||
| Ferramentas do Kali Linux: | ||
| dig, whois, nmap, wget, metagoofil, theHarvester, Sublist3r, WhatWeb, Photon, dnsenum. | ||
| Execução | ||
| Clone o repositório: | ||
| git clone https://github.com/seu-usuario/osintia_tools.git | ||
|
|
||
| cd osintia_tools | ||
|
|
||
| **Execute o script:** | ||
| ``` | ||
| python3 OsintIA_Tools.py <domínio> | ||
| ``` | ||
|
|
||
| **Exemplos:** | ||
| ``` | ||
| python3 OsintIA_Tools.py globo.com``` | ||
| **Saída** | ||
| Relatório em Texto: osint_report.txt | ||
| Relatório em HTML: osint_report.html | ||
| **Principais Tecnologias e Ferramentas** | ||
| Shodan API: Obtenção de dados detalhados sobre IPs e dispositivos conectados. | ||
| Nmap: Varredura de portas e identificação de serviços. | ||
| Photon: Coleta avançada de URLs indexadas. | ||
| Metagoofil: Extração de metadados de arquivos públicos. | ||
| WhatWeb: Detecção de tecnologias e frameworks. | ||
| Sublist3r: Descoberta de subdomínios. | ||
| TheHarvester: Coleta de dados públicos, incluindo emails e hosts. | ||
| OpenAI API: Inteligência Artificial para análises detalhadas e recomendações. | ||
| Estrutura do Script | ||
| Instalação e Verificação de Dependências | ||
| O script verifica se todas as dependências estão instaladas e sugere a instalação caso faltem. | ||
| Execução de Cada Passo | ||
| Para cada passo, resultados são coletados e analisados individualmente. | ||
| Após cada coleta, análises são realizadas com IA para enriquecer o relatório. | ||
| Relatórios | ||
| Os resultados são apresentados de forma clara em arquivos TXT e HTML. | ||
| Casos de Uso | ||
| Auditoria de Segurança: | ||
| Identificação de vulnerabilidades em infraestruturas expostas. | ||
| Avaliação de subdomínios e configurações DNS. | ||
| Reconhecimento em Pentests: | ||
| Coleta de informações para suportar etapas iniciais de testes de invasão. | ||
| Análise de Metadados: | ||
| Extração e avaliação de dados sensíveis em documentos públicos. | ||
| Educação e Pesquisa: | ||
| Uso em projetos educacionais e estudos relacionados à cibersegurança e inteligência. | ||
| Contribuições | ||
| Contribuições são bem-vindas! Caso queira melhorar ou adicionar funcionalidades: | ||
| ``` | ||
| - Ferramentas do Kali Linux: | ||
| - `dig`, `whois`, `nmap`, `wget`, `metagoofil`, `theHarvester`, `Sublist3r`, `WhatWeb`, `Photon`, `dnsenum`. | ||
|
|
||
| Faça um fork do projeto. | ||
| Crie um branch para sua funcionalidade: | ||
| bash | ||
| Copiar código | ||
| git checkout -b minha-melhoria | ||
| Submeta um Pull Request! | ||
| --- | ||
|
|
||
| ## Atenção | ||
| ### **Execução** | ||
|
|
||
| Para utilizar o **OsintIA_Tools.py**, é necessário configurar novas chaves de API para as integrações com a OpenAI e o Shodan. As chaves atuais **não devem ser reutilizadas** por questões de segurança. | ||
| 1. Clone o repositório: | ||
| ```bash | ||
| git clone https://github.com/seu-usuario/osintia_tools.git | ||
| cd osintia_tools | ||
| ``` | ||
|
|
||
| ### Configuração de Chaves | ||
| 2. Execute o script: | ||
| ```bash | ||
| python3 OsintIA_Tools.py <domínio> | ||
| ``` | ||
|
|
||
| 1. **Gere uma nova chave OPENAI_API_KEY**: | ||
| - Acesse [https://platform.openai.com/account/api-keys](https://platform.openai.com/account/api-keys). | ||
| - Crie uma nova chave de API e substitua no script no local indicado: | ||
| ```python | ||
| OPENAI_API_KEY = "sua-nova-chave-aqui" | ||
| ``` | ||
| 3. Exemplos: | ||
| ```bash | ||
| python3 OsintIA_Tools.py globo.com | ||
| ``` | ||
|
|
||
| 2. **Gere uma nova chave SHODAN_API_KEY**: | ||
| - Acesse [https://account.shodan.io/](https://account.shodan.io/). | ||
| - Crie ou recupere sua chave de API e substitua no script no local indicado: | ||
| ```python | ||
| SHODAN_API_KEY = "sua-nova-chave-aqui" | ||
| ``` | ||
| --- | ||
|
|
||
| ### Importante | ||
| - Nunca compartilhe suas chaves de API publicamente ou em repositórios públicos. | ||
| - Mantenha suas chaves seguras para evitar uso indevido e possíveis violações de segurança. | ||
| ### **Saídas** | ||
|
|
||
| Se precisar de ajuda, consulte a documentação oficial das APIs. 😊 | ||
| - **Relatório em Texto**: `osint_report.txt` | ||
| - **Relatório em HTML**: `osint_report.html` | ||
|
|
||
| ### Licença | ||
| Este projeto é licenciado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes. | ||
| --- | ||
|
|
||
| ## **Contribuições** | ||
|
|
||
| Contribuições são bem-vindas! Caso queira melhorar ou adicionar funcionalidades: | ||
| 1. Faça um fork do projeto. | ||
| 2. Crie um branch para sua funcionalidade: | ||
| ```bash | ||
| git checkout -b minha-melhoria | ||
| ``` | ||
| 3. Submeta um Pull Request! | ||
|
|
||
| --- | ||
|
|
||
| ## **Atenção** | ||
|
|
||
| Para utilizar o OsintIA_Tools.py, é necessário configurar novas chaves de API para as integrações com a OpenAI e o Shodan. Consulte o release notes para detalhes. | ||
|
|
||
| --- | ||
|
|
||
| ## **Licença** | ||
|
|
||
| Este projeto é licenciado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes. | ||
|
|
||
| --- |