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.7.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.7-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: akii-0.1.7.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.7.tar.gz
Algorithm Hash digest
SHA256 566fdff3454066153f1edd60590c502e0e47ee1c470633b93c42283772663b7a
MD5 64975f075211b3327befa3898ab215cc
BLAKE2b-256 4b10fcc55f407582d03e66739f394a247b78d1330d8fbaa17a8bd311244d891c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: akii-0.1.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 7acd16ffc25cc4353b57ace20318f578e16965ffbf937ed7e1a7c24c0a95868a
MD5 81ae2f07f40b99df9c891bfb362a7cdd
BLAKE2b-256 f3463115796d32116416268ef7732e84fece7c84a47c7982c18e5b9a6cd51e4f

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