Skip to content

Commit

Permalink
add README
Browse files Browse the repository at this point in the history
  • Loading branch information
dmdhrumilmistry committed Oct 1, 2024
1 parent 367b26e commit a5fb089
Show file tree
Hide file tree
Showing 4 changed files with 95 additions and 1 deletion.
Binary file added .assets/images/masshog-resized.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .assets/images/masshog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
94 changes: 94 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# MassHog

![Masshog Logo](/.assets/images/masshog-resized.png)

**MassHog** is a command-line tool designed to help users efficiently scan multiple GitHub repositories for sensitive information using the [TruffleHog](https://github.com/trufflesecurity/trufflehog) tool. By providing a list of HTTPS URLs to repositories, MassHog simplifies the process of identifying secrets that may have been accidentally committed.

## Features

- **Batch Scanning**: Scan multiple GitHub repositories by providing a single file containing HTTPS URLs.
- **Integration with TruffleHog**: Leverage TruffleHog's powerful scanning capabilities for detecting secrets.
- **User-friendly Interface**: Easy-to-use command-line interface for quick setup and execution.
- **Configurable Options**: Customize the scan parameters for your specific needs.

## Requirements

- Go 1.23 or later
- [TruffleHog](https://github.com/trufflesecurity/trufflehog) installed on your machine

## Installation

### Using Go

* Install using `go install` command

```bash
go install github.com/dmdhrumilmistry/masshog@latest
```

### Manual Method

* Clone the repository

```bash
git clone https://github.com/dmdhrumilmistry/masshog.git
cd masshog
```

* Install `masshog`

```bash
go install .
```

## Usage

* To scan multiple GitHub repositories, create a file (e.g., `repos.txt`) that contains the HTTPS URLs of the repositories you want to scan. Each URL should be on a new line:

```txt
https://github.com/owner/repo1.git
https://github.com/owner/repo2.git
https://github.com/owner/repo3.git
```

* Run MassHog with the following command

```bash
masshog -f repos.txt -s state.json -o results.json
```

* For configurations and flags use `-h`

```bash
masshog -h
```

## Contributing

Contributions are welcome! If you have suggestions or improvements, please create a pull request or open an issue.

* Fork the repository

* Create your feature branch
```bash
git checkout -b feature/my-feature
```

* Commit your changes

```bash
git commit -m 'Add some feature'
```

* Push to the branch

```bash
git push origin feature/my-feature
```

* Open a pull request

## License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.

2 changes: 1 addition & 1 deletion main.go
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ func main() {
token := flag.String("gt", "", "github token for scanning private repos")

outputFile := flag.String("o", "results.json", "file path for storing json result file")
commitHashMapFile := flag.String("chm", "", "file path for loading and storing commit hash map")
commitHashMapFile := flag.String("s", "state.json", "file path for loading and storing commit hash map state")

flag.Parse()

Expand Down

0 comments on commit a5fb089

Please sign in to comment.