Role Based Access
Role based access for dashboards.
This feature requires a license.

Dashboard Roles

When dashboard authentication is enabled, you can define the role that a user must be a part of in order to access the dashboard. Roles are configured on the Settings Security page or from within the roles.ps1 configuration file.
If a user attempts to visit a dashboard that they do not have access to, they will be presented with a Not Authorized page.

Pages Roles

You can also show or hide pages based on roles. To define a role for a page, use the -Role parameter of New-UDPage. Only users of the specified role will have access to this page.
1
New-UDPage -Role 'Administrators' -Content {
2
New-UDTypography -Text 'Admins only'
3
}
Copied!

$Roles Variable

In addition to dashboard and page roles, you can also check with roles a user is a part of by using the $Roles variable that is available within Dashboards. This variable contains an array of the roles that are assigned to the user.
For example, you could show the Restart-Computer button to only Administrators.
1
if ($Roles -contains "Administrator") {
2
New-UDButton -Text 'Restart Server' -OnClick {
3
Restart-Computer
4
}
5
}
Copied!
Last modified 7mo ago