Skip to main content

Bootstrap realm and service keys (Cloud)

This page describes the minimal Cloud setup so your backend can make service-to-service requests.

Prereqs​

  • Access to your Vluna Cloud console.
  • A secure place to store server-side secrets (secret manager preferred).

Outputs you need​

You need these values to integrate:

  • VLUNA_REALM_ID: your realm id.
  • VLUNA_SERVICE_KEY_ID: your service key id (server-side).
  • VLUNA_SERVICE_KEY_SECRET: your service key secret (server-side).
  • VLUNA_SERVICE_BASE_URL: base URL for /mgt/v1.
  • VLUNA_API_BASE_URL: base URL for /api/v1 (optional, if you call end-user APIs).

Steps​

  1. Create or select a realm in the Cloud console.
  2. Create a service key for that realm.
  3. Store the service key secret in your secret manager. Do not put it in browser, mobile, or other untrusted clients.
  4. Configure your backend with environment variables:
export VLUNA_REALM_ID='realm_example'
export VLUNA_SERVICE_KEY_ID='pk_example'
export VLUNA_SERVICE_KEY_SECRET='base64_example'
export VLUNA_SERVICE_BASE_URL='https://service.example.vluna.ai/mgt/v1'
export VLUNA_API_BASE_URL='https://api.example.vluna.ai/api/v1'

Use a two-key rollout:

  1. Create a new service key for the same realm.
  2. Deploy it to your backend in parallel with the old key.
  3. Verify integration health (see Verify installation and integration).
  4. Revoke the old key.

Next steps​