ScaleBun
Skip to article

SDK & API keys

Administrator

SDK & API keys in the Workspace area (Admin) — route /workspace/sdk-api-keys.

Updated Reviewed

SDK & API keys lives in the Workspace area of the dashboard, under Admin.

At a glance#

Dashboard route/workspace/sdk-api-keys
AreaWorkspace (workspace)
GroupAdmin
PlatformsAvailable for every app platform.

What it does#

Issues and rotates the credentials each app environment uses. Every environment gets its own pair, which is what keeps development traffic out of production data.

The two keys are not interchangeable#

PrefixShip in an app binary?
Client keyskb_test_ck_ · skb_staging_ck_ · skb_live_ck_Yes — that is its purpose
Secret keyskb_{env}_sk_Never

The environment prefix exists so a key visibly declares its blast radius. If you are unsure which environment a key belongs to, read the prefix rather than inferring it from where you found it. Keys issued before the prefixed scheme (scalebun_ck_…) remain valid.

Workflow#

  1. Create per environment, not per developer

    Keys identify an environment, not a person. Issuing one each makes rotation impossible to reason about.

  2. Copy the secret to your secret manager now

    This is the only moment it is visible.

  3. Rotate on a schedule, and on every departure

    Rotation is cheap; discovering a leaked key in a public repository is not.

Rotating without downtime#

Create the new key first, deploy it, confirm traffic arrives under it, and only then revoke the old one. Revoking first causes an outage for every client still holding the old key — including app versions already installed on devices you do not control.

Where the data comes from#

Client keys are safe in an app binary; secret keys are shown once and are server-side only.

From the SDK

Served by

  • SDK keys

SDK & API keys · Workspace · Dashboard · ScaleBun