forensic-cli 1.2.5__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.5/src/forensic_cli.egg-info → forensic_cli-1.2.7}/PKG-INFO +32 -104
  2. forensic_cli-1.2.7/README.md +123 -0
  3. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/pyproject.toml +3 -3
  4. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/setup.py +1 -1
  5. {forensic_cli-1.2.5 → forensic_cli-1.2.7/src/forensic_cli.egg-info}/PKG-INFO +32 -104
  6. forensic_cli-1.2.5/README.md +0 -195
  7. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/LICENSE +0 -0
  8. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/LICENSE-GPL +0 -0
  9. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/setup.cfg +0 -0
  10. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/__init__.py +0 -0
  11. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/__init__.py +0 -0
  12. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/browser.py +0 -0
  13. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/describe.py +0 -0
  14. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/email.py +0 -0
  15. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/network.py +0 -0
  16. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/commands/utils.py +0 -0
  17. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/cli/main.py +0 -0
  18. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/__init__.py +0 -0
  19. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/browser_history.py +0 -0
  20. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/common_words.py +0 -0
  21. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/downloads_history.py +0 -0
  22. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/fav_screen.py +0 -0
  23. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/logins.py +0 -0
  24. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/browser/unusual_patterns.py +0 -0
  25. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/data/__init__.py +0 -0
  26. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/data/data_recovery.py +0 -0
  27. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/db/db.py +0 -0
  28. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/email/email_parser.py +0 -0
  29. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/email/header_analysis.py +0 -0
  30. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/models/orm.py +0 -0
  31. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/models/schemas.py +0 -0
  32. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/__init__.py +0 -0
  33. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/arp_scan.py +0 -0
  34. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/dns_recon.py +0 -0
  35. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/fingerprinting.py +0 -0
  36. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/ip_info.py +0 -0
  37. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/network_map.py +0 -0
  38. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/ping_sweep.py +0 -0
  39. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/port_scanner.py +0 -0
  40. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/smb_scan.py +0 -0
  41. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/snmp_scan.py +0 -0
  42. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/traceroute.py +0 -0
  43. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/network/utils.py +0 -0
  44. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/registry.py +0 -0
  45. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/utils/__init__.py +0 -0
  46. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/core/utils/gerar_amostras.py +0 -0
  47. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/SOURCES.txt +0 -0
  48. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/dependency_links.txt +0 -0
  49. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/entry_points.txt +0 -0
  50. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/requires.txt +0 -0
  51. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/src/forensic_cli.egg-info/top_level.txt +0 -0
  52. {forensic_cli-1.2.5 → forensic_cli-1.2.7}/tests/test_file_inspector.py +0 -0
@@ -1,14 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: forensic-cli
3
- Version: 1.2.5
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
7
7
  Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
8
8
  License: MIT
9
- Project-URL: Documentation, https://erickg123.github.io/devkit_forense/docs
10
- Project-URL: Changelog, https://erickg123.github.io/devkit_forense/changelog
9
+ Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
11
10
  Project-URL: Source, https://github.com/ErickG123/devkit_forense
11
+ Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
12
12
  Keywords: forensics,cli,network,browser
13
13
  Requires-Python: >=3.11
14
14
  Description-Content-Type: text/markdown
@@ -107,16 +107,10 @@ Dynamic: requires-python
107
107
  - [Network](#network)
108
108
  - [Browser](#browser)
109
109
  - [Email](#email)
110
- 4. [Aplicações de Apoio](#aplicações-de-apoio)
111
- - [Dashboard](#dashboard)
112
- - [Visualizadores de Resultados](#visualizadores-de-resultados)
113
- - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)
114
- 5. [Fluxo de Integração](#fluxo-de-integração)
115
- 6. [Tecnologias Utilizadas](#tecnologias-utilizadas)
116
- 7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
117
- 8. [Instalação](#instalação)
118
- 9. [Exemplos de Execução](#exemplos-de-execução)
119
- 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)
120
114
 
121
115
  ---
122
116
 
@@ -149,86 +143,38 @@ O DevKit está organizado em três camadas principais:
149
143
  ## 3. Módulos Forenses
150
144
 
151
145
  ### Network
152
- | Módulo | Descrição |
146
+ | Função | Descrição |
153
147
  |--------|-----------|
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
- | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
157
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
158
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
159
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
160
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
161
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
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. |
162
154
  | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
155
+ | `map` | Gera mapa visual de hosts e conexões detectadas. |
156
+ | `scan` | Identifica portas abertas e serviços ativos em hosts. |
157
+ | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
163
158
 
164
159
  ### Browser
165
- | Módulo | Descrição |
160
+ | Função | Descrição |
166
161
  |--------|-----------|
167
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
168
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
169
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
170
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
171
- | `full_browser_history` | Consolida todo histórico de navegação em um único relatório. |
172
- | `logins_chrome` | Extração de credenciais armazenadas no Chrome. |
173
- | `logins_edge` | Extração de credenciais armazenadas no Edge. |
174
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
162
+ | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
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. |
175
168
 
176
169
  ### Email
177
- | Módulo | Descrição |
170
+ | Função | Descrição |
178
171
  |--------|-----------|
179
172
  | `email_parser` | Extrai e organiza informações de emails. |
180
173
  | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
181
174
 
182
175
  ---
183
176
 
184
- ## 4. Aplicações de Apoio
185
-
186
- ### Dashboard
187
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
188
-
189
- **Funcionalidades:**
190
- - Menu lateral com módulos do DevKit.
191
- - Cards com resumo de análises recentes.
192
- - Acesso direto a visualizadores e Wizard.
193
-
194
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
195
-
196
- ### Visualizadores de Resultados
197
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
198
-
199
- **Exemplos:**
200
- - Mapas de rede interativos.
201
- - Timeline de eventos e logs.
202
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
203
-
204
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
205
-
206
- ### Assistente Interativo (Wizard)
207
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
208
-
209
- **Exemplo de fluxo:**
210
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
211
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
212
- 3. Execução automática dos módulos necessários
213
- 4. Geração de relatórios e acesso aos visualizadores
214
-
215
- **Tecnologias sugeridas:**
216
- - Terminal interativo (`questionary`, `PyInquirer`)
217
- - Web/Desktop (mesmo framework do Dashboard)
218
-
219
- ---
220
-
221
- ## 5. Fluxo de Integração
222
-
223
- 1. CLI executa módulos → gera resultados.
224
- 2. API possibilita integração programática com dashboards e outras aplicações.
225
- 3. Dashboard centraliza execução e resumo dos resultados.
226
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
227
- 5. Wizard guia o usuário em tarefas complexas.
228
-
229
- ---
230
-
231
- ## 6. Tecnologias Utilizadas
177
+ ## 4. Tecnologias Utilizadas
232
178
 
233
179
  - **Python** – Linguagem principal do projeto.
234
180
  - **FastAPI** – API para integração e execução de módulos.
@@ -237,7 +183,7 @@ O DevKit está organizado em três camadas principais:
237
183
 
238
184
  ---
239
185
 
240
- ## 7. Planejamento e Futuras Extensões
186
+ ## 5. Planejamento e Futuras Extensões
241
187
 
242
188
  | Aplicação / Módulo | Objetivo | Possíveis Extensões |
243
189
  |-------------------|----------|------------------|
@@ -249,33 +195,23 @@ O DevKit está organizado em três camadas principais:
249
195
 
250
196
  ---
251
197
 
252
- ## 8. Instalação
198
+ ## 6. Instalação
253
199
 
254
200
  ```bash
255
- # Clonar o repositório
256
- git clone https://github.com/ErickG123/devkit_forense.git
257
- cd devkit-forense
258
-
259
- # Criar ambiente virtual
260
- python -m venv venv
261
- source venv/bin/activate # Linux/macOS
262
- venv\Scripts\activate # Windows
263
-
264
- # Instalar dependências
265
- pip install -r requirements.txt
201
+ pip install forensic-cli
266
202
  ```
267
203
 
268
204
  ---
269
205
 
270
- ## 9. Exemplos de Execução
206
+ ## 7. Exemplos de Execução
271
207
 
272
208
  **CLI:**
273
209
  ```bash
274
210
  # Executar módulo de network scan
275
- python cli.py network_map --target 192.168.0.0/24
211
+ forensic-cli network map --network 192.168.0.0/24
276
212
 
277
213
  # Coletar histórico do Chrome
278
- python cli.py browser_history --browser chrome
214
+ forensic-cli browser history --chrome
279
215
  ```
280
216
 
281
217
  **API:**
@@ -283,11 +219,3 @@ python cli.py browser_history --browser chrome
283
219
  # Executar API
284
220
  uvicorn api.main:app --reload
285
221
  ```
286
-
287
- ---
288
-
289
- ## 10. Considerações Finais
290
-
291
- 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.
292
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
293
- 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.5"
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"}
@@ -102,6 +102,6 @@ include = ["cli*", "core*"]
102
102
  forensic-cli = "cli.main:app"
103
103
 
104
104
  [project.urls]
105
- Documentation = "https://erickg123.github.io/devkit_forense/docs"
106
- Changelog = "https://erickg123.github.io/devkit_forense/changelog"
105
+ Changelog = "https://erickg123.github.io/devkit_forense/"
107
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.5",
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,14 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: forensic-cli
3
- Version: 1.2.5
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
7
7
  Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
8
8
  License: MIT
9
- Project-URL: Documentation, https://erickg123.github.io/devkit_forense/docs
10
- Project-URL: Changelog, https://erickg123.github.io/devkit_forense/changelog
9
+ Project-URL: Changelog, https://erickg123.github.io/devkit_forense/
11
10
  Project-URL: Source, https://github.com/ErickG123/devkit_forense
11
+ Project-URL: Issues, https://github.com/ErickG123/devkit_forense/issues
12
12
  Keywords: forensics,cli,network,browser
13
13
  Requires-Python: >=3.11
14
14
  Description-Content-Type: text/markdown
@@ -107,16 +107,10 @@ Dynamic: requires-python
107
107
  - [Network](#network)
108
108
  - [Browser](#browser)
109
109
  - [Email](#email)
110
- 4. [Aplicações de Apoio](#aplicações-de-apoio)
111
- - [Dashboard](#dashboard)
112
- - [Visualizadores de Resultados](#visualizadores-de-resultados)
113
- - [Assistente Interativo (Wizard)](#assistente-interativo-wizard)
114
- 5. [Fluxo de Integração](#fluxo-de-integração)
115
- 6. [Tecnologias Utilizadas](#tecnologias-utilizadas)
116
- 7. [Planejamento e Futuras Extensões](#planejamento-e-futuras-extensões)
117
- 8. [Instalação](#instalação)
118
- 9. [Exemplos de Execução](#exemplos-de-execução)
119
- 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)
120
114
 
121
115
  ---
122
116
 
@@ -149,86 +143,38 @@ O DevKit está organizado em três camadas principais:
149
143
  ## 3. Módulos Forenses
150
144
 
151
145
  ### Network
152
- | Módulo | Descrição |
146
+ | Função | Descrição |
153
147
  |--------|-----------|
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
- | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
157
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
158
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
159
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
160
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
161
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
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. |
162
154
  | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
155
+ | `map` | Gera mapa visual de hosts e conexões detectadas. |
156
+ | `scan` | Identifica portas abertas e serviços ativos em hosts. |
157
+ | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
163
158
 
164
159
  ### Browser
165
- | Módulo | Descrição |
160
+ | Função | Descrição |
166
161
  |--------|-----------|
167
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
168
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
169
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
170
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
171
- | `full_browser_history` | Consolida todo histórico de navegação em um único relatório. |
172
- | `logins_chrome` | Extração de credenciais armazenadas no Chrome. |
173
- | `logins_edge` | Extração de credenciais armazenadas no Edge. |
174
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
162
+ | `logins` | Extração de credenciais armazenadas no Chrome e Edge. |
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. |
175
168
 
176
169
  ### Email
177
- | Módulo | Descrição |
170
+ | Função | Descrição |
178
171
  |--------|-----------|
179
172
  | `email_parser` | Extrai e organiza informações de emails. |
180
173
  | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
181
174
 
182
175
  ---
183
176
 
184
- ## 4. Aplicações de Apoio
185
-
186
- ### Dashboard
187
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
188
-
189
- **Funcionalidades:**
190
- - Menu lateral com módulos do DevKit.
191
- - Cards com resumo de análises recentes.
192
- - Acesso direto a visualizadores e Wizard.
193
-
194
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
195
-
196
- ### Visualizadores de Resultados
197
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
198
-
199
- **Exemplos:**
200
- - Mapas de rede interativos.
201
- - Timeline de eventos e logs.
202
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
203
-
204
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
205
-
206
- ### Assistente Interativo (Wizard)
207
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
208
-
209
- **Exemplo de fluxo:**
210
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
211
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
212
- 3. Execução automática dos módulos necessários
213
- 4. Geração de relatórios e acesso aos visualizadores
214
-
215
- **Tecnologias sugeridas:**
216
- - Terminal interativo (`questionary`, `PyInquirer`)
217
- - Web/Desktop (mesmo framework do Dashboard)
218
-
219
- ---
220
-
221
- ## 5. Fluxo de Integração
222
-
223
- 1. CLI executa módulos → gera resultados.
224
- 2. API possibilita integração programática com dashboards e outras aplicações.
225
- 3. Dashboard centraliza execução e resumo dos resultados.
226
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
227
- 5. Wizard guia o usuário em tarefas complexas.
228
-
229
- ---
230
-
231
- ## 6. Tecnologias Utilizadas
177
+ ## 4. Tecnologias Utilizadas
232
178
 
233
179
  - **Python** – Linguagem principal do projeto.
234
180
  - **FastAPI** – API para integração e execução de módulos.
@@ -237,7 +183,7 @@ O DevKit está organizado em três camadas principais:
237
183
 
238
184
  ---
239
185
 
240
- ## 7. Planejamento e Futuras Extensões
186
+ ## 5. Planejamento e Futuras Extensões
241
187
 
242
188
  | Aplicação / Módulo | Objetivo | Possíveis Extensões |
243
189
  |-------------------|----------|------------------|
@@ -249,33 +195,23 @@ O DevKit está organizado em três camadas principais:
249
195
 
250
196
  ---
251
197
 
252
- ## 8. Instalação
198
+ ## 6. Instalação
253
199
 
254
200
  ```bash
255
- # Clonar o repositório
256
- git clone https://github.com/ErickG123/devkit_forense.git
257
- cd devkit-forense
258
-
259
- # Criar ambiente virtual
260
- python -m venv venv
261
- source venv/bin/activate # Linux/macOS
262
- venv\Scripts\activate # Windows
263
-
264
- # Instalar dependências
265
- pip install -r requirements.txt
201
+ pip install forensic-cli
266
202
  ```
267
203
 
268
204
  ---
269
205
 
270
- ## 9. Exemplos de Execução
206
+ ## 7. Exemplos de Execução
271
207
 
272
208
  **CLI:**
273
209
  ```bash
274
210
  # Executar módulo de network scan
275
- python cli.py network_map --target 192.168.0.0/24
211
+ forensic-cli network map --network 192.168.0.0/24
276
212
 
277
213
  # Coletar histórico do Chrome
278
- python cli.py browser_history --browser chrome
214
+ forensic-cli browser history --chrome
279
215
  ```
280
216
 
281
217
  **API:**
@@ -283,11 +219,3 @@ python cli.py browser_history --browser chrome
283
219
  # Executar API
284
220
  uvicorn api.main:app --reload
285
221
  ```
286
-
287
- ---
288
-
289
- ## 10. Considerações Finais
290
-
291
- 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.
292
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
293
- 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,195 +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
- | `arp_scan` | Varre a rede para identificar dispositivos conectados via ARP. |
57
- | `dns_recon` | Realiza levantamento de informações de DNS de domínios e hosts. |
58
- | `fingerprinting` | Identifica sistemas, serviços e versões na rede. |
59
- | `ip_info` | Consulta informações detalhadas sobre um endereço IP. |
60
- | `network_map` | Gera mapa visual de hosts e conexões detectadas. |
61
- | `ping_sweep` | Verifica quais hosts estão ativos em uma faixa de IP. |
62
- | `port_scanner` | Identifica portas abertas e serviços ativos em hosts. |
63
- | `snmp_scan` | Realiza varredura SNMP em dispositivos de rede. |
64
- | `traceroute` | Traça o caminho percorrido por pacotes até um host alvo. |
65
-
66
- ### Browser
67
- | Módulo | Descrição |
68
- |--------|-----------|
69
- | `browser_history` | Coleta histórico de navegação de diferentes browsers. |
70
- | `common_words` | Identifica palavras mais comuns em histórico de navegação e downloads. |
71
- | `downloads_history` | Lista arquivos baixados pelos usuários. |
72
- | `fav_screen` | Captura e organiza screenshots de sites favoritos ou acessados. |
73
- | `full_browser_history` | Consolida todo histórico de navegação em um único relatório. |
74
- | `logins_chrome` | Extração de credenciais armazenadas no Chrome. |
75
- | `logins_edge` | Extração de credenciais armazenadas no Edge. |
76
- | `unusual_patterns` | Identifica padrões suspeitos em histórico de navegação ou downloads. |
77
-
78
- ### Email
79
- | Módulo | Descrição |
80
- |--------|-----------|
81
- | `email_parser` | Extrai e organiza informações de emails. |
82
- | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
83
-
84
- ---
85
-
86
- ## 4. Aplicações de Apoio
87
-
88
- ### Dashboard
89
- **Objetivo:** Centralizar informações e permitir execução rápida de módulos.
90
-
91
- **Funcionalidades:**
92
- - Menu lateral com módulos do DevKit.
93
- - Cards com resumo de análises recentes.
94
- - Acesso direto a visualizadores e Wizard.
95
-
96
- **Tecnologias sugeridas:** Streamlit (web), PyQt (desktop).
97
-
98
- ### Visualizadores de Resultados
99
- **Objetivo:** Transformar saídas da CLI em gráficos e tabelas interativas.
100
-
101
- **Exemplos:**
102
- - Mapas de rede interativos.
103
- - Timeline de eventos e logs.
104
- - Gráficos de arquivos analisados, tipos e padrões suspeitos.
105
-
106
- **Integração:** Recebe dados da CLI em formato JSON ou CSV.
107
-
108
- ### Assistente Interativo (Wizard)
109
- **Objetivo:** Guiar o usuário passo a passo em tarefas complexas.
110
-
111
- **Exemplo de fluxo:**
112
- 1. Seleção do tipo de análise (pendrive, rede, logs, etc.)
113
- 2. Configuração de opções (scan de malware, intervalo de IP, dispositivo alvo)
114
- 3. Execução automática dos módulos necessários
115
- 4. Geração de relatórios e acesso aos visualizadores
116
-
117
- **Tecnologias sugeridas:**
118
- - Terminal interativo (`questionary`, `PyInquirer`)
119
- - Web/Desktop (mesmo framework do Dashboard)
120
-
121
- ---
122
-
123
- ## 5. Fluxo de Integração
124
-
125
- 1. CLI executa módulos → gera resultados.
126
- 2. API possibilita integração programática com dashboards e outras aplicações.
127
- 3. Dashboard centraliza execução e resumo dos resultados.
128
- 4. Visualizadores transformam dados em gráficos e tabelas interativas.
129
- 5. Wizard guia o usuário em tarefas complexas.
130
-
131
- ---
132
-
133
- ## 6. Tecnologias Utilizadas
134
-
135
- - **Python** – Linguagem principal do projeto.
136
- - **FastAPI** – API para integração e execução de módulos.
137
- - **Typer** – CLI estruturada e interativa.
138
- - **SQLite** – Banco de dados local leve.
139
-
140
- ---
141
-
142
- ## 7. Planejamento e Futuras Extensões
143
-
144
- | Aplicação / Módulo | Objetivo | Possíveis Extensões |
145
- |-------------------|----------|------------------|
146
- | 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 |
147
- | Visualizadores | Transformar dados da CLI em gráficos, mapas e tabelas | Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários |
148
- | 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 |
149
- | 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 |
150
- | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
151
-
152
- ---
153
-
154
- ## 8. Instalação
155
-
156
- ```bash
157
- # Clonar o repositório
158
- git clone https://github.com/ErickG123/devkit_forense.git
159
- cd devkit-forense
160
-
161
- # Criar ambiente virtual
162
- python -m venv venv
163
- source venv/bin/activate # Linux/macOS
164
- venv\Scripts\activate # Windows
165
-
166
- # Instalar dependências
167
- pip install -r requirements.txt
168
- ```
169
-
170
- ---
171
-
172
- ## 9. Exemplos de Execução
173
-
174
- **CLI:**
175
- ```bash
176
- # Executar módulo de network scan
177
- python cli.py network_map --target 192.168.0.0/24
178
-
179
- # Coletar histórico do Chrome
180
- python cli.py browser_history --browser chrome
181
- ```
182
-
183
- **API:**
184
- ```bash
185
- # Executar API
186
- uvicorn api.main:app --reload
187
- ```
188
-
189
- ---
190
-
191
- ## 10. Considerações Finais
192
-
193
- 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.
194
- As aplicações de apoio aumentam a acessibilidade e engajamento, tornando o estudo da perícia digital mais visual e intuitivo.
195
- 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