DocRock3r/Bjorn
1
0
Fork 0
mirror of https://github.com/infinition/Bjorn.git synced 2025-12-08 13:44:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2 from JuanVilla424/main

Browse Source 
style(core): infinition changes over style and prerequisites
This commit is contained in:
Na0nh
2024-11-15 07:03:40 -05:00
committed by GitHub
parent 34627fd6b2 5c23dd2000
commit aacd14ec11
7 changed files with 94 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.github/FUNDING.yml vendored
View File

@@ -10,6 +10,6 @@
#issuehunt: # Replace with a single IssueHunt username #issuehunt: # Replace with a single IssueHunt username
#lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry #lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
#polar: # Replace with a single Polar username #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 #thanks_dev: # Replace with a single thanks.dev username
#custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] #custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

2
CODE_OF_CONDUCT.md
View File

@@ -23,7 +23,7 @@ We are committed to fostering an open and welcoming environment for all contribu
## 📢 Reporting Misconduct ## 📢 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 ## ⚖️ Enforcement

23
INSTALL.md
View File

@@ -14,9 +14,8 @@
Use Raspberry Pi Imager to install your OS Use Raspberry Pi Imager to install your OS
https://www.raspberrypi.com/software/ https://www.raspberrypi.com/software/
### 📌 Prerequisites ### 📌 Prerequisites for RPI zero W (32bits)
![image](https://github.com/user-attachments/assets/3980ec5f-a8fc-4848-ab25-4356e0529639)
![image](https://github.com/user-attachments/assets/e775f454-1771-4d6c-bff5-b262b3d98452)
- Raspberry Pi OS installed. - Raspberry Pi OS installed.
- Stable: - Stable:
@@ -26,7 +25,23 @@ https://www.raspberrypi.com/software/
- Username and hostname set to `bjorn`. - Username and hostname set to `bjorn`.
- 2.13-inch e-Paper HAT connected to GPIO pins. - 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)
![image](https://github.com/user-attachments/assets/e8d276be-4cb2-474d-a74d-b5b6704d22f5)
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. I juste hope the V1 & V3 will work the same.
### ⚡ Quick Install ### ⚡ Quick Install

66
README.md
View File

@@ -18,7 +18,7 @@ Bjorn is a « Tamagotchi like » sophisticated, autonomous network scanning,
- [Features](#-features) - [Features](#-features)
- [Getting Started](#-getting-started) - [Getting Started](#-getting-started)
- [Prerequisites](#-prerequisites) - [Prerequisites](#-prerequisites)
- [Installation](#-Installation) - [Installation](#-installation)
- [Quick Start](#-quick-start) - [Quick Start](#-quick-start)
- [Usage Example](#-usage-example) - [Usage Example](#-usage-example)
- [Contributing](#-contributing) - [Contributing](#-contributing)
@@ -42,10 +42,9 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w
![Bjorn Display](https://github.com/infinition/Bjorn/assets/37984399/bcad830d-77d6-4f3e-833d-473eadd33921) ![Bjorn Display](https://github.com/infinition/Bjorn/assets/37984399/bcad830d-77d6-4f3e-833d-473eadd33921)
## 🚀 Getting Started ## 🚀 Getting Started
## 📌 Prerequisites
### 📌 Prerequisites ### 📌 Prerequisites for RPI zero W (32bits)
![image](https://github.com/user-attachments/assets/3980ec5f-a8fc-4848-ab25-4356e0529639)
![image](https://github.com/user-attachments/assets/e775f454-1771-4d6c-bff5-b262b3d98452)
- Raspberry Pi OS installed. - Raspberry Pi OS installed.
- Stable: - 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`. - Username and hostname set to `bjorn`.
- 2.13-inch e-Paper HAT connected to GPIO pins. - 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)
![image](https://github.com/user-attachments/assets/e8d276be-4cb2-474d-a74d-b5b6704d22f5)
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. I juste hope the V1 & V3 will work the same.
### 🔨 Installation ### 🔨 Installation
@@ -87,7 +101,45 @@ For **detailed information** about **troubleshooting** go to [Troubleshooting](T
## 💡 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 ## 🤝 Contributing

2
SECURITY.md
View File

@@ -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. 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. - A description of the vulnerability.
- Steps to reproduce the issue. - Steps to reproduce the issue.

8
TROUBLESHOOTING.md
View File

@@ -25,12 +25,20 @@
### Service Issues ### Service Issues
```bash ```bash
#See bjorn journalctl service
journalctl -fu bjorn.service
# Check service status # Check service status
sudo systemctl status bjorn.service sudo systemctl status bjorn.service
# View detailed logs # View detailed logs
sudo journalctl -u bjorn.service -f sudo journalctl -u bjorn.service -f
or
sudo tail -f /home/bjorn/Bjorn/data/logs/*
# Check port 8000 usage # Check port 8000 usage
sudo lsof -i :8000 sudo lsof -i :8000
``` ```

8
install_bjorn.sh
View File

@@ -112,9 +112,9 @@ check_system_compatibility() {
# Check RAM (Raspberry Pi Zero has 512MB RAM) # Check RAM (Raspberry Pi Zero has 512MB RAM)
total_ram=$(free -m | awk '/^Mem:/{print $2}') total_ram=$(free -m | awk '/^Mem:/{print $2}')
if [ "$total_ram" -lt 429 ]; then if [ "$total_ram" -lt 410 ]; then
log "WARNING" "Low RAM detected. Required: 512MB, Found: ${total_ram}MB" 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.${NC}" echo -e "${YELLOW}Your system has less RAM than recommended. This might affect performance, but you can continue.${NC}"
should_ask_confirmation=true should_ask_confirmation=true
else else
log "SUCCESS" "RAM check passed: ${total_ram}MB available" log "SUCCESS" "RAM check passed: ${total_ram}MB available"
@@ -122,7 +122,7 @@ check_system_compatibility() {
# Check available disk space # Check available disk space
available_space=$(df -m /home | awk 'NR==2 {print $4}') 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" 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}" echo -e "${YELLOW}Your system has less free space than recommended. This might affect installation.${NC}"
should_ask_confirmation=true should_ask_confirmation=true