Protect Your PlanetScale Credentials

Q: How do I protect my PlanetScale API key?

ShieldKey wraps your PlanetScale API key in a proxy token. Your real key stays encrypted — team members use revocable shield tokens that can be disabled in one click, without rotating the underlying key.

Q: Can I use ShieldKey with the @planetscale/database SDK?

Yes. ShieldKey works as a drop-in proxy. Point your @planetscale/database SDK at proxy.shieldkey.io and use a shield token instead of your real API key. No code changes beyond the base URL and key.

Q: What happens to my PlanetScale key if a team member leaves?

Revoke their shield token instantly from the ShieldKey dashboard. Your real PlanetScale key stays active — no rotation, no downtime, no re-deploying secrets across services.

Before & After

See how ShieldKey protects your PlanetScale integration with minimal code changes.

Before — raw PlanetScale key

import { connect } from "@planetscale/database";

const conn = connect({
  host: "abc.us-east.psdb.cloud",
  username: "pscale_tkn_abc...",  // ← shared with team
  password: "pscale_pw_def..."
});

const results = await conn.execute("SELECT * FROM users");

After — ShieldKey proxy token

import { connect } from "@planetscale/database";

const conn = connect({
  host: "proxy.shieldkey.io",
  username: "sk_shield_t_4b8c...",  // ← revocable proxy token
  password: "managed-by-shieldkey"
});

const results = await conn.execute("SELECT * FROM users");

What ShieldKey Does for Your PlanetScale Keys

Instant Revocation

Disable any team member's access to your PlanetScale key in one click. No key rotation. No downtime. No re-deploying environment variables.

Spend Limits

Set per-token spend caps so a compromised token can't run up your PlanetScale bill. Get alerts before limits are hit.

IP Allowlisting

Restrict each shield token to specific IPs or CIDR ranges. Even if a token leaks, it's useless from unauthorized networks.

Full Audit Trail

See every API call made through your PlanetScale key — who made it, when, from where, and what they accessed.

Zero-Knowledge Encryption

Your PlanetScale key is encrypted with AES-256-GCM. It's only decrypted in memory during request proxying — never stored in plaintext.

Team Access Control

Issue individual shield tokens to each team member. When someone leaves, revoke their token — everyone else keeps working.

FAQ

How do I protect my PlanetScale API key?

Add your PlanetScale key to ShieldKey's encrypted vault. ShieldKey generates a proxy token (starting with sk_shield_t_) that your team uses instead. Your real pscale_ key stays encrypted and is never exposed to team members.

Can I use ShieldKey with the @planetscale/database SDK?

Yes. Point your @planetscale/database SDK at proxy.shieldkey.io and use a shield token instead of your real API key. The SDK works identically — ShieldKey transparently proxies every request.

What happens to my PlanetScale key if a team member leaves?

Revoke their shield token from the dashboard. Your real PlanetScale key stays active — no rotation, no downtime, no re-deploying secrets across services. Everyone else keeps working without interruption.

Does ShieldKey add latency to PlanetScale API calls?

ShieldKey's proxy adds less than 25ms at the p50. The proxy decrypts your key in memory, forwards the request, and streams the response back. For most PlanetScale API calls, this overhead is negligible.