HTTPie plugin for web bot auth

A plugin to use web bot auth in HTTPie HTTP client.

Read the story behind Web Bot Auth, or find out more about how to Identify Bots with HTTP Message Signatures.

Installation

Install httpie via uv

uv venv

source ./venv/bin/activate

uv pip install httpie

httpie cli plugins install httpie-web-bot-auth

Usage

You should have a local key in a JSON-encoded JWK file.

Set HTTPIE_WBA_KEY to a path to this file.

Then make your request with http+wba://, or https+wba://.

Example

HTTPIE_WBA_KEY="/path/to/jwk.json" http 'http+wba://example.com'

Development

Requirements

• Python 3.13
• uv - Python package manager

Build

To build bot-auth package

uv sync

uv build

Lint

This codebase uses ruff and Black for linting.

To run a check, use

uv run ruff check .
uv run black --check .

To format the codebase

uv run ruff format .
uv run black .

Security Considerations

This software has not been audited. Please use at your sole discretion.

License

This project is under the Apache 2.0 license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be Apache 2.0 licensed as above, without any additional terms or conditions.