Integrating with Microsoft Entra ID
You can integrate your ServiceNow instance with Microsoft Entra ID to view software usage for all connected SSO applications.
Important: Minimize security risks and protect information by granting access only to the necessary user or API permissions.
| Process | Required user role in the Microsoft Entra ID application | Authentication scopes |
|---|---|---|
| - Download users - Download groups - Download group memberships | Application developer | - User.Read.All - GroupMember.Read.All - Application.Read.All |
| Download applications | Application developer | - User.Read.All - GroupMember.Read.All - Application.Read.All |
| - Connect applications - Update connected applications | - Global reader/Reports reader/ Security/Administrator/Security operator/Security reader - Application developer | - AuditLog.Read.All - User.Read.All - GroupMember.Read.All - Application.Read.All |
| Reclaim subscriptions | User Administrator | User.ReadWrite.All |
Parent Topic:Integrate with SSO providers
Create a Microsoft Entra ID application
Create an app in the Microsoft Entra ID portal to integrate with the ServiceNow AI Platform.
Before you begin
Microsoft Entra ID Role required: Refer to the Minimal users permission table.
Procedure
From the Azure portal, access Microsoft Entra ID.
Create a Microsoft Entra ID application.
See Create a Microsoft Entra ID application for detailed instructions on registering and configuring an application.
In the Redirect URI field, enter
https://<instance-name>.service-now.com/oauth_redirect.do, where<instance-name>is the name of your ServiceNow instance.Record the application (client) ID and directory (tenant) ID to register the app as a third-party OAuth provider on your ServiceNow instance.
Create a client secret and save the correct value (not the Client secret ID) to register the app as a third-party OAuth provider on your ServiceNow instance.
Add permissions to access the Microsoft Graph API.
Permission Type AuditLog.Read.All Delegated or Application User.Read.All Delegated or Application User.ReadWrite.All Delegated or Application GroupMember.Read.All Delegated or Application Application.Read.All Delegated or Application For more information, see Add permissions to access web APIs.
Grant admin consent to your application.
For more information, see Understanding API permissions and admin consent UI.
Create a Microsoft Entra ID integration profile
Create a Microsoft Entra ID integration profile in your ServiceNow instance.
Before you begin
To create a Microsoft Entra ID integration profile, request the Software Asset Management - SaaS License Management plugin (sn_sam_saas_int) from the ServiceNow Store.
ServiceNow Role required: sam_integrator
Important: You must select the Microsoft Entra ID Spoke check box for this integration while installing optional features on the Application Manager page. For more information about choosing the required SaaS applications, see Request SaaS License Management.
About this task
Note: Starting with version 7.0.0 of Software Asset Management - SaaS License Management and version 3.1.0 of the Microsoft Entra ID spoke, your ServiceNow instance creates a separate Entra ID connection for each Microsoft Entra ID integration profile that you create. Each connection runs independently of each other, enabling your instance to support multiple independent Microsoft Entra ID integration profiles.
If you’re using Software Asset Workspace, the option to create the Microsoft Entra ID integration profile in Core UI is inactive.
Procedure
- Navigate to the integration profile.
| Interface | Action |
|---|---|
| Core UI |
|
| Software Asset Workspace |
|
In the Display name field, enter a name for the integration profile.
The remaining fields are automatically populated when you submit the form.
Note: The SSO integration is created using a directory integration. The directory integration pulls SSO applications, users, and group data that are associated with your SSO integrations. For more information, see Viewing SSO subscription information.
If you already have a Microsoft Entra ID directory integration, the SSO integration uses your existing directory integration. Otherwise, a Microsoft Entra ID directory integration is automatically created.
In the Process configuration section, view the required user roles or API permissions to minimize security risks and optimize SaaS licenses.
Note: For more information about the required roles and scopes, see Minimal user permissions table.
The Download applications, users, and groups check box is selected by default and you can't clear it.
The Download Activity check box is selected by default. If you clear it, the last activity for connected applications isn't pulled.
- The Reclaim subscriptions check box is selected by default. If you don't want to reclaim subscriptions, you can clear this check box. If you clear it, the removal candidates are created but the reclaim subscription subflow isn't triggered or the reclamation process isn't initiated.
Select Submit.
The Connection & Credential field appears.
Select the Create New Connection & Credential related link.
Note: If you have installed Software Asset Workspace, open the Connection and credential record and select the Create New Connection & Credential related link.
On the form, fill in the fields.
| Field | Value | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Permission type | The type of permission for the integration profile to access data correctly and securely. Values include:
| ||||||||||||||||
| Auth URL | `https://login.microsoftonline.com/| Token URL | `https://login.microsoftonline.com/ | Revoke token URL | `https://login.microsoftonline.com/ | OAuth Client ID | Application \(client\) ID for the application you created in the Azure portal. | OAuth Client Secret | Client secret for the application you created in the Azure portal. | OAuth Redirect URL | `https:// |
ResultAfter you publish the integration profile and connect applications to the profile, you can view events performed by individual users up to 60 days prior to the current date. For more information, see Review a software reclamation rule. Connect SSO appsConnect a Single Sign-On (SSO) app to view all users and groups with access to the app. Track user login data and reclaim unused licenses. Before you beginRole required: sam_integrator About this taskNote: For Microsoft Entra ID, the Assignment required toggle button on the application configuration page controls the access of the application by users.
SaaS License Management offers direct integrations with select applications. Direct integrations provide the most robust usage data. For a list of available direct integrations, see Integrate with SaaS applications. If you have a direct integration for an app, connecting the same app in an SSO integration creates duplicate subscription records in your ServiceNow instance. If you connect an SSO app and later decide to create a direct integration for that app, disconnect the app before creating a direct integration. Note: If you’re using Software Asset Workspace, the option to navigate to the SSO application in the Core UI is inactive. Procedure
ResultAfter the SSO application connects, your ServiceNow instance automatically creates users, groups, subscriptions, and reclamation rules that are refreshed daily.
What to do nextReview all automatically generated reclamation rules to meet your specifications for reclaiming user subscriptions. For more information, see Review a software reclamation rule. After connecting the SSO application, view information about the SSO profile in the Software Asset Workspace by navigating to License operations > User subscription > SSO integration profiles. You can select an integration profile to view the following related lists:
After creating an integration profile, you can define subscription exclusion rules to keep certain subscriptions from license cost calculations. For more information, see Subscription exclusions for SaaS and SSO applications. Create software entitlements for the automatically generated software models to track used software against owned software. For more information on creating software entitlements in the Software Asset Management classic application, see Create entitlements in Software Asset Management Core UI. For more information on creating software entitlements in the Software Asset Workspace, see Create entitlements in workspace. For more information on creating software entitlements using the Software Asset Management Playbook, see Create entitlements using the guided walk-through. Reconciliation also runs on your subscriptions as a scheduled job or on-demand. You can view your reconciliation results in the License Workbench (Software Asset Management classic application) or the License usage view (Software Asset Workspace). Use these results to determine your license compliance position and to remediate any non-compliance. For more information on running reconciliation in the Software Asset Management classic application, see Run software reconciliation in Software Asset Management classic. For more information on running reconciliation in the Software Asset Workspace, see Run software reconciliation in the workspace. |