This guide will walk you through registering and configuring the Smart.pr application in Microsoft Entra. Along the way, we will collect the configuration details to be shared with Smart.pr.
Note: We support OpenID Connect (OIDC). If OIDC is not an option, ask us about SAML.
Access Microsoft Entra
Log in to the Microsoft Entra admin center
Register an application
Navigate to Applications > App registrations
Click on "New registration".
Give the application a name, e.g.
Smart.prFill in the Redirect URI
Platform: Web
Additional resources:
Once the application has been registered, we can continue to configure it.
Configure Authentication
Our OIDC client supports both client secret and certificate authentication. We'll describe the client secret method here as it is more common:
Select the Smart.pr app registration (if not already selected).
Navigate to Certificates & secrets under the Manage heading.
Select the Client secrets tab.
Then select New client secret.
Key in a name, e.g., "Smart.pr".
Choose an expiration date; we recommend 24 months.
Now that the secret has been created, copy the client secret somewhere for sharing with Smart.pr.
Additional resources:
OIDC Metadata URL
The final piece of configuration we require is the OpenID Connect metadata document URL. This URL provides us with all the relevant configuration needed to communicate with Entra.
Select the Smart.pr app registration (if not already selected)
Navigate to Overview
Select Endpoints
Scroll down until you find the item: OpenID Connect metadata document
Copy the URL somewhere for sharing with Smart.pr
Share Collected Config Details
Once the application has been registered and configured, please share with us the following details:
The email domain you will be using to sign in, e.g.,
example.com.Client secret (if using client secret) - from above.
OIDC metadata document URL - from above.
Once we have the configuration details, we can complete the registration on our side. We'll notify you when the configuration is complete. All that remains is a quick test to make sure everything is working as expected.
Sign in with SSO
Navigate to https://api.smart.pr/sso/signin.
Key in your work email, e.g., user@example.com.
You should be redirected to the MS Entra login portal.
Sign in using your organization credentials.
On signing in, you should be redirected back to the Smart.pr app.
