Management Web¶
Management Web is the OpenIdentityStack operator UI. It is the only supported frontend for interactive administration.
Current parity scope¶
Management Web now covers the retained operator domains:
- Overview
- Users
- Roles
- Groups
- Applications
- Permissions
- Sessions
- Identity providers
- Settings
- Audit
The navigation intentionally excludes Clients and Service Accounts. Application-like administration is consolidated into Applications and uses /api/admin/applications.
Operator access¶
- Local Aspire resource:
managementweb - Local development port:
http://localhost:5175 - OIDC client ID:
management-web-client - Admin API authority and base URL are supplied by the AppHost during local runs.
Operators land on Overview, which summarizes available sections from their concrete permission grants and provides quick links to the retained domains.
Audit¶
Audit is read-only in Management Web v1. Operators with audit-logs:read can open /audit-entries, page through newest-first audit records, filter by date range, user id, action, entity type, entity id, and search text, and expand a row to inspect details, beforeState, and afterState.
The UI uses GET /api/admin/audit-entries; there is no Management Web audit write endpoint.
Authorization¶
Management Web uses shared permission helpers for route and action gates, but backend authorization remains authoritative. After sign-in, the frontend treats the access token as opaque and calls GET /api/me to obtain the current user's effective permission snapshot from the validated API principal. Role names such as admin or super-admin are not treated as frontend wildcard grants.
Access-token encryption remains enabled by default in Production. Management Web must continue to function when the access token cannot be decoded by JavaScript, including encrypted JWT/JWE and future reference-token forms.
Appearance¶
Operators can choose light, dark, or system appearance. The preference is stored only in browser local storage under openidentitystack.management.theme.
Runtime posture¶
Management Web is the only frontend resource started by the local AppHost. Backend authorization remains authoritative. If you need a backend-only local run, set OPENIDENTITYSTACK_ENABLE_MANAGEMENTWEB=false.
The frontend continues to exclude Clients and Service Accounts. Application-like administration is consolidated into Applications and uses /api/admin/applications.