A CLI tool to detect secrets in repositories for maintaining best security practices.
Project description
secchecker
secchecker is a Python package + CLI tool to detect hidden or untracked hardcoded secrets in repositories, helping developers keep their projects secure and audit-ready.
✨ Features
- Detects common secret types:
- Database credentials (Postgres, MySQL, Mongo)
- Cloud keys (AWS, GCP, Azure)
- Authentication tokens (JWTs, Private Keys)
- Generic API keys & passwords in configs
- Generates JSON and Markdown reports
- Easy CLI usage for DevSecOps pipelines
🚀 Installation
Clone the repository and install in editable mode:
git clone https://github.com/yourusername/secchecker.git
cd secchecker
pip install -e .
🛠 Usage
Scan a repository or project folder:
secchecker path/to/scan --format md
Options:
--format json→ generate JSON report--format md→ generate Markdown report
Example:
secchecker . --format json
⚠️ Disclaimer
secchecker is intended only for security auditing of repositories you own or have explicit permission to test.
- Misuse of this tool to access, scan, or extract information from systems you do not own is strictly prohibited and may violate the law.
- The author(s) assume no liability for misuse or damages caused by this software.
📜 Terms & Conditions
By using secchecker, you agree to the following:
- You will only use this tool on codebases you own or have explicit authorization to audit.
- You will not use this software for malicious purposes, including but not limited to unauthorized access, exploitation, or data theft.
- The software is provided “as is,” without warranty of any kind, express or implied.
- The author(s) are not responsible for any damages, losses, or legal consequences arising from the use or misuse of this software.
- You accept full responsibility for ensuring that your use of this tool complies with applicable laws and regulations in your jurisdiction.
🤝 Contributing
Contributions are welcome!
- Fork the repo
- Create a feature branch
- Submit a pull request 🚀
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file secchecker-0.1.3.tar.gz.
File metadata
- Download URL: secchecker-0.1.3.tar.gz
- Upload date:
- Size: 6.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e11a28727101fb173b572d3124236f7f3eef2d09007604f8b666869e06356089
|
|
| MD5 |
e0af79c436194b8078f6290fe12110eb
|
|
| BLAKE2b-256 |
fe80a8c55db3be53ec041c175ca00b6dfd69e94b571f74fe8a64a1d1115822ff
|
File details
Details for the file secchecker-0.1.3-py3-none-any.whl.
File metadata
- Download URL: secchecker-0.1.3-py3-none-any.whl
- Upload date:
- Size: 7.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5348a43cd292b702a5d32d6b941bde8a1db079de381ea20cd92fef411ba84ecd
|
|
| MD5 |
43717db0e855a4842b4b413d732b2ee4
|
|
| BLAKE2b-256 |
8d04426c2e84f013ed1aa5a3657ececb1e6d9d2d1930e1201681dae2842d9932
|