mirror of
https://github.com/infinition/Bjorn.git
synced 2025-12-08 05:34:58 +00:00
Merge pull request #2 from JuanVilla424/main
style(core): infinition changes over style and prerequisites
This commit is contained in:
Na0nh
2
.github/FUNDING.yml
vendored
2
.github/FUNDING.yml
vendored
@@ -10,6 +10,6 @@
|
||||
#issuehunt: # Replace with a single IssueHunt username
|
||||
#lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
|
||||
#polar: # Replace with a single Polar username
|
||||
#buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
|
||||
buy_me_a_coffee: infinition
|
||||
#thanks_dev: # Replace with a single thanks.dev username
|
||||
#custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
|
||||
|
||||
@@ -23,7 +23,7 @@ We are committed to fostering an open and welcoming environment for all contribu
|
||||
|
||||
## 📢 Reporting Misconduct
|
||||
|
||||
If you encounter any behavior that violates this code of conduct, please report it by contacting [bjorn-cyberviking@outlook.com](bjorn-cyberviking@outlook.com). All complaints will be reviewed and handled appropriately.
|
||||
If you encounter any behavior that violates this code of conduct, please report it by contacting [bjorn-cyberviking@outlook.com](mailto:bjorn-cyberviking@outlook.com). All complaints will be reviewed and handled appropriately.
|
||||
|
||||
## ⚖️ Enforcement
|
||||
|
||||
|
||||
23
INSTALL.md
23
INSTALL.md
@@ -14,9 +14,8 @@
|
||||
Use Raspberry Pi Imager to install your OS
|
||||
https://www.raspberrypi.com/software/
|
||||
|
||||
### 📌 Prerequisites
|
||||
|
||||
|
||||
### 📌 Prerequisites for RPI zero W (32bits)
|
||||
|
||||
|
||||
- Raspberry Pi OS installed.
|
||||
- Stable:
|
||||
@@ -26,7 +25,23 @@ https://www.raspberrypi.com/software/
|
||||
- Username and hostname set to `bjorn`.
|
||||
- 2.13-inch e-Paper HAT connected to GPIO pins.
|
||||
|
||||
At the moment the paper screen v2 & v4 have been tested and implemented.
|
||||
### 📌 Prerequisites for RPI zero W2 (64bits)
|
||||
|
||||
|
||||
|
||||
I did not develop Bjorn for the raspberry pi zero w2 64bits, but several feedbacks have attested that the installation worked perfectly.
|
||||
|
||||
- Raspberry Pi OS installed.
|
||||
- Stable:
|
||||
- System: 64-bit
|
||||
- Kernel version: 6.6
|
||||
- Debian version: 12 (bookworm) '2024-10-22-raspios-bookworm-arm64-lite'
|
||||
- Username and hostname set to `bjorn`.
|
||||
- 2.13-inch e-Paper HAT connected to GPIO pins.
|
||||
|
||||
|
||||
|
||||
At the moment the paper screen v2 v4 have been tested and implemented.
|
||||
I juste hope the V1 & V3 will work the same.
|
||||
|
||||
### ⚡ Quick Install
|
||||
|
||||
68
README.md
68
README.md
@@ -18,7 +18,7 @@ Bjorn is a « Tamagotchi like » sophisticated, autonomous network scanning,
|
||||
- [Features](#-features)
|
||||
- [Getting Started](#-getting-started)
|
||||
- [Prerequisites](#-prerequisites)
|
||||
- [Installation](#-Installation)
|
||||
- [Installation](#-installation)
|
||||
- [Quick Start](#-quick-start)
|
||||
- [Usage Example](#-usage-example)
|
||||
- [Contributing](#-contributing)
|
||||
@@ -42,10 +42,9 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w
|
||||
|
||||
|
||||
## 🚀 Getting Started
|
||||
|
||||
### 📌 Prerequisites
|
||||
|
||||
|
||||
## 📌 Prerequisites
|
||||
### 📌 Prerequisites for RPI zero W (32bits)
|
||||
|
||||
|
||||
- Raspberry Pi OS installed.
|
||||
- Stable:
|
||||
@@ -55,7 +54,22 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w
|
||||
- Username and hostname set to `bjorn`.
|
||||
- 2.13-inch e-Paper HAT connected to GPIO pins.
|
||||
|
||||
At the moment the paper screen v2 & v4 have been tested and implemented.
|
||||
### 📌 Prerequisites for RPI zero W2 (64bits)
|
||||
|
||||
|
||||
|
||||
I did not develop Bjorn for the raspberry pi zero w2 64bits, but several feedbacks have attested that the installation worked perfectly.
|
||||
|
||||
- Raspberry Pi OS installed.
|
||||
- Stable:
|
||||
- System: 64-bit
|
||||
- Kernel version: 6.6
|
||||
- Debian version: 12 (bookworm) '2024-10-22-raspios-bookworm-arm64-lite'
|
||||
- Username and hostname set to `bjorn`.
|
||||
- 2.13-inch e-Paper HAT connected to GPIO pins.
|
||||
|
||||
|
||||
At the moment the paper screen v2 v4 have been tested and implemented.
|
||||
I juste hope the V1 & V3 will work the same.
|
||||
|
||||
### 🔨 Installation
|
||||
@@ -85,9 +99,47 @@ For **detailed information** about **troubleshooting** go to [Troubleshooting](T
|
||||
|
||||
**Quick Installation**: you can use the fastest way to install Bjorn [Getting Started](#-getting-started)
|
||||
|
||||
## 💡 Usage Example
|
||||
## 💡 Usage Example
|
||||
|
||||
Here's a demonstration of how Bjorn autonomously hunts through your network like a Viking raider (fake demo for illustration):
|
||||
|
||||
```bash
|
||||
# Reconnaissance Phase
|
||||
[NetworkScanner] Discovering alive hosts...
|
||||
[+] Host found: 192.168.1.100
|
||||
├── Ports: 22,80,445,3306
|
||||
└── MAC: 00:11:22:33:44:55
|
||||
|
||||
# Attack Sequence
|
||||
[NmapVulnScanner] Found vulnerabilities on 192.168.1.100
|
||||
├── MySQL 5.5 < 5.7 - User Enumeration
|
||||
└── SMB - EternalBlue Candidate
|
||||
|
||||
[SSHBruteforce] Cracking credentials...
|
||||
[+] Success! user:password123
|
||||
[StealFilesSSH] Extracting sensitive data...
|
||||
|
||||
# Automated Data Exfiltration
|
||||
[SQLBruteforce] Database accessed!
|
||||
[StealDataSQL] Dumping tables...
|
||||
[SMBBruteforce] Share accessible
|
||||
[+] Found config files, credentials, backups...
|
||||
```
|
||||
|
||||
This is just a demo output - actual results will vary based on your network and target configuration.
|
||||
|
||||
All discovered data is automatically organized in the data/output/ directory, viewable through both the e-Paper display (as indicators) and web interface.
|
||||
Bjorn works tirelessly, expanding its network knowledge base and growing stronger with each discovery.
|
||||
|
||||
No constant monitoring needed - just deploy and let Bjorn do what it does best: hunt for vulnerabilities.
|
||||
|
||||
🔧 Expand Bjorn's Arsenal!
|
||||
Bjorn is designed to be a community-driven weapon forge. Create and share your own attack modules!
|
||||
|
||||
⚠️ For educational and authorized testing purposes only ⚠️
|
||||
|
||||
|
||||
|
||||
...
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
|
||||
@@ -27,7 +27,7 @@ If you discover a security vulnerability within this project, please follow thes
|
||||
|
||||
1. **Do not create a public issue.** Instead, contact us directly to responsibly disclose the vulnerability.
|
||||
|
||||
2. **Email** [bjorn-cyberviking@outlook.com](bjorn-cyberviking@outlook.com) with the following information:
|
||||
2. **Email** [bjorn-cyberviking@outlook.com](mailto:bjorn-cyberviking@outlook.com) with the following information:
|
||||
|
||||
- A description of the vulnerability.
|
||||
- Steps to reproduce the issue.
|
||||
|
||||
@@ -25,12 +25,20 @@
|
||||
### Service Issues
|
||||
|
||||
```bash
|
||||
#See bjorn journalctl service
|
||||
journalctl -fu bjorn.service
|
||||
|
||||
# Check service status
|
||||
sudo systemctl status bjorn.service
|
||||
|
||||
# View detailed logs
|
||||
sudo journalctl -u bjorn.service -f
|
||||
|
||||
or
|
||||
|
||||
sudo tail -f /home/bjorn/Bjorn/data/logs/*
|
||||
|
||||
|
||||
# Check port 8000 usage
|
||||
sudo lsof -i :8000
|
||||
```
|
||||
|
||||
@@ -112,9 +112,9 @@ check_system_compatibility() {
|
||||
|
||||
# Check RAM (Raspberry Pi Zero has 512MB RAM)
|
||||
total_ram=$(free -m | awk '/^Mem:/{print $2}')
|
||||
if [ "$total_ram" -lt 429 ]; then
|
||||
log "WARNING" "Low RAM detected. Required: 512MB, Found: ${total_ram}MB"
|
||||
echo -e "${YELLOW}Your system has less RAM than recommended. This might affect performance.${NC}"
|
||||
if [ "$total_ram" -lt 410 ]; then
|
||||
log "WARNING" "Low RAM detected. Required: 512MB (410 With OS Running), Found: ${total_ram}MB"
|
||||
echo -e "${YELLOW}Your system has less RAM than recommended. This might affect performance, but you can continue.${NC}"
|
||||
should_ask_confirmation=true
|
||||
else
|
||||
log "SUCCESS" "RAM check passed: ${total_ram}MB available"
|
||||
@@ -122,7 +122,7 @@ check_system_compatibility() {
|
||||
|
||||
# Check available disk space
|
||||
available_space=$(df -m /home | awk 'NR==2 {print $4}')
|
||||
if [ "$available_space" -lt 1024 ]; then
|
||||
if [ "$available_space" -lt 2048 ]; then
|
||||
log "WARNING" "Low disk space. Recommended: 1GB, Found: ${available_space}MB"
|
||||
echo -e "${YELLOW}Your system has less free space than recommended. This might affect installation.${NC}"
|
||||
should_ask_confirmation=true
|
||||
|
||||
Reference in New Issue
Block a user