Enable SSO
Create a new App registration on Azure for SSO
-
Go to the Azure portal → Microsoft Entra ID.
-
Make sure you are in the correct subscription.
-
From Overview, expand Manage from the top navigation and click App registration.
-
Register a new application by clicking New Registration:
- For the name use Penfield SSO or anything else that follows your standard
- For Supported account types, choose "Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)"
- Under the Redirect URI (optional Select the Web application type using the dropdown menu
- Provide the Redirect URI:
https://<**FQDN for Penfield App**>/public/self-service/methods/oidc/callback/microsoft
- Click Register.
For reference:
-
Inside the registered App, expand Manage and click Branding & Properties.
-
Scroll down to Publisher verification section and click on Add MPN ID to verify publisher. Use
5457809
as MPN ID and check the boxBy proceeding, you agree to the Microsoft Platform Policies
and click Verify and save. This should verify the publisher. -
Go to Certificates & secrets and create a new client secret and copy the value of the client secret, you will need this value later on.
-
Go to App roles , Create multiple roles as below by clicking on Create app role and click Apply.
NOTE: Make sure the Value is in all lowercase.
Display names Allowed member types Value Description Admin Users/Groups admin Admin role for Penfield App Analyst Users/Groups analyst Analyst role for Penfield App Automation Users/Groups automation Automation role for Penfield App -
Go to Overview tab and copy the followings, you will need these later:
- Application (client) ID
- Directory (tenant) ID
Update the Enterprise application
- Under Microsoft Entra ID, Select Enterprise applications.
- Search using the Application name that you set up above.
- Select the application.
- Expand the Manage section and choose Properties
- Toggle the Assignment required? to Yes.
- Save the configuration.
- Go to Users and Groups and Click Add user/group
- Select the appropriate users or group (However you want to manage, Recommendation is manage using groups) and corresponding role that you want to assign. You may want to create User Group in advance if you want to leverage groups.
- Once selected click on Assign
- Repeat above two steps for assigning multiple users/groups to corresponding roles.
Update Penfield app configuration (Kratos)
-
Make sure you have these values: CLIENT_ID (Application ID) TENANT_ID (Directory ID) CLIENT_SECRET
-
To enable SSO in penfield-app, run the below command from the root of Github repo that you have cloned previously and follow the instructions.
enable SSO./run.sh -c