Overview
Patrowl supports Single Sign-On through OpenID Connect (OIDC). Once SSO is enabled, your users sign in to Patrowl with their Microsoft account and you manage access centrally from Microsoft Entra ID (formerly Azure Active Directory).
Setup takes about 15 minutes and has five steps:
Register Patrowl as an application in Microsoft Entra ID.
Check the authentication platform.
Create a client secret.
Copy the OpenID Connect metadata document URL.
Send these values to Patrowl securely.
Patrowl then completes the configuration on its side.
Before you start
Make sure you have:
Access to the Azure portal with permission to register applications in Microsoft Entra ID (for example, the Application Administrator role).
The Redirect URI provided by Patrowl. If you don't have it yet, ask your Patrowl Customer Success Manager.
💡 Tip: keep a text editor open while you follow this guide. You'll copy three values along the way and send them to Patrowl at the end.
Step 1: Register the application
Sign in to the Azure portal.
Search for and select Microsoft Entra ID.
Under Manage, select App registrations.
Select New registration.
In Name, enter a name your users will recognize, for example
Patrowl.Under Supported account types, select the option that matches your organization's requirements. Most organizations choose Accounts in this organizational directory only.
Under Redirect URI, select Web as the platform, then paste the Redirect URI provided by Patrowl.
Select Register.
On the application's Overview page, copy the Application (client) ID.
Patrowl needs the Application (client) ID to configure OIDC.
Step 2: Check the authentication platform
Under Manage, select Authentication.
Under Platform configurations, check that a Web platform is listed with the Patrowl Redirect URI.
If no Web platform is listed, select Add a platform, choose Web, paste the Redirect URI provided by Patrowl, then select Configure.
⚠️ Important: the Redirect URI must match the one provided by Patrowl exactly. Check for typos, extra spaces, and trailing slashes.
Step 3: Create a client secret
Under Manage, go to Certificates & secrets.
On the Client secrets tab, select New client secret.
Enter a description, for example
Patrowl SSO.Choose an expiration period, or set a custom lifetime.
Select Add.
Copy the secret's Value right away.
Patrowl needs this value to configure OIDC.
⚠️ Important: Microsoft shows the secret value only once. If you leave the page without copying it, you'll need to create a new secret. Copy the Value column, not the Secret ID.
🔒 Security: the client secret works like a password. Never share it in plain text, in a support chat, or in an unencrypted email.
Step 4: Copy the OpenID Connect metadata document URL
Go back to your application's Overview page.
Select Endpoints.
Copy the OpenID Connect metadata document URL.
Patrowl needs this value to configure OIDC.
Step 5: Send the information to Patrowl securely
You now have the three values Patrowl needs:
Application (client) ID
Client secret value
OpenID Connect metadata document URL
To send them securely:
Create a
.txtfile that contains the three values.Compress the file into a password-protected ZIP archive.
Email the ZIP file to your Patrowl Customer Success Manager.
Send the ZIP password by SMS.
🔒 Why two channels? Sending the file and the password separately means that if one channel is compromised, your credentials stay protected.
What happens next
When Patrowl receives your information, the team configures SSO on your account and lets you know when it's active. Your users can then sign in to Patrowl with their Microsoft account.
We recommend testing the sign-in with one user before rolling it out to the whole team.
Troubleshooting
SSO suddenly stopped working
Your client secret has probably expired. In Certificates & secrets, check its expiration date. If it has expired, create a new secret and send it to Patrowl using the secure method in Step 5. We recommend setting a calendar reminder before the expiration date.
I get a "redirect URI mismatch" error (AADSTS50011)
The Redirect URI in Microsoft Entra ID doesn't exactly match the one provided by Patrowl. Compare them character by character, and check that it's registered under the Web platform.
I didn't copy the secret value in time
Microsoft doesn't show it again. Delete the old secret, create a new one, and copy its Value immediately.
I can't register a new application
You need permission to register applications in Microsoft Entra ID. Ask your Microsoft administrator to grant you access or to complete the registration for you.
Need help?
If you have a question about this setup, contact your Patrowl Customer Success Manager or start a conversation with us from the chat.
