2021-03-16 21:56:23 +00:00
|
|
|
# Overseer
|
2021-03-18 02:19:03 +00:00
|
|
|
|
2021-03-16 21:56:23 +00:00
|
|
|
## Description
|
|
|
|
|
Overseer is a port scanning web interface. All current and historical results are stored in a database.
|
|
|
|
|
|
2021-03-21 02:16:24 +00:00
|
|
|
## Running
|
|
|
|
|
```
|
|
|
|
|
# Be sure image is built
|
|
|
|
|
docker-compose build
|
|
|
|
|
|
|
|
|
|
# Run compose in background. Service accessible via localhost:5000
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
```
|
|
|
|
|
|
2021-03-18 02:19:03 +00:00
|
|
|
## Developing
|
|
|
|
|
|
|
|
|
|
### Server
|
|
|
|
|
Ideally from a virtualenv:
|
|
|
|
|
```
|
|
|
|
|
python setup.py develop
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Client
|
|
|
|
|
At this point, you have to build the client to appropriately populate the static resources for
|
|
|
|
|
the Flask server to serve up.
|
|
|
|
|
|
2021-03-16 21:56:23 +00:00
|
|
|
## Building
|
2021-03-18 02:19:03 +00:00
|
|
|
Overseer consists of a server and client component.
|
|
|
|
|
|
|
|
|
|
### Server:
|
|
|
|
|
Ideally from a virtualenv:
|
|
|
|
|
```
|
|
|
|
|
python setup.py install
|
|
|
|
|
```
|
2021-03-16 21:56:23 +00:00
|
|
|
|
2021-03-18 02:19:03 +00:00
|
|
|
### Client:
|
|
|
|
|
You must run these commands from the `./src/overseer_client/` directory:
|
|
|
|
|
```
|
|
|
|
|
yarn build
|
|
|
|
|
```
|
2021-03-16 21:56:23 +00:00
|
|
|
|
2021-03-18 02:19:03 +00:00
|
|
|
# Notes
|
|
|
|
|
In a production environment, it would be ideal to setup something like nginx to properly forward
|
|
|
|
|
the `/api/*` routes to the Flask server, and all other endpoints to the static client resources.
|
