forensic-cli 1.2.6__tar.gz → 1.2.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. {forensic_cli-1.2.6/src/forensic_cli.egg-info → forensic_cli-1.2.7}/PKG-INFO +29 -98
  2. forensic_cli-1.2.7/README.md +123 -0
  3. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/pyproject.toml +2 -1
  4. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/setup.py +1 -1
  5. {forensic_cli-1.2.6 → forensic_cli-1.2.7/src/forensic_cli.egg-info}/PKG-INFO +29 -98
  6. forensic_cli-1.2.6/README.md +0 -193
  7. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/LICENSE +0 -0
  8. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/LICENSE-GPL +0 -0
  9. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/setup.cfg +0 -0
  10. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/__init__.py +0 -0
  11. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/__init__.py +0 -0
  12. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/browser.py +0 -0
  13. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/describe.py +0 -0
  14. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/email.py +0 -0
  15. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/network.py +0 -0
  16. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/commands/utils.py +0 -0
  17. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/cli/main.py +0 -0
  18. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/__init__.py +0 -0
  19. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/browser_history.py +0 -0
  20. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/common_words.py +0 -0
  21. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/downloads_history.py +0 -0
  22. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/fav_screen.py +0 -0
  23. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/logins.py +0 -0
  24. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/browser/unusual_patterns.py +0 -0
  25. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/data/__init__.py +0 -0
  26. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/data/data_recovery.py +0 -0
  27. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/db/db.py +0 -0
  28. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/email/email_parser.py +0 -0
  29. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/email/header_analysis.py +0 -0
  30. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/models/orm.py +0 -0
  31. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/models/schemas.py +0 -0
  32. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/__init__.py +0 -0
  33. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/arp_scan.py +0 -0
  34. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/dns_recon.py +0 -0
  35. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/fingerprinting.py +0 -0
  36. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/ip_info.py +0 -0
  37. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/network_map.py +0 -0
  38. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/ping_sweep.py +0 -0
  39. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/port_scanner.py +0 -0
  40. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/smb_scan.py +0 -0
  41. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/snmp_scan.py +0 -0
  42. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/traceroute.py +0 -0
  43. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/network/utils.py +0 -0
  44. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/registry.py +0 -0
  45. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/utils/__init__.py +0 -0
  46. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/core/utils/gerar_amostras.py +0 -0
  47. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/SOURCES.txt +0 -0
  48. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/dependency_links.txt +0 -0
  49. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/entry_points.txt +0 -0
  50. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/requires.txt +0 -0
  51. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/top_level.txt +0 -0
  52. {forensic_cli-1.2.6 → forensic_cli-1.2.7}/tests/test_file_inspector.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: forensic-cli
3
- Version: 1.2.6
3
+ Version: 1.2.7
4
4
  Summary: DevKit Forense - CLI para análise de navegadores e rede
5
5
  Home-page: https://github.com/ErickG123/devkit_forense
6
6
  Author: Erick Gabriel dos Santos Alves
@@ -8,6 +8,7 @@ Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
8
8
  License: MIT
9
9
  Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
10
10
  Project-URL: Source, https://github.com/ErickG123/devkit_forense
11
+ Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
11
12
  Keywords: forensics,cli,network,browser
12
13
  Requires-Python: >=3.11
13
14
  Description-Content-Type: text/markdown
@@ -106,16 +107,10 @@ Dynamic: requires-python
106
107
  - [Network](#network)
107
108
  - [Browser](#browser)
108
109
  - [Email](#email)
109
- 4. [Aplicações de Apoio](#aplicações-de-apoio)
110
- - [Dashboard](#dashboard)
111
- - [Visualizadores de Resultados](#visualizadores-de-resultados)
112
- - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)
113
- 5. [Fluxo de Integração](#fluxo-de-integração)
114
- 6. [Tecnologias Utilizadas](#tecnologias-utilizadas)
115
- 7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
116
- 8. [Instalação](#instalação)
117
- 9. [Exemplos de Execução](#exemplos-de-execução)
118
- 10. [Considerações Finais](#considerações-finais)
110
+ 4. [Tecnologias Utilizadas](#tecnologias-utilizadas)
111
+ 5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
112
+ 6. [Instalação](#instalação)
113
+ 7. [Exemplos de Execução](#exemplos-de-execução)
119
114
 
120
115
  ---
121
116
 
@@ -148,84 +143,38 @@ O DevKit está organizado em três camadas principais:
148
143
  ## 3. Módulos Forenses
149
144
 
150
145
  ### Network
151
- | Módulo | Descrição |
146
+ | Função | Descrição |
152
147
  |--------|-----------|
153
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
154
- | `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
155
- | `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
156
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
157
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
148
+ | `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
149
+ | `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
150
+ | `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
151
+ | `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
152
+ | `smbscan` | Verifica serviços SMB ativos em um host . |
153
+ | `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
158
154
  | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
159
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
160
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
155
+ | `map` | Gera mapa visual de hosts e conexões detectadas. |
156
+ | `scan` | Identifica portas abertas e serviços ativos em hosts. |
161
157
  | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
162
158
 
163
159
  ### Browser
164
- | Módulo | Descrição |
160
+ | Função | Descrição |
165
161
  |--------|-----------|
166
162
  | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
167
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
168
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
169
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
170
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
171
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
163
+ | `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
164
+ | `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
165
+ | `history` | Coleta histórico de navegação de diferentes browsers. |
166
+ | `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
167
+ | `downloads` | Lista arquivos baixados pelos usuários. |
172
168
 
173
169
  ### Email
174
- | Módulo | Descrição |
170
+ | Função | Descrição |
175
171
  |--------|-----------|
176
172
  | `email_parser` | Extrai e organiza informações de emails. |
177
173
  | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
178
174
 
179
175
  ---
180
176
 
181
- ## 4. Aplicações de Apoio
182
-
183
- ### Dashboard
184
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
185
-
186
- **Funcionalidades:**
187
- - Menu lateral com módulos do DevKit.
188
- - Cards com resumo de análises recentes.
189
- - Acesso direto a visualizadores e Wizard.
190
-
191
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
192
-
193
- ### Visualizadores de Resultados
194
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
195
-
196
- **Exemplos:**
197
- - Mapas de rede interativos.
198
- - Timeline de eventos e logs.
199
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
200
-
201
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
202
-
203
- ### Assistente Interativo (Wizard)
204
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
205
-
206
- **Exemplo de fluxo:**
207
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
208
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
209
- 3. Execução automática dos módulos necessários
210
- 4. Geração de relatórios e acesso aos visualizadores
211
-
212
- **Tecnologias sugeridas:**
213
- - Terminal interativo (`questionary`, `PyInquirer`)
214
- - Web/Desktop (mesmo framework do Dashboard)
215
-
216
- ---
217
-
218
- ## 5. Fluxo de Integração
219
-
220
- 1. CLI executa módulos → gera resultados.
221
- 2. API possibilita integração programática com dashboards e outras aplicações.
222
- 3. Dashboard centraliza execução e resumo dos resultados.
223
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
224
- 5. Wizard guia o usuário em tarefas complexas.
225
-
226
- ---
227
-
228
- ## 6. Tecnologias Utilizadas
177
+ ## 4. Tecnologias Utilizadas
229
178
 
230
179
  - **Python** – Linguagem principal do projeto.
231
180
  - **FastAPI** – API para integração e execução de módulos.
@@ -234,7 +183,7 @@ O DevKit está organizado em três camadas principais:
234
183
 
235
184
  ---
236
185
 
237
- ## 7. Planejamento e Futuras Extensões
186
+ ## 5. Planejamento e Futuras Extensões
238
187
 
239
188
  | Aplicação / Módulo | Objetivo | Possíveis Extensões |
240
189
  |-------------------|----------|------------------|
@@ -246,33 +195,23 @@ O DevKit está organizado em três camadas principais:
246
195
 
247
196
  ---
248
197
 
249
- ## 8. Instalação
198
+ ## 6. Instalação
250
199
 
251
200
  ```bash
252
- # Clonar o repositório
253
- git clone https://github.com/ErickG123/devkit_forense.git
254
- cd devkit-forense
255
-
256
- # Criar ambiente virtual
257
- python -m venv venv
258
- source venv/bin/activate # Linux/macOS
259
- venv\Scripts\activate # Windows
260
-
261
- # Instalar dependências
262
- pip install -r requirements.txt
201
+ pip install forensic-cli
263
202
  ```
264
203
 
265
204
  ---
266
205
 
267
- ## 9. Exemplos de Execução
206
+ ## 7. Exemplos de Execução
268
207
 
269
208
  **CLI:**
270
209
  ```bash
271
210
  # Executar módulo de network scan
272
- python cli.py network_map --target 192.168.0.0/24
211
+ forensic-cli network map --network 192.168.0.0/24
273
212
 
274
213
  # Coletar histórico do Chrome
275
- python cli.py browser_history --browser chrome
214
+ forensic-cli browser history --chrome
276
215
  ```
277
216
 
278
217
  **API:**
@@ -280,11 +219,3 @@ python cli.py browser_history --browser chrome
280
219
  # Executar API
281
220
  uvicorn api.main:app --reload
282
221
  ```
283
-
284
- ---
285
-
286
- ## 10. Considerações Finais
287
-
288
- O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.
289
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
290
- O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.
@@ -0,0 +1,123 @@
1
+ # DevKit Forense – Ferramenta Educacional de Perícia Digital
2
+
3
+ ![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
4
+
5
+ ## Sumário
6
+ 1. [Introdução](#introdução)
7
+ 2. [Estrutura do Projeto](#estrutura-do-projeto)
8
+ 3. [Módulos Forenses](#módulos-forenses)
9
+ - [Network](#network)
10
+ - [Browser](#browser)
11
+ - [Email](#email)
12
+ 4. [Tecnologias Utilizadas](#tecnologias-utilizadas)
13
+ 5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
14
+ 6. [Instalação](#instalação)
15
+ 7. [Exemplos de Execução](#exemplos-de-execução)
16
+
17
+ ---
18
+
19
+ ## 1. Introdução
20
+
21
+ **Objetivo:**
22
+ O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.
23
+
24
+ **Escopo:**
25
+ - Execução de análises forenses em browsers, arquivos, emails e redes.
26
+ - Visualização interativa de resultados.
27
+ - Geração de relatórios automáticos.
28
+ - Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.
29
+
30
+ **Público-alvo:**
31
+ - Estudantes e professores de Segurança da Informação e Perícia Digital.
32
+
33
+ ---
34
+
35
+ ## 2. Estrutura do Projeto
36
+
37
+ O DevKit está organizado em três camadas principais:
38
+
39
+ 1. **CLI** – Executa os módulos forenses pelo terminal.
40
+ 2. **API** – Interface programática para execução de módulos e integração com dashboards.
41
+ 3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.
42
+
43
+ ---
44
+
45
+ ## 3. Módulos Forenses
46
+
47
+ ### Network
48
+ | Função | Descrição |
49
+ |--------|-----------|
50
+ | `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
51
+ | `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
52
+ | `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
53
+ | `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
54
+ | `smbscan` | Verifica serviços SMB ativos em um host . |
55
+ | `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
56
+ | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
57
+ | `map` | Gera mapa visual de hosts e conexões detectadas. |
58
+ | `scan` | Identifica portas abertas e serviços ativos em hosts. |
59
+ | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
60
+
61
+ ### Browser
62
+ | Função | Descrição |
63
+ |--------|-----------|
64
+ | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
65
+ | `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
66
+ | `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
67
+ | `history` | Coleta histórico de navegação de diferentes browsers. |
68
+ | `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
69
+ | `downloads` | Lista arquivos baixados pelos usuários. |
70
+
71
+ ### Email
72
+ | Função | Descrição |
73
+ |--------|-----------|
74
+ | `email_parser` | Extrai e organiza informações de emails. |
75
+ | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
76
+
77
+ ---
78
+
79
+ ## 4. Tecnologias Utilizadas
80
+
81
+ - **Python** – Linguagem principal do projeto.
82
+ - **FastAPI** – API para integração e execução de módulos.
83
+ - **Typer** – CLI estruturada e interativa.
84
+ - **SQLite** – Banco de dados local leve.
85
+
86
+ ---
87
+
88
+ ## 5. Planejamento e Futuras Extensões
89
+
90
+ | Aplicação / Módulo | Objetivo | Possíveis Extensões |
91
+ |-------------------|----------|------------------|
92
+ | Dashboard | Painel central para visualização e execução de módulos | Filtros avançados, alertas em tempo real, integração direta com relatórios |
93
+ | Visualizadores | Transformar dados da CLI em gráficos, mapas e tabelas | Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários |
94
+ | Wizard | Guiar o usuário passo a passo | Templates de análise rápida, integração automática com módulos de email e data, relatórios PDF/HTML |
95
+ | Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
96
+ | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
97
+
98
+ ---
99
+
100
+ ## 6. Instalação
101
+
102
+ ```bash
103
+ pip install forensic-cli
104
+ ```
105
+
106
+ ---
107
+
108
+ ## 7. Exemplos de Execução
109
+
110
+ **CLI:**
111
+ ```bash
112
+ # Executar módulo de network scan
113
+ forensic-cli network map --network 192.168.0.0/24
114
+
115
+ # Coletar histórico do Chrome
116
+ forensic-cli browser history --chrome
117
+ ```
118
+
119
+ **API:**
120
+ ```bash
121
+ # Executar API
122
+ uvicorn api.main:app --reload
123
+ ```
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "forensic-cli"
7
- version = "1.2.6"
7
+ version = "1.2.7"
8
8
  description = "DevKit Forense - CLI para análise de navegadores e rede"
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
@@ -104,3 +104,4 @@ forensic-cli = "cli.main:app"
104
104
  [project.urls]
105
105
  Changelog = "https://erickg123.github.io/devkit_forense/"
106
106
  Source = "https://github.com/ErickG123/devkit_forense"
107
+ Issues = "https://github.com/ErickG123/devkit_forense/issues"
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
2
2
 
3
3
  setup(
4
4
  name="forensic_cli",
5
- version="1.2.6",
5
+ version="1.2.7",
6
6
  author="Erick Gabriel dos Santos Alves",
7
7
  author_email="erickgabrielalves0@gmail.com",
8
8
  description="Toolkit modular para análise de evidências digitais",
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: forensic-cli
3
- Version: 1.2.6
3
+ Version: 1.2.7
4
4
  Summary: DevKit Forense - CLI para análise de navegadores e rede
5
5
  Home-page: https://github.com/ErickG123/devkit_forense
6
6
  Author: Erick Gabriel dos Santos Alves
@@ -8,6 +8,7 @@ Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
8
8
  License: MIT
9
9
  Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
10
10
  Project-URL: Source, https://github.com/ErickG123/devkit_forense
11
+ Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
11
12
  Keywords: forensics,cli,network,browser
12
13
  Requires-Python: >=3.11
13
14
  Description-Content-Type: text/markdown
@@ -106,16 +107,10 @@ Dynamic: requires-python
106
107
  - [Network](#network)
107
108
  - [Browser](#browser)
108
109
  - [Email](#email)
109
- 4. [Aplicações de Apoio](#aplicações-de-apoio)
110
- - [Dashboard](#dashboard)
111
- - [Visualizadores de Resultados](#visualizadores-de-resultados)
112
- - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)
113
- 5. [Fluxo de Integração](#fluxo-de-integração)
114
- 6. [Tecnologias Utilizadas](#tecnologias-utilizadas)
115
- 7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
116
- 8. [Instalação](#instalação)
117
- 9. [Exemplos de Execução](#exemplos-de-execução)
118
- 10. [Considerações Finais](#considerações-finais)
110
+ 4. [Tecnologias Utilizadas](#tecnologias-utilizadas)
111
+ 5. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
112
+ 6. [Instalação](#instalação)
113
+ 7. [Exemplos de Execução](#exemplos-de-execução)
119
114
 
120
115
  ---
121
116
 
@@ -148,84 +143,38 @@ O DevKit está organizado em três camadas principais:
148
143
  ## 3. Módulos Forenses
149
144
 
150
145
  ### Network
151
- | Módulo | Descrição |
146
+ | Função | Descrição |
152
147
  |--------|-----------|
153
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
154
- | `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
155
- | `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
156
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
157
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
148
+ | `ipinfo` | Consulta informações detalhadas sobre um endereço IP. |
149
+ | `arpscan` | Varre a rede para identificar dispositivos conectados via ARP. |
150
+ | `dnscan` | Realiza levantamento de informações de DNS de domínios e hosts. |
151
+ | `snmpscan` | Realiza varredura SNMP em dispositivos de rede. |
152
+ | `smbscan` | Verifica serviços SMB ativos em um host . |
153
+ | `sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
158
154
  | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
159
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
160
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
155
+ | `map` | Gera mapa visual de hosts e conexões detectadas. |
156
+ | `scan` | Identifica portas abertas e serviços ativos em hosts. |
161
157
  | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
162
158
 
163
159
  ### Browser
164
- | Módulo | Descrição |
160
+ | Função | Descrição |
165
161
  |--------|-----------|
166
162
  | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
167
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
168
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
169
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
170
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
171
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
163
+ | `favscreen` | Captura e organiza screenshots de sites favoritos ou acessados. |
164
+ | `words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
165
+ | `history` | Coleta histórico de navegação de diferentes browsers. |
166
+ | `patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
167
+ | `downloads` | Lista arquivos baixados pelos usuários. |
172
168
 
173
169
  ### Email
174
- | Módulo | Descrição |
170
+ | Função | Descrição |
175
171
  |--------|-----------|
176
172
  | `email_parser` | Extrai e organiza informações de emails. |
177
173
  | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
178
174
 
179
175
  ---
180
176
 
181
- ## 4. Aplicações de Apoio
182
-
183
- ### Dashboard
184
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
185
-
186
- **Funcionalidades:**
187
- - Menu lateral com módulos do DevKit.
188
- - Cards com resumo de análises recentes.
189
- - Acesso direto a visualizadores e Wizard.
190
-
191
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
192
-
193
- ### Visualizadores de Resultados
194
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
195
-
196
- **Exemplos:**
197
- - Mapas de rede interativos.
198
- - Timeline de eventos e logs.
199
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
200
-
201
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
202
-
203
- ### Assistente Interativo (Wizard)
204
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
205
-
206
- **Exemplo de fluxo:**
207
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
208
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
209
- 3. Execução automática dos módulos necessários
210
- 4. Geração de relatórios e acesso aos visualizadores
211
-
212
- **Tecnologias sugeridas:**
213
- - Terminal interativo (`questionary`, `PyInquirer`)
214
- - Web/Desktop (mesmo framework do Dashboard)
215
-
216
- ---
217
-
218
- ## 5. Fluxo de Integração
219
-
220
- 1. CLI executa módulos → gera resultados.
221
- 2. API possibilita integração programática com dashboards e outras aplicações.
222
- 3. Dashboard centraliza execução e resumo dos resultados.
223
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
224
- 5. Wizard guia o usuário em tarefas complexas.
225
-
226
- ---
227
-
228
- ## 6. Tecnologias Utilizadas
177
+ ## 4. Tecnologias Utilizadas
229
178
 
230
179
  - **Python** – Linguagem principal do projeto.
231
180
  - **FastAPI** – API para integração e execução de módulos.
@@ -234,7 +183,7 @@ O DevKit está organizado em três camadas principais:
234
183
 
235
184
  ---
236
185
 
237
- ## 7. Planejamento e Futuras Extensões
186
+ ## 5. Planejamento e Futuras Extensões
238
187
 
239
188
  | Aplicação / Módulo | Objetivo | Possíveis Extensões |
240
189
  |-------------------|----------|------------------|
@@ -246,33 +195,23 @@ O DevKit está organizado em três camadas principais:
246
195
 
247
196
  ---
248
197
 
249
- ## 8. Instalação
198
+ ## 6. Instalação
250
199
 
251
200
  ```bash
252
- # Clonar o repositório
253
- git clone https://github.com/ErickG123/devkit_forense.git
254
- cd devkit-forense
255
-
256
- # Criar ambiente virtual
257
- python -m venv venv
258
- source venv/bin/activate # Linux/macOS
259
- venv\Scripts\activate # Windows
260
-
261
- # Instalar dependências
262
- pip install -r requirements.txt
201
+ pip install forensic-cli
263
202
  ```
264
203
 
265
204
  ---
266
205
 
267
- ## 9. Exemplos de Execução
206
+ ## 7. Exemplos de Execução
268
207
 
269
208
  **CLI:**
270
209
  ```bash
271
210
  # Executar módulo de network scan
272
- python cli.py network_map --target 192.168.0.0/24
211
+ forensic-cli network map --network 192.168.0.0/24
273
212
 
274
213
  # Coletar histórico do Chrome
275
- python cli.py browser_history --browser chrome
214
+ forensic-cli browser history --chrome
276
215
  ```
277
216
 
278
217
  **API:**
@@ -280,11 +219,3 @@ python cli.py browser_history --browser chrome
280
219
  # Executar API
281
220
  uvicorn api.main:app --reload
282
221
  ```
283
-
284
- ---
285
-
286
- ## 10. Considerações Finais
287
-
288
- O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.
289
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
290
- O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.
@@ -1,193 +0,0 @@
1
- # DevKit Forense – Ferramenta Educacional de Perícia Digital
2
-
3
- ![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
4
-
5
- ## Sumário
6
- 1. [Introdução](#introdução)
7
- 2. [Estrutura do Projeto](#estrutura-do-projeto)
8
- 3. [Módulos Forenses](#módulos-forenses)
9
- - [Network](#network)
10
- - [Browser](#browser)
11
- - [Email](#email)
12
- 4. [Aplicações de Apoio](#aplicações-de-apoio)
13
- - [Dashboard](#dashboard)
14
- - [Visualizadores de Resultados](#visualizadores-de-resultados)
15
- - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)
16
- 5. [Fluxo de Integração](#fluxo-de-integração)
17
- 6. [Tecnologias Utilizadas](#tecnologias-utilizadas)
18
- 7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
19
- 8. [Instalação](#instalação)
20
- 9. [Exemplos de Execução](#exemplos-de-execução)
21
- 10. [Considerações Finais](#considerações-finais)
22
-
23
- ---
24
-
25
- ## 1. Introdução
26
-
27
- **Objetivo:**
28
- O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.
29
-
30
- **Escopo:**
31
- - Execução de análises forenses em browsers, arquivos, emails e redes.
32
- - Visualização interativa de resultados.
33
- - Geração de relatórios automáticos.
34
- - Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.
35
-
36
- **Público-alvo:**
37
- - Estudantes e professores de Segurança da Informação e Perícia Digital.
38
-
39
- ---
40
-
41
- ## 2. Estrutura do Projeto
42
-
43
- O DevKit está organizado em três camadas principais:
44
-
45
- 1. **CLI** – Executa os módulos forenses pelo terminal.
46
- 2. **API** – Interface programática para execução de módulos e integração com dashboards.
47
- 3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.
48
-
49
- ---
50
-
51
- ## 3. Módulos Forenses
52
-
53
- ### Network
54
- | Módulo | Descrição |
55
- |--------|-----------|
56
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
57
- | `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
58
- | `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
59
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
60
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
61
- | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
62
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
63
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
64
- | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
65
-
66
- ### Browser
67
- | Módulo | Descrição |
68
- |--------|-----------|
69
- | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
70
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
71
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
72
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
73
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
74
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
75
-
76
- ### Email
77
- | Módulo | Descrição |
78
- |--------|-----------|
79
- | `email_parser` | Extrai e organiza informações de emails. |
80
- | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
81
-
82
- ---
83
-
84
- ## 4. Aplicações de Apoio
85
-
86
- ### Dashboard
87
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
88
-
89
- **Funcionalidades:**
90
- - Menu lateral com módulos do DevKit.
91
- - Cards com resumo de análises recentes.
92
- - Acesso direto a visualizadores e Wizard.
93
-
94
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
95
-
96
- ### Visualizadores de Resultados
97
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
98
-
99
- **Exemplos:**
100
- - Mapas de rede interativos.
101
- - Timeline de eventos e logs.
102
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
103
-
104
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
105
-
106
- ### Assistente Interativo (Wizard)
107
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
108
-
109
- **Exemplo de fluxo:**
110
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
111
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
112
- 3. Execução automática dos módulos necessários
113
- 4. Geração de relatórios e acesso aos visualizadores
114
-
115
- **Tecnologias sugeridas:**
116
- - Terminal interativo (`questionary`, `PyInquirer`)
117
- - Web/Desktop (mesmo framework do Dashboard)
118
-
119
- ---
120
-
121
- ## 5. Fluxo de Integração
122
-
123
- 1. CLI executa módulos → gera resultados.
124
- 2. API possibilita integração programática com dashboards e outras aplicações.
125
- 3. Dashboard centraliza execução e resumo dos resultados.
126
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
127
- 5. Wizard guia o usuário em tarefas complexas.
128
-
129
- ---
130
-
131
- ## 6. Tecnologias Utilizadas
132
-
133
- - **Python** – Linguagem principal do projeto.
134
- - **FastAPI** – API para integração e execução de módulos.
135
- - **Typer** – CLI estruturada e interativa.
136
- - **SQLite** – Banco de dados local leve.
137
-
138
- ---
139
-
140
- ## 7. Planejamento e Futuras Extensões
141
-
142
- | Aplicação / Módulo | Objetivo | Possíveis Extensões |
143
- |-------------------|----------|------------------|
144
- | Dashboard | Painel central para visualização e execução de módulos | Filtros avançados, alertas em tempo real, integração direta com relatórios |
145
- | Visualizadores | Transformar dados da CLI em gráficos, mapas e tabelas | Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários |
146
- | Wizard | Guiar o usuário passo a passo | Templates de análise rápida, integração automática com módulos de email e data, relatórios PDF/HTML |
147
- | Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
148
- | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
149
-
150
- ---
151
-
152
- ## 8. Instalação
153
-
154
- ```bash
155
- # Clonar o repositório
156
- git clone https://github.com/ErickG123/devkit_forense.git
157
- cd devkit-forense
158
-
159
- # Criar ambiente virtual
160
- python -m venv venv
161
- source venv/bin/activate # Linux/macOS
162
- venv\Scripts\activate # Windows
163
-
164
- # Instalar dependências
165
- pip install -r requirements.txt
166
- ```
167
-
168
- ---
169
-
170
- ## 9. Exemplos de Execução
171
-
172
- **CLI:**
173
- ```bash
174
- # Executar módulo de network scan
175
- python cli.py network_map --target 192.168.0.0/24
176
-
177
- # Coletar histórico do Chrome
178
- python cli.py browser_history --browser chrome
179
- ```
180
-
181
- **API:**
182
- ```bash
183
- # Executar API
184
- uvicorn api.main:app --reload
185
- ```
186
-
187
- ---
188
-
189
- ## 10. Considerações Finais
190
-
191
- O DevKit Forense combina **educação e prática**, permitindo que usuários explorem análise forense digital de forma segura, didática e interativa.
192
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
193
- O planejamento de novos módulos e ferramentas garante evolução contínua da plataforma, mantendo-a atualizada e relevante para atividades acadêmicas e laboratoriais.
File without changes
File without changes
File without changes