0xb00b5/0xb00b5-packmate
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Сообщения переведены на английский, исправлена грамматика

Browse Source
This commit is contained in:
serega6531
2020-03-16 23:52:16 +03:00
parent bcbe983704
commit 573142deeb
9 changed files with 37 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
README_EN.md
View File

@@ -14,7 +14,7 @@ Advanced network traffic flow analyzer for A/D CTFs.
* Binary substring
* Can make certain streams favorite and show only favorite streams
* Supports several simultaneous services, can show streams for a specific service or pattern
* Allows to navigate streams using shortcuts
* Allows navigating streams using shortcuts
* Has the option to copy packet content in the required format
* Can concatenate adjacent packets
* Can urldecode text automatically
@@ -22,12 +22,12 @@ Advanced network traffic flow analyzer for A/D CTFs.
![Main window](screenshots/Screenshot.png)
## Cloning
As this repository contains frontend part as git submodule, it has to be cloned like this:
As this repository contains frontend part as a git submodule, it has to be cloned like this:
```bash
git clone --recurse-submodules https://gitlab.com/binarybears_ctf/Packmate.git
git clone --recurse-submodules https://gitlab.com/packmate/Packmate.git
# Or if you have older git
git clone --recursive https://gitlab.com/binarybears_ctf/Packmate.git
git clone --recursive https://gitlab.com/packmate/Packmate.git
```
If the repository was already cloned without submodule, just run:
@@ -39,23 +39,23 @@ git submodule update --init --recursive
## Preparation
This program uses Docker and docker-compose.
`packmate-db` will listen port 65001 at localhost.
Database files do not mount as volume, so upon container recreation all data will be lost.
`packmate-db` will listen to port 65001 at localhost.
Database files do not mount as volume, so upon container recreation, all data will be lost.
### Settings
This program retreives settings from environment variables,
so it would be convenient to create env file;
This program retrieves settings from environment variables,
so it would be convenient to create an env file;
It must be called `.env` and located at the root of the project.
Contents of the file:
```bash
# Interface to capture on
PACKMATE_INTERFACE=wlan0
# Local ip on said interface to tell incoming packets from outgoing
# Local IP on said interface to tell incoming packets from outgoing
PACKMATE_LOCAL_IP=192.168.1.124
# Username for web interface
# Username for the web interface
PACKMATE_WEB_LOGIN=SomeUser
# Password for web interface
# Password for the web interface
PACKMATE_WEB_PASSWORD=SomeSecurePassword
```
@@ -67,8 +67,8 @@ sudo docker-compose up --build -d
If everything went fine, Packmate will be available on port `65000` from any host
### Accessing web interface
When you open web interface for the first time, you will be asked for login and password
### Accessing the web interface
When you open a web interface for the first time, you will be asked for a login and password
you specified in the env file.
After entering the credentials, open the settings by clicking on the cogs
in the top right corner and enter login and password again.
@@ -76,18 +76,18 @@ in the top right corner and enter login and password again.
![Settings](screenshots/Screenshot_Settings.png)
All settings are saved in the local storage and will be
lost only upon changing server ip or port.
lost only upon changing server IP or port.
## Usage
First of all you should create game services.
First of all, you should create game services.
To do that click `+` in the navbar,
then fill in service name, port and optimization to perform.
then fill in the service name, port, and optimization to perform.
System will start automatically capture streams and show them in a sidebar.
Click at stream to view a list of packets;
The system will start automatically capture streams and show them in a sidebar.
Click at a stream to view a list of packets;
you can click a button in the sidebar to switch between binary and text views.
For a simple monitoring of flags there is a system of patterns.
For simple monitoring of flags, there is a system of patterns.
To create a pattern open `Patterns` dropdown menu, press `+`, then
specify the type of pattern, the pattern itself, highlight color and other things.