-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Move installation instructions to install.md
- Loading branch information
1 parent
091bbf6
commit 1aa13bf
Showing
1 changed file
with
62 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,62 @@ | ||
# Project Seaweed | ||
|
||
[](https://github.com/coreruleset/Project-Seaweed/actions?workflow=Tests) | ||
|
||
|
||
## Fetching CRS logs from the container | ||
|
||
This project does not provide the functionality to fetch the logs from CRS container. However, you can use the `--keep-setup` flag to prevent auto-removal of the docker setup (crs container, apache container and docker network). After that, you can fetch the audit logs using the following command. | ||
|
||
`docker cp crs-waf:/root/audit.log <path to save log file>` | ||
|
||
**Caveat**: If you specify `--keep-setup`, you are responsible for performing the cleanup activity. To do that, just enter the following commands. | ||
|
||
`docker stop crs-waf` | ||
|
||
`docker stop httpd-server` | ||
|
||
`docker network rm seaweed-network` | ||
|
||
## Installation | ||
|
||
1. **Clone the repository** | ||
|
||
`git clone https://github.com/coreruleset/Project-Seaweed.git` | ||
|
||
2. **Install poetry** | ||
|
||
Poetry is a tool for dependency management and packaging in Python. | ||
|
||
[https://python-poetry.org/docs/#installation](https://python-poetry.org/docs/#installation) | ||
|
||
3. **Install docker** | ||
|
||
This project needs docker to setup a local web server, web application firewall. If you're using a custom waf URL for testing, then docker is not needed. | ||
|
||
[https://docs.docker.com/engine/install/](https://docs.docker.com/engine/install/) | ||
|
||
5. **Install Nuclei** | ||
|
||
The program uses Nuclei to launch attacks. Make sure nuclei is in the path and nuclei templates are installed in the home directory and not a custom directory. Install from here: [https://nuclei.projectdiscovery.io/nuclei/get-started/#nuclei-installation](https://nuclei.projectdiscovery.io/nuclei/get-started/#nuclei-installation) | ||
|
||
6. **Select Python version** | ||
|
||
The project is tested on Python `3.9.13`. If you have multiple python versions installed, use the following command: | ||
|
||
`poetry env use 3.9` | ||
|
||
7. **Install the project** | ||
|
||
`poetry install` | ||
|
||
8. **Finally run the project** | ||
|
||
`poetry run project-seaweed` | ||
|
||
9. **Get help** | ||
|
||
`poetry run project-seaweed --help` | ||
|
||
For command specific help | ||
|
||
`poetry run project-seaweed tester --help` |