Skip to main content

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)

Source distribution for akii 0.0.1
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)

Table of built distributions (wheels) for akii 0.0.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page