AkII
A lightweight HTTP security analysis toolkit
AkII is an open-source security tool designed to analyze HTTP security configurations and identify common web security misconfigurations.
It focuses on analyzing HTTP responses, security headers, and related security mechanisms to help security researchers and developers identify potential weaknesses.
⚠️ Pre-release
AkII is currently a pre-release version and is not considered production-ready. Some features are incomplete, and breaking changes may occur as the project evolves. New security checks and improvements will be added in future releases.
Features
- Analyze HTTP security headers
- CORS security analysis
- Passive security checks
- Automated security configuration comparison
- Human-readable terminal output
- JSON output for automation
- Lightweight and extensible YAML-based rule system
Overview
AkII is built to be extensible and automation-friendly.
The goal is to provide a consistent way to analyze HTTP security configurations across multiple targets.
It is designed for:
- Security automation
- Bug bounty workflows
- Web application security testing
- Batch analysis of multiple targets
- Integration with custom security pipelines
Installation
From PyPI (Recommended)
pipx install akii
or:
pip install akii
From Source
git clone https://github.com/Mintesio/AkII.git
cd akii
pip install -e .
Update
To update AkII, use the command matching your installation method.
Installed with pip
pip install --upgrade akii
or:
pip install -U akii
Installed with pipx
pipx upgrade akii
Update all pipx packages:
pipx upgrade-all
Check Current Version
akii --version
If you encounter problems after updating, make sure you are running the latest version before reporting an issue.
Uninstallation
Installed with pipx
pipx uninstall akii
Installed with pip
pip uninstall akii
Installed from source
pip uninstall akii
cd ..
rm -rf akii
Usage
Scan a Single Target
akii -T https://example.com
Scan Multiple Targets
akii -w targets.txt
Show Request Headers
akii -T https://example.com --request
Show Response Headers
akii -T https://example.com --response
Verbose Mode
akii -T https://example.com --verbose
Save Report
akii -T https://example.com -o report.txt
Export JSON
akii -T https://example.com -j report.json
Project Structure
src
├─ core: Application logic, controller, CLI handling, and argument parsing.
├─ http: HTTP client responsible for request handling.
├─ scan: Coordinates scanning workflows and security checks.
├─ checks: Security analysis modules such as CORS, CSP, Cookies, and HSTS.
├─ templates: YAML-based security rule definitions.
└─ output: Terminal formatting and report generation.
Current Checks
Cross-Origin Resource Sharing (CORS)
Current MVP focus.
Planned CORS capabilities:
- Passive CORS analysis
- Origin behavior analysis
- Misconfiguration detection
- Header comparison
- Automated CORS testing scenarios
More security checks will be added in future releases.
Roadmap
Security Checks
-
Complete CORS analysis
- Passive analysis
- Origin comparison
- Automated test cases
- Fuzzing support
-
HSTS analysis
-
Cookie security analysis
-
Cache-Control analysis
-
Permissions-Policy analysis
-
Referrer-Policy analysis
-
Content Security Policy (CSP)
Output & Integration
- HTML reports
- Improved JSON reporting
- Plugin system
- Custom rule support
Contributing
Contributions are welcome.
If you find a bug, have a feature request, or want to improve AkII, feel free to open an issue or submit a pull request.
License
This project is licensed under the MIT License.
Metadata
Release files for akii 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| akii-0.0.1.tar.gz | 18.8 kB | Without provenance | Details for akii-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| akii-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for akii-0.0.1-py3-none-any.whl |
Total release size: 39.5 kB
Release files / akii-0.0.1.tar.gz
| Download URL | akii-0.0.1.tar.gz |
|---|---|
| Size | 18.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
523e4f55a323fa9a7d8d1a3554eb1ba2bb9561990d169bf6af17308a44178dcf
|
|
BLAKE2b-256 checksum How to use checksums |
671cd35140465b1f8e8593c7d254136013245873e606a5e8c8aeca31dffd08fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / akii-0.0.1-py3-none-any.whl
| Download URL | akii-0.0.1-py3-none-any.whl |
|---|---|
| Size | 20.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2722edc29c245c9ac4b52f73d65ab4d50acda9ec695972e08f05fedd83e16fd6
|
|
BLAKE2b-256 checksum How to use checksums |
71e9f051b4824e90663e843cd5cd653f183d950cd8fa588a12d217dab8556d5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for akii 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.