Create API Key
To access the Bron API, you need an API key. Follow the steps below to create one:
1
Enable API Key Access
Go to Workspace › Security and make sure Enable API key creation is turned on. If it is disabled, contact your workspace owner to enable it.
2
Start a New API Key creation
In Workspace › API Keys, click New API Key. Enter a name, select a role, and (optionally) specify allowed IP addresses.
3
Generate or Supply Your Key Pair
Bron uses asymmetric keys. You have two options:
When you supply your own JWK, it must meet these requirements:
Example JWK
| Generation type | Description |
|---|---|
| Self-generation | Generate the key pair yourself and share only the public key with Bron. Keep the private key secure. |
| Browser generation | The browser generates the key pair; the private key never leaves the browser and is shown only once. |
| Property | Requirement |
|---|---|
| kty | Must be "EC". |
| crv | One of "P-256", "P-384", "P-521", "SECP256K1" or "Ed25519". |
| x, y | Both required; base64url-encoded curve coordinates. |
| No private fields | Must not include "d" or any other private-key material. |
| kid (optional) | 20–30 alphanumeric characters or hyphens (^[0-9A-Za-z\-]{20,30}$). Auto-generated if omitted. |
How to generate a key?
How to generate a key?
You can use any library that supports ES256 and JWK. For example:
- JavaScript (Node.js): panva/jose
- Java: Nimbus JOSE + JWT
- Or any other ES256-compatible library.