How to manage users and API tokens

Type: How-to · Audience: Admin

Overview

Create users, assign roles, and generate API tokens for programmatic access.

Roles

Steps

1. Create a user:

   curl -X POST $SERVER/api/v1/users \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"metadata":{"name":"alice"},"spec":{"role":"edit","password":"secret123"}}'
   

2. Create an API token for programmatic access:

   curl -X POST $SERVER/api/v1/users/alice/tokens \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"metadata":{"name":"ci-token"},"spec":{"expiresIn":"8760h"}}'
   

3. Use the token:

   export REZUSCLOUD_TOKEN="<token-value>"
   rezusctl get clusters --server $SERVER
   

See also

• Auth ADR