# Admin workspace

Purpose
- Centralize Authority-facing controls for tenants, roles, clients, tokens, integrations, and audit.

Access and dependencies
- Route: /console/admin with sub-routes for tenants, roles, users, clients, tokens, integrations, audit.
- Scopes: ui.admin plus authority:* scopes for each tab.
- Fresh-auth required for sensitive actions (revocations, key rotations, branding apply).
- Depends on Authority admin APIs, revocation exports, JWKS, and licensing posture endpoints.

Tenants
- Create, edit, suspend, resume, and delete tenants (delete is gated and audited).
- Tenant fields: slug, display name, status, isolation mode, default roles.
- Offline snapshots show latest snapshot timestamp and checksum.
- Export tenant bundle for air-gap distribution.
- CLI parity: stella auth tenant create, stella auth tenant suspend.

Roles and scopes
- Table lists roles with mapped scopes and audiences.
- Inline editor adds and removes scopes with validation and impact preview.
- Role bundle catalog covers console, scanner, scheduler, policy, graph, observability.
- CLI parity: stella auth role update.

Users and tokens
- User list includes roles, last login, and MFA status.
- Token inventory lists access, refresh, and device tokens with status.
- Token detail shows claims, sender constraint, issuance metadata, revocations.
- Revoke and bulk revoke actions require fresh-auth and log audit events.
- CLI parity: stella auth token revoke.

Integrations
- Client registrations list grant types, allowed scopes, DPoP or mTLS settings.
- Bootstrap bundles provide templates for new clients and users.
- External IdP connectors (SAML or OIDC) with metadata upload and test status.
- Licensing posture panel is read-only.
- Branding uploads are gated by fresh-auth.

Audit
- Timeline of admin events with filters (event type, actor, tenant, scope, correlation ID).
- Export CSV or JSON for SOC ingestion.
- Log pivot copies correlation ID search queries.

Fresh-auth flow
- Modal prompts for credential re-entry or hardware key touch.
- Fresh-auth window lasts five minutes; sensitive buttons disabled outside the window.
- Audit events recorded for fresh-auth start and success.

Security guardrails
- DPoP enforcement status and mTLS summaries for sensitive audiences.
- Token policy checks for TTL and refresh rotation.
- Revocation bundle export status with digest.
- Signing key rotation panel with current kid and last rotation time.

Offline behavior
- Offline banner disables direct writes; UI generates offline apply scripts.
- Token revocation and role changes produce bundles for offline Authority hosts.
- Audit exports default to local paths with checksum output.