Skip to main content
THE BOUNDARY

Trust is byte-sized

Bullring does not authenticate partners with API keys. The integration is identified by a registered public key ID, and every request proves possession of the matching private key.Four controls can work together:
  1. Timestamp limits replay time.
  2. Signature protects the exact method, path and body.
  3. Idempotency prevents duplicate writes during retries.
  4. Optional IP allowlisting restricts an integration to exact IPv4 or IPv6 addresses.
The private key never leaves your infrastructure. The public key is safe to register and rotate. Treat webhook signing secrets and private keys as credentials.When an IP allowlist is configured, requests from any other source address are rejected with 403 IP_NOT_ALLOWED. An empty allowlist permits requests from any source IP, subject to the other controls.

If a key is exposed

Revoke it immediately, register a replacement key, and inspect requests signed by the old key. Do not continue using the exposed key simply because it is a test key in a shared environment.