Skip to content

Logging in & roles

Logging in

Open https://AMPORA_HOST and click Log in. You are bounced to your identity provider. After authentication you land on the Dashboard with your name and role in the top-right.

If the OIDC bounce loops without landing on the Dashboard, see Operator → Troubleshooting → OIDC.

Roles

Ampora has three roles. Your role is read from the OIDC claim configured by your operator (defaults to ampora:role).

Role What you can do What you cannot do
Viewer Browse Fleet, Configurations, Rollouts, Audit. Open agent details. No mutations
Operator Everything Viewer can, plus author configurations, manage groups, run rollouts No tenant settings, no policy edits, no PKI / token administration
Admin Everything Operator can, plus all settings, governance, PKI, identities, federation

The role badge appears next to your name. Buttons that need a higher role are visible but disabled with a tooltip explaining what is needed.

First user becomes Admin

The first user to log in to a brand-new Ampora is bootstrapped as Admin regardless of OIDC claim. After that, the role from the claim takes over. This is by design — it lets you log in once with a pre-configured account, set up the OIDC role mapping, and have it apply on the second login.

Switching tenants

If your account has access to more than one tenant (multi-tenant deployments only):

  • User menu → Switch tenant.
  • Pick the tenant from the list.
  • The page reloads with that tenant active.

The active tenant is shown next to your name. Cross-tenant data is never mixed in any view; the URL also encodes the tenant so deep links remain unambiguous.

Logging out

User menu → Log out. You are bounced through the IdP's logout endpoint, then back to the Ampora login page. Single sign-out clears the IdP session as well; if you only want to leave Ampora and stay logged in to the IdP, close the browser tab instead.

Keyboard shortcuts

Shortcut Action
/ Focus the global search
? Show the shortcut cheat sheet
g then f Go to Fleet
g then c Go to Configurations
g then r Go to Rollouts
g then a Go to Audit log
Esc Close any modal