Skip to content

Authentication

Ghaymah has two ways to authenticate: the dashboard (browser session) and the REST API (bearer tokens). Both use the same account.

Open deploy.ghaymah.systems. If you’re not signed in, you’ll see the login page:

Ghaymah web login page
Sign in at deploy.ghaymah.systems.

New here? Click Create an account, fill in your details, and you’re in:

Ghaymah web signup page
New here? Click “Create an account”.

Creating an account takes less than a minute and gives you a free server to start with (see Billing).

The REST API uses a bearer token on every request:

Authorization: Bearer <token>

Tokens are scoped to one or more projects via an OPA policy, so a token can only touch the resources it’s allowed to.

Terminal window
# 1. Create a project (admin scope) — returns an id and an initial token
curl -X POST https://api.cumin.dev/projects \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "my-project" }'
# { "id": "…", "token": "…" }
# 2. (Optional) mint an additional scoped token for a project
curl -X POST https://api.cumin.dev/tokens \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "ci-token", "policy": "<opa-policy>" }'
# { "bearer_token": "…", "token": { "id": "…", … } }

Use the returned token for all subsequent requests. See the REST API overview for the full token model.