Login Pages
Not available in Community Edition.
Login pages allow you to create dashboards that require authentication to access. You can define your own authentication endpoint to perform the authentication yourself or use a third party OAuth provider to do so. To create your login page, you can use the New-UDLoginPage and LoginPage parameter of New-UDDashboard.
$Dashboard = New-UDDashboard -LoginPage $LoginPage -Page @(
$MyDashboardPage
)
You can use one or more authentication methods for a login page. UD currently supports the following authentication methods.
To specify an authentication method for a login page, use the
New-UDAuthenticationMethod cmdlet. $AuthenticationMethod = New-UDAuthenticationMethod -Endpoint {
param([PSCredential]$Credentials)
if ($Credentials.UserName -eq "Adam" -and $Credentials.GetNetworkCredential().Password -eq "SuperSecretPassword") {
New-UDAuthenticationResult -Success -UserName "Adam"
}
New-UDAuthenticationResult -ErrorMessage "You aren't Adam!!!"
}
$LoginPage = New-UDLoginPage -AuthenticationMethod $AuthenticationMethod
To specify multiple authentication methods, just pass an array of authentication methods to the
New-UDLoginPage cmdlet.$AuthenticationMethod = @()
$AuthenticationMethod += New-UDAuthenticationMethod -AppId 1234 -AppSecret Abc123 -Provider Facebook
$AuthenticationMethod += New-UDAuthenticationMethod -AppId 1234 -AppSecret Abc123 -Provider Twitter
$AuthenticationMethod += New-UDAuthenticationMethod -AppId 1234 -AppSecret Abc123 -Provider Google
$AuthenticationMethod += New-UDAuthenticationMethod -AppId 1234 -AppSecret Abc123 -Provider Microsoft
$AuthenticationMethod += New-UDAuthenticationMethod -Endpoint {
}
$LoginPage = New-UDLoginPage -AuthenticationMethod $AuthenticationMethod
There are several aspects of the login page you can customize to meet your branding and color preferences.
- Logo - Use New-UDImage to specify the logo you wish to show above the login dialog.
- PageBackgroundColor - The background color of the page. This can be any hex color.
- LoginFormBackgroundColor - The background color of the login form. This can be any hex color.
- LoginFormFontColor - The font color of the login form. This can be any hex color.
- LoadingText - The loading text to show while authentication is in progress
In any Endpoint script block, you can access the user name. This means that Charts, Dynamic Pages, Tables and other controls can access the $User variable to get the current logged in user name.
Last modified 3yr ago