Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jesusprubio/bluebox
Pentesting framework using Node.js powers, focused in VoIP.
https://github.com/jesusprubio/bluebox
javascript shodan voip
Last synced: 26 days ago
JSON representation
Pentesting framework using Node.js powers, focused in VoIP.
- Host: GitHub
- URL: https://github.com/jesusprubio/bluebox
- Owner: jesusprubio
- License: mit
- Archived: true
- Created: 2013-03-26T17:57:46.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-06-05T20:23:28.000Z (over 7 years ago)
- Last Synced: 2024-11-09T08:02:10.967Z (about 1 month ago)
- Topics: javascript, shodan, voip
- Language: JavaScript
- Homepage:
- Size: 1.66 MB
- Stars: 262
- Watchers: 45
- Forks: 71
- Open Issues: 45
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rtc-hacking - bluebox-ng - Pentesting framework using Node.js powers, focused in VoIP. (Open-source tools)
README
# Bluebox-ng
[](https://www.blackhat.com/eu-14/arsenal.html)
[](https://travis-ci.org/jesusprubio/bluebox-ng)
[](https://nodesecurity.io/orgs/bluebox-ng/projects/108045b9-2ea5-45be-b4d6-0b8ca1cdb8a7)
[](https://npmjs.org/package/bluebox-ng)
Pentesting framework using Node.js powers. Focused in VoIP.
DISCLAIMER: Pointing this tool at other people's servers is **NOT** legal in most countries.
- Auto VoIP/UC penetration test
- Report generation
- Performance
- RFC compliant
- SIP TLS and IPv6 support
- SIP over websockets (and WSS) support (RFC 7118)
- SHODAN, exploitsearch.net and Google Dorks
- SIP common security tools (scan, extension/password bruteforce, etc.)
- Authentication and extension brute-forcing through different types of SIP requests
- SIP Torture (RFC 4475) partial support
- SIP SQLi check
- SIP denial of service (DoS) testing
- Web management panels discovery
- DNS brute-force, zone transfer, etc.
- Other common protocols brute-force: Asterisk AMI, MySQL, MongoDB, SSH, (S)FTP, HTTP(S), TFTP, LDAP, SNMP
- Some common network tools: whois, ping (also TCP), traceroute, etc.
- Asterisk AMI post-explotation
- Dumb fuzzing
- Automatic exploit searching (Exploit DB, PacketStorm, Metasploit)
- Automatic vulnerability searching (CVE, OSVDB, NVD)
- Geolocation
- Command completion
- Cross-platform support
## Install
- Install Node.js: https://nodejs.org/download
```sh
npm i -g bluebox-ng
```
### Kali GNU/Linux
- `curl -sL https://raw.githubusercontent.com/jesusprubio/bluebox-ng/master/artifacts/installScripts/kali2.sh | sudo bash -`
## Use
### Console
To start the console client.
```sh
bluebox-ng
```
### Programatically
To run it from other Node code.
```javascript
const Bluebox = require('bluebox-ng');
const box = new Bluebox();
box.run('gather/network/geo', { rhost: '8.8.8.8' })
.then(res => {
console.log('Result:');
console.log(res);
})
.catch(err => {
console.log('Error:');
console.log(err);
});
```
## Developer guide
- Use [GitHub pull requests](https://help.github.com/articles/using-pull-requests).
### Environment
- Get a copy of the code and install the dependencies.
```sh
git clone https://github.com/jesusprubio/bluebox-ng
cd bluebox-ng
npm i # or use yarn
```
### Debug
We use the [visionmedia module](https://github.com/visionmedia/debug), so you have to use this environment variable:
```sh
DEBUG=bluebox-ng* npm start
```
### New modules
You can add your own features to this environment following this tips:
- Add a new file inside [`/modules`](./modules) and it should appear in the pentesting environment.
- Use the most similar among the actual ones as boilerplate.
### Tests
We still don't have a proper Docker setup. So, for now, the test have to be run locally. Please check its code before it, they often need a valid target service.
```sh
./node_modules/.bin/tap test/wifi
node test/wifi/*
./node_modules/.bin/tap test/wifi/scanAps.js
node test/wifi/scanAps.js
```
### Conventions
- We use [ESLint](http://eslint.org/) and [Airbnb](https://github.com/airbnb/javascript) style guide.
- Please run to be sure your code fits with it and the tests keep passing:
```sh
npm run posttest
```
#### Commit messages rules
- It should be formed by a one-line subject, followed by one line of white space. Followed by one or more descriptive paragraphs, each separated by one line of white space. All of them finished by a dot.
- If it fixes an issue, it should include a reference to the issue ID in the first line of the commit.
- It should provide enough information for a reviewer to understand the changes and their relation to the rest of the code.
## Contributors
- https://github.com/jesusprubio/bluebox-ng/graphs/contributors
## Thanks to
- Our mentors: [@antonroman](https://twitter.com/antonroman), [@sandrogauci](https://twitter.com/sandrogauci) (SIPVicious was our inspiration), [@pepeluxx](https://twitter.com/pepeluxx), [@markcollier46](https://twitter.com/markcollier46) (["Hacking VoIP Exposed"](http://www.hackingvoip.com/)).
- [Quobis](http://www.quobis.com), some hours of work through personal projects program.
- Kamailio community ([@kamailioproject](https://twitter.com/kamailioproject)), our favourite SIP Server.
- Tom Steele ([@_tomsteele](https://twitter.com/_tomsteele)) and the rest of [exploitsearch.net](http://www.exploitsearch.net/) team.
- All developers who have written the Node.js modules used in the project.
- All VoIP, free software and security hackers that we read everyday.
- Our friend Carlos Pérez, the logo designer.