Skip to main content

HTTP header analyzer

Project description

AkII

A fast and lightweight HTTP security header analyzer.

AkII is an open-source security tool for analyzing HTTP response headers and identifying common security misconfigurations, such as weak or missing security headers.

⚠️ Early Development

AkII is in an early stage of development. Some features are still incomplete, and bugs are expected. The project is under active development, and new functionality will be added in future releases.

Features

  • Analyze HTTP security headers
  • Detect common CORS misconfigurations
  • Detect missing or insecure Content Security Policy (CSP)
  • Human-readable terminal output
  • JSON output for automation
  • Lightweight and extensible YAML-based rule engine

Why AkII?

AkII is designed for speed, automation, and extensibility.

AkII focuses on one task: analyzing HTTP security headers quickly and consistently.

It is suitable for:

  • CI/CD pipelines
  • Security automation
  • Bug bounty workflows
  • Batch scanning with wordlists
  • Integration into custom tools

Installation

From PyPI (Recommended)

pipx install akii

or

pip install akii

From Source

git clone https://github.com/MintTester-IO/AkII.git
cd akii
pip install -e .

Uninstallation

If you installed AkII with pipx:

pipx uninstall akii

If you installed AkII with pip:

pip uninstall akii

If you installed AkII from source using pip install -e .:

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 the report:

akii -T https://example.com -o report.txt

Export JSON:

akii -T https://example.com -jo report.txt

Current Checks

  • Cross-Origin Resource Sharing (CORS)
  • Content Security Policy (CSP)

More security header checks will be added in future releases.

Project Structure

src/akii/
├── checks/      # Detection and analysis modules
├── core/        # Controller, CLI, reporting
├── http/        # HTTP client
├── templates/   # YAML rule definitions
└── ui/          # Terminal output

Roadmap

  • HSTS analysis
  • Cookie analysis
  • Cache-Control analysis
  • Permissions-Policy analysis
  • Referrer-Policy analysis
  • HTML reports
  • Improved JSON reporting
  • Plugin system

Contributing

Contributions are welcome.

If you find a bug, have a feature request, or would like to improve AkII, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

akii-0.1.6.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

akii-0.1.6-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

Details for the file akii-0.1.6.tar.gz.

File metadata

  • Download URL: akii-0.1.6.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for akii-0.1.6.tar.gz
Algorithm Hash digest
SHA256 8e0dfc36ad447a230e1f9f0d5181ca5f4d64422c2b49cb5eceac9c6cf011f163
MD5 b5aec9a13b8741e9f00d9fdeedb08862
BLAKE2b-256 b2e362ee918e67328d351428aea082f19cdb914fa91c2067f814abe755b56d7f

See more details on using hashes here.

File details

Details for the file akii-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: akii-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for akii-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 d7e8752b6ac3db5f47c5402ca9cd01318411e83b15baffe4c8464645d9fa1649
MD5 930d974cc6996d5e6642fa215f94ae43
BLAKE2b-256 797df8d10c679af45006641cbceeef41ebc33620cd205963637a9b2f6fe2c567

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page