Skip to content

About

Countersign: let remote services complete mTLS handshakes with certificates that never leave the user's machine.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Countersign

Give a remote job temporary access to an HTTPS service that requires a client certificate installed on your desktop. You choose the certificate, destination scope, and duration in the Companion. Your machine signs the TLS handshake. Your Integrator’s Gateway completes it and can read the traffic.

Countersign approval in the Integrator's colours, showing its name beside the verified origin, the checked request facts, two certificates with a selected fingerprint, duration presets, when access ends, and Deny and Approve controls.

Try it with curl. Pair the Companion with the demo Integrator, pick one of the installed certificates, and compare its fingerprint with the one returned by the mTLS site. The demo runs its services and curl in Docker Compose. The Companion runs on your Linux desktop.

Use Countersign

Run npx @zeroae/countersign to open the desktop installer on Windows or macOS, or launch the AppImage on Linux. npm selects the x64 or ARM64 binary for the running Node process.

If you… Start here
Received a pairing or approval request Install and use the Companion
Own the application that starts jobs for users Integrate your service
Add pairing and approval controls to a page Web widget integration
Run the Gateway and Broker Self-host and operate
Need to know where keys and plaintext go Architecture and trust diagram
Need evidence for a particular OS, provider, or installer Tested platforms

How the handshake works

Countersign architecture showing the Workload and Gateway, the separate TLS connection to the protected site, and the desktop signing through the Broker.

Each Integrator hosts its own Broker and Gateway. Solid arrows carry the job's traffic. Dashed arrows carry authorization and signing messages. One desktop Companion can pair with several Integrators. The default Gateway runs beside one Workload. A shared Gateway is also available for Linux hosts.

Read the handbook locally

From the checkout, run:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-docs.txt
.venv/bin/python -m mkdocs serve

Open the local address printed by MkDocs. For native builds, installers, and the local conda package, see Develop and release.

License

MIT, copyright 2026 Zero A.E., LLC.

About

Countersign: let remote services complete mTLS handshakes with certificates that never leave the user's machine.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages