Microsoft (Public) OpenID Setup

Warning

Be mindful when configuring OpenID providers that are public. Any user that can successfully authenticate with the provider will have access to your deployment of Kasm Workspaces. While access to Kasm Workspace apps and desktops can be resitricted with Kasm group permissions, any user of the public authentication provider would still be able to login to your deployment of Kasm. It is recommended to use a private OpenID provider unless your intention is to allow authentictioned access to all users of the OpenID platform provider.

This guide walks through a basic setup allowing Microsoft users to authenticate with your Kasm deployment.

Reference Docs:

• https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app

• https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols

Creating a Microsoft OAuth App

1. Login to the Microsoft Azure Portal: https://portal.azure.com/

2. Select Azure Active Directory.

Azure Active Directory

3. Select App Registrations.

App Registration

4. Select New Registration.

5. Give the app a Name (e.g Kasm).

6. In the Supported account types select Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).

Warning

In this example, we walk through creating an integration where any Microsoft user can auth with the Kasm app. This is ideal for a public facing deployment. Other options are available for single-tenant and multi-tenant configurations.

Register App

7. On the next page, the Application (client) ID is shown, save this value as the Client ID to be used in the next section.

8. Select Add a certificate or secret next to Client credentials.

Client Credentials

9. Select the Client secrets tab, then slick New client secret.

10. Enter a description and expiration then click Add.

11. The credentials are shown, save the Value as the Client Secret to be used in the next section.

Client Secret

Kasm OpenID Config

1. Log into the Kasm UI as an administrator.

2. Select Access Management -> Authentication -> OpenID -> Add Config.

3. Update the form with the following entries, using the Client ID and Client Secret gathered in the previous section.

Property	Value
Display Name	Continue with Microsoft
Logo URL	https://www.microsoft.com/favicon.ico
Enabled	Checked
Auto Login	Unchecked
Hostname	<Empty>
Default	Checked
Client ID	<Client ID From Microsoft OAuth App>
Client Secret	<Client Secret from Microsoft OAuth App>
Authorization URL	https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL	https://login.microsoftonline.com/common/oauth2/v2.0/token
User Info URL	https://graph.microsoft.com/oidc/userinfo
Scope	openid email profile
Username Attribute	email
Groups Attribute	Unchecked
Debug	Unchecked

Kasm OIDC Configurations

6. Click Save to save the changes.

Microsoft Login Test

1. Logout of the Kasm to display the login screen. The OpenID configuration should be shown.

Login Screen

2. Click Continue with Microsoft

3. The user is redirected to Microsoft for auth.

Microsoft Auth

4. Upon completion, the user is logged into the Kasm app.