{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":26270,"path":"it-asset-management/software-asset-management/update-o365-gov-plans.md","title":"Update REST and OAuth endpoints for Microsoft Office 365 Government plans","bundle":null,"doc_type":null,"release":"australia","body":"\n# Update REST and OAuth endpoints for Microsoft Office 365 Government plans\n\nChange the endpoints of the REST message and OAuth application on your ServiceNow subscription profile so that you can use your subscriptions.\n\n## Before you begin\n\nRole required: sam\\_admin\n\n## About this task\n\nThe ServiceNow AI Platform® supports Microsoft Office 365 Government plans, which provide all the features and capabilities of Microsoft 365 services in a segmented government cloud community that enables organizations to meet U.S. compliance and security standards.\n\nFor more information on Microsoft Office 365 Government plans, see [Office 365 Government](https://docs.microsoft.com/en-us/office365/servicedescriptions/office-365-platform-service-description/office-365-us-government/office-365-us-government).\n\n**Important:** The Software Asset Management application supports tracking last activity for license compliance, subscription management, and optimization recommendations for Microsoft products such as Exchange Online, Teams, Power BI, OneDrive, and so on. For more details, see [Evaluating software usage activity for Microsoft 365 subscriptions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-asset-management/software-asset-management/o365-usage-activity.md).\n\nThe detailed usage metrics for these Microsoft products \\(except Power BI\\) are only available through specific report APIs that aren't supported in government-regulated environments. For further details, refer to the [Microsoft national cloud deployments documentation](https://learn.microsoft.com/en-us/graph/api/reportroot-getm365appuserdetail?view=graph-rest-1.0&tabs=http).\n\n## Procedure\n\n1.  From your ServiceNow instance, navigate to **All** > **Software Asset** > **SaaS License** > **Direct Integration Profiles**.\n\n2.  Select the Microsoft 365 integration profile that you want to update.\n\n3.  On the Integration Profile record, select the Preview this record icon \\[Omitted image \"preview-icon.png\"\\]next to the **REST message** field.\n\n4.  On the record preview, select **Open Record**.\n\n    The REST Message record opens.\n\n5.  Update the REST message endpoints on your Microsoft 365 integration profile.\n\n    REST message endpoints enable you to retrieve usage data from your Microsoft 365 applications and services.\n\n    1.  In the **HTTP Methods** related list, update the REST message endpoints based on your needs.\n\n        Microsoft provides various endpoints for Microsoft Office 365 Government plans. For more information on the available endpoints, see [Office 365 U.S. Government GCC High endpoints](https://docs.microsoft.com/en-us/microsoft-365/enterprise/microsoft-365-u-s-government-gcc-high-endpoints?view=o365-worldwide).\n\n        **Important:** You must change the `.com` to `.us` in the URL of each endpoint. For example, for Microsoft Graph API you must change `https://graph.microsoft.com/v1.0/reports` to `https://graph.microsoft.us/v1.0/reports`. For Get PowerBI Usage API, you must change `https://api.powerbi.com/v1.0/myorg/admin/activityevents` to `https://api.powerbigov.us/v1.0/myorg/admin/activityevents`.\n\n    2.  Select **Save**.\n\n    3.  Update the OAuth entity scope for the **GET PowerBI Usage** endpoint.\n\n        The OAuth entity scope specifies the level of access that users have to your protected resources.\n\n        1.  Select the **GET PowerBI Usage** endpoint.\n\n            The HTTP Method record opens.\n\n        2.  In the Authentication section of the HTTP Method record, select the Preview this record icon \\[Omitted image \"preview-icon.png\"\\] next to the **OAuth profile** field.\n        3.  On the record preview, select **Open Record**.\n\n            The OAuth Entity Profile record opens.\n\n        4.  In the OAuth Entity Profile Scopes list, update the **OAuth scope** field of the **PowerBIPermissions** OAuth entity scope with the backend API URL that you’re using for Microsoft Power BI.\n\n            **Note:** Microsoft supports various backend API URLs for Power BI. For more information on the available URLs, see [Power BI for US Government](https://learn.microsoft.com/en-us/power-bi/enterprise/service-govus-overview).\n\n        5.  Select **Update**.\n\n            The OAuth Entity Profile record closes and you automatically return to the REST Message record.\n\n6.  Update the OAuth application endpoint on your Microsoft 365 integration profile.\n\n    The OAuth application endpoint enables your ServiceNow instance to access your Microsoft 365 subscription data.\n\n    1.  In the Authentication section of the REST Message record, select the Preview this record icon \\[Omitted image \"preview-icon.png\"\\] next to the **OAuth profile** field.\n\n    2.  On the record preview, select **Open Record**.\n\n        The OAuth Entity Profile record opens.\n\n    3.  In the OAuth Entity Profile Scopes list, change the `.com` to `.us` in the URL that is listed in the **OAuth scope** field of the **Permissions** OAuth entity scope.\n\n    4.  Select the Preview this record icon \\[Omitted image \"preview-icon.png\"\\] next to the **OAuth provider** field.\n\n    5.  On the record preview, select **Open Record**.\n\n        The Application Registries record opens.\n\n    6.  Select the Edit URL icon \\[Omitted image \"lock-outline-24.svg\"\\] next to the **Token URL** field.\n\n    7.  In the URL, change the `.com` to `.us`.\n\n        For example, change `https://login.microsoftonline.com` to `https://login.microsoftonline.us`.\n\n    8.  Select the Lock URL icon \\[Omitted image \"unlock-outline-24.svg\"\\].\n\n    9.  Select **Update**.\n\n\n## What to do next\n\nRevalidate the connection and credential details of this integration. For more information, see [Create a Microsoft 365 integration profile](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-asset-management/software-asset-management/set-up-microsoft-office-365.md).\n\n"}}