Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/enenumxela/csspp
https://github.com/enenumxela/csspp
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/enenumxela/csspp
- Owner: enenumxela
- License: mit
- Created: 2024-11-18T19:00:48.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-11-18T19:01:43.000Z (about 1 month ago)
- Last Synced: 2024-11-20T07:14:50.741Z (about 1 month ago)
- Language: Go
- Size: 33.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# csspp
[](https://github.com/enenumxela/csspp/releases) [](https://github.com/enenumxela/csspp/blob/master/LICENSE)  [](https://github.com/enenumxela/csspp/issues?q=is:issue+is:open) [](https://github.com/enenumxela/csspp/issues?q=is:issue+is:closed) [](https://github.com/enenumxela/csspp/blob/master/CONTRIBUTING.md)
## Resources
* [Installation](#installation)
* [Install release binaries (Without Go Installed)](#install-release-binaries-without-go-installed)
* [Install source (With Go Installed)](#install-source-with-go-installed)
* [`go install ...`](#go-install)
* [`go build ...` the development Version](#go-build--the-development-version)
* [Install on Docker (With Docker Installed)](#install-on-docker-with-docker-installed)
* [Usage](#usage)
* [Pull Programs](#pull-programs)
* [Contributing](#contributing)
* [Licensing](#licensing)
* [Credits](#credits)
* [Contributors](#contributors)
* [Similar Projects](#similar-projects)
## Installation
### Install release binaries (Without Go Installed)
Visit the [releases page](https://github.com/enenumxela/csspp/releases) and find the appropriate archive for your operating system and architecture. Download the archive from your browser or copy its URL and retrieve it with `wget` or `curl`:
* ...with `wget`:
```bash
wget https://github.com/enenumxela/csspp/releases/download/v/csspp--linux-amd64.tar.gz
```
* ...or, with `curl`:
```bash
curl -OL https://github.com/enenumxela/csspp/releases/download/v/csspp--linux-amd64.tar.gz
```
...then, extract the binary:
```bash
tar xf csspp--linux-amd64.tar.gz
```
> [!TIP]
> The above steps, download and extract, can be combined into a single step with this onliner
>
> ```bash
> curl -sL https://github.com/enenumxela/csspp/releases/download/v/csspp--linux-amd64.tar.gz | tar -xzv
> ```
> [!NOTE]
> On Windows systems, you should be able to double-click the zip archive to extract the `csspp` executable.
...move the `csspp` binary to somewhere in your `PATH`. For example, on GNU/Linux and OS X systems:
```bash
sudo mv csspp /usr/local/bin/
```
> [!NOTE]
> Windows users can follow [How to: Add Tool Locations to the PATH Environment Variable](https://msdn.microsoft.com/en-us/library/office/ee537574(v=office.14).aspx) in order to add `csspp` to their `PATH`.
### Install source (With Go Installed)
Before you install from source, you need to make sure that Go is installed on your system. You can install Go by following the official instructions for your operating system. For this, we will assume that Go is already installed.
#### `go install ...`
```bash
go install -v github.com/enenumxela/csspp/cmd/csspp@latest
```
#### `go build ...` the development Version
* Clone the repository
```bash
git clone https://github.com/enenumxela/csspp.git
```
* Build the utility
```bash
cd csspp/cmd/csspp && \
go build .
```
* Move the `csspp` binary to somewhere in your `PATH`. For example, on GNU/Linux and OS X systems:
```bash
sudo mv csspp /usr/local/bin/
```
Windows users can follow [How to: Add Tool Locations to the PATH Environment Variable](https://msdn.microsoft.com/en-us/library/office/ee537574(v=office.14).aspx) in order to add `csspp` to their `PATH`.
> [!CAUTION]
> While the development version is a good way to take a peek at `csspp`'s latest features before they get released, be aware that it may have bugs. Officially released versions will generally be more stable.
### Install on Docker (With Docker Installed)
To install `csspp` on docker:
* Pull the docker image using:
```bash
docker pull enenumxela/csspp:latest
```
* Run `csspp` using the image:
```bash
docker run --rm enenumxela/csspp:latest -h
```
## Post Installation Setup
```yml
version: 0.0.0
platforms:
- bugcrowd
- hackerone
- intigriti
- yeswehack
# Keys
keys:
bugcrowd: [TOKEN]
hackerone: [USERNAME]:[TOKEN]
intigriti: [TOKEN]
yeswehack: [TOKEN]
# Blacklist
blacklist:
yeswehack:
lazada: true
```
How to get the session token:
* Bugcrowd: login, then grab the `_crowdcontrol_session` cookie
* HackerOne: login, then grab your API token [here](https://hackerone.com/settings/api_token/edit)
* Intigriti: login, then intercept a request to api.intigriti.com and look for the `Authentication: Bearer XXX` header. XXX is your token
* YesWeHack: login, then intercept a request to api.yeswehack.com and look for the `Authorization: Bearer XXX` header. XXX is your token
## Usage
To display help message for `csspp` use the `-h` flag:
```bash
csspp -h
```
help message:
```
_ _ ____ ____ ____
_ __ _ _| | | __ )| __ )| _ \ _ __ ___ __ _ _ __ __ _ _ __ ___ ___
| '_ \| | | | | | _ \| _ \| |_) | '__/ _ \ / _` | '__/ _` | '_ ` _ \/ __|
| |_) | |_| | | | |_) | |_) | __/| | | (_) | (_| | | | (_| | | | | | \__ \
| .__/ \__,_|_|_|____/|____/|_| |_| \___/ \__, |_| \__,_|_| |_| |_|___/
|_| |___/ v0.0.0
with <3 by Hueristiq Security Research
USAGE:
csspp [OPTIONS]
CONFIGURATION:
-c, --configuration string configuration file path (default: /home/enenumxela/.config/csspp/config.yaml)
PLATFORMS:
-u, --use-platforms string[] comma(,) separated platforms to use (default: bugcrowd,hackerone,intigriti,yeswehack)
-e, --exclude-platforms string[] comma(,) separated platforms to exclude
PROGRAMS:
--include-private-programs bool include private programs
OUTPUT:
--no-color bool no colored mode
-o, --output string programs data path (default: ./bug-bounty-programs)
-v, --verbosity string debug, info, warning, error, fatal or silent (default: info)
pflag: help requested
```
### Pull Programs
```bash
csspp
```
```
bug-bounty-programs
├── .raw
│ ├── bugcrowd_programs.json
│ ├── hackerone_programs.json
│ ├── intigriti_programs.json
│ └── yeswehack_programs.json
├── bugcrowd_programs.json
├── hackerone_programs.json
├── intigriti_programs.json
└── yeswehack_programs.json
```
## Resources
- [Bugcrowd's API](https://docs.bugcrowd.com/api/getting-started/)
- [HackerOne's API](https://api.hackerone.com/)
- [Intigriti's Researcher API](https://intigriti-researcher-api.readme.io/reference/introduction-to-intigritis-researcher-api)
- [YesWeHack's API](https://api.yeswehack.com/doc)
## Contributing
We welcome contributions! Feel free to submit [Pull Requests](https://github.com/enenumxela/csspp/pulls) or report [Issues](https://github.com/enenumxela/csspp/issues). For more details, check out the [contribution guidelines](https://github.com/enenumxela/csspp/blob/master/CONTRIBUTING.md).
## Licensing
This utility is licensed under the [MIT license](https://opensource.org/license/mit). You are free to use, modify, and distribute it, as long as you follow the terms of the license. You can find the full license text in the repository - [Full MIT license text](https://github.com/enenumxela/csspp/blob/master/LICENSE).
## Credits
### Contributors
A huge thanks to all the contributors who have helped make `csspp` what it is today!
[](https://github.com/enenumxela/csspp/graphs/contributors)
### Similar Projects
If you're interested in more utilities like this, check out:
[Arkadiy Tetelman's bounty-targets](https://github.com/arkadiyt/bounty-targets) ◇ [AmirMohammad Safari's bugbounty-targets](https://github.com/Osb0rn3/bugbounty-targets)