Admin Portal
The Admin Portal is a hosted experience that can surface a combination of user-facing and admin-facing widgets, including the User Profile Widget, the Applications Portal Widget, and admin capabilities from Admin Widgets such as user management, role management, and access key management.
Self-service SSO for your customers
To let tenant admins configure their own SSO/SCIM connection, use the SSO Setup Suite, the self-service configuration experience. New to SSO? See Getting Started with SSO.
Admin Portal Settings
In the Descope Console, go to Widgets and open the Admin Portal tab. This page is where you define what the hosted portal contains and how it behaves. You can also manage enablement, style, and the widget list with Terraform — see Terraform → Admin Portal.
Admin Portal is tenant-scoped, so the user or an admin needs to be part of a tenant and authenticated to access the portal.
The portal is styled and branded according to your project's styling and branding configuration. You can also customize the title of the portal.
- URL: Shows the hosted portal link that you can share or embed.
- Widgets to host in the portal: Controls which widgets appear in the left navigation, and the order selected here determines the order in the portal menu.
- Sign-In flow: Determines which flow is used when a user is redirected to authenticate for the portal.
- Style: Applies the selected style and theme configuration.
- Portal title: Sets the title shown in the hosted portal experience.
Note
You can disable the Admin Portal, which will make the admin portal URL inaccessible, and prevent users from accessing the portal. You can re-enable it at any time.
What Users See in the Hosted Admin Portal
The hosted portal presents a left-side navigation with the widgets you configured, and a main content area for the selected widget.
For example, a tenant admin may see user management, role management, access key management, audit logs, applications portal, user profile, and tenant profile, depending on enabled widgets and role permissions.
Even when a widget is listed in the portal configuration, users only see actions they are authorized to perform. This makes the portal suitable for mixed audiences where different admins have different permission scopes.
Selecting a Tenant
The Admin Portal is tenant-scoped. If a user belongs to more than one tenant, they must select an organization from the Select an Organization page before accessing the portal.
After the user selects a tenant, everything in the portal is scoped to that tenant.
Users who belong to only a single tenant skip this page and are taken directly into the portal.
To switch to a different tenant after making a selection, users can open the profile menu and select Switch Organization.