https://github.com/daddycocoaman/beacongraph

Graph visualization of wireless client and access point relationships
https://github.com/daddycocoaman/beacongraph

neo4j python wireless

Last synced: 2 months ago
JSON representation

Graph visualization of wireless client and access point relationships

• Host: GitHub
• URL: https://github.com/daddycocoaman/beacongraph
• Owner: daddycocoaman
• License: gpl-3.0
• Created: 2018-09-26T21:20:49.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2022-12-14T18:33:03.000Z (about 2 years ago)
• Last Synced: 2024-11-01T00:51:25.796Z (3 months ago)
• Topics: neo4j, python, wireless
• Language: Vue
• Homepage:
• Size: 26.9 MB
• Stars: 117
• Watchers: 7
• Forks: 14
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# BEACONGRAPH (v1.0.0-beta)



## Description

BeaconGraph is an interactive tool that visualizes client and Access Point relationships. Inspired by [airgraph-ng](https://github.com/aircrack-ng/aircrack-ng/tree/master/scripts/airgraph-ng) and [Bloodhound](https://github.com/BloodHoundAD/BloodHound), BeaconGraph aims to support wireless security auditing. The frontend is written in Vue and the backend in Python 3.8. Data is parsed into a [Neo4j](https://github.com/neo4j/neo4j) database.

# Installation

## With Docker

Most users may find it easier to install Beacongraph via Docker. This is the recommended method.

```

git clone https://github.com/daddycocoaman/BeaconGraph

docker-compose up

```

The `docker-compose` file will create three containers:

- Frontend

- Backend

- Neo4j v4

By default, the BeaconGraph container will expose the UI on port 9091. The neo4j container will expose neo4j on ports 7474 (HTTP), and 7687 (Bolt). You may initially interact directly with the neo4j interface on port 7474.

**Note**: Currently, BeaconGraph only supports running these containers locally. Attempting to upload to the frontend hosted remotely will be unsuccessful but this behavior is expected to change in the future.

The default credentials for neo4j are: **neo4j/password**. You can change this in the `docker-compose` file via the NEO4JAUTH environment variable.

## Usage

Once logged in, you are able to upload data using the "Upload Data" widget. Currently only `airodump-ng` output is supported. After the data is ingested, you can query the database using [Cypher](https://neo4j.com/developer/cypher/intro-cypher/) language. Example queries are available in the Queries tab.

## Screenshots

![Logo](docs/screenshot1.png "BeaconGraph UI")

## Bugs

- You may recieve an error or "no results found" if you try to query before an upload of data has finished processing. This should disappear once the ingestion is complete.