Skip to content

Commit 34fe9c8

Browse files
Merge branch 'main' into dle-working-m365-july25
2 parents d67da9b + 9f37657 commit 34fe9c8

8 files changed

Lines changed: 287 additions & 131 deletions

File tree

copilot/employee-self-service/servicenow-hrsd-itsm.md

Lines changed: 85 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Refer to the ESS Agent deployment guide for installation of the agent and subscr
7373
| **Application Developer** (*minimum privileged role*) | User who can register an application | Create an App registration - *if using Microsoft Entra OAuth for ServiceNow connector* | Microsoft 365 Admin Center |
7474
| **Environment Maker** | User who can customize ESS Agent | Configure & Customize ESS Agent | Microsoft Copilot Studio |
7575

76-
### ServiceNow configuration
76+
## ServiceNow configuration
7777

7878
This section outlines the tasks required to be configured in ServiceNow by an administrator. ServiceNow integration supports three types of authentications as follows:
7979

@@ -88,7 +88,86 @@ This section outlines the tasks required to be configured in ServiceNow by an ad
8888
> [!TIP]
8989
> Without elevating access, the new security objects can't be created. If **New** button in the top right of configuration pane is missing, then the role isn't elevated to "`security_admin`”.
9090
91-
#### Option 1: Using OAuth2 authentication - Create an OAuth Application Registry
91+
### Basic authentication
92+
93+
This method of authentication involves a ServiceNow username and password to authenticate API requests. This method is simple to use and is primarily suggested for testing purposes, as it offers lower security compared to other authentication methods.
94+
95+
### Microsoft EntraID OAuth using Certificate
96+
97+
This authentication uses app tokens, allowing a registered Entra ID application to access ServiceNow with a token specifying the ServiceNow Entra ID app as the resource.
98+
99+
#### Task 1: Register an application in Microsoft Entra ID for OIDC integration with ServiceNow
100+
101+
[Learn how to register an app in Microsoft Entra ID.](/entra/identity-platform/quickstart-register-app)
102+
103+
1. Sign into the Microsoft Entra admin portal as a global administrator or cloud app administrator.
104+
1. Go to **Applications** then **App registrations**.
105+
1. Select **New registration.**
106+
1. In the new registration form, fill in the following fields:
107+
1. **Name:** Any name that represents the purpose of app registratio
108+
1. **Redirect URL:** Not needed
109+
1. Choose **Register** to complete the creation of the new app registration.
110+
1. Select **Token configuration** then **Add optional claim** for adding claims setting.
111+
1. Select **Token type** as **Access** and choose the following claims:
112+
1. *aud* - for audience validation
113+
1. *email* - addressable email for user
114+
1. *upn* - an identifier for the user
115+
1. Select **Add** to complete adding the claims.
116+
1. If this is the first time OpenId Connect being setup using claims like email, upn, there’ll be a confirmation to turn on the Microsoft Graph permissions, please check the box and select **Add**.
117+
1. This flow completes the Microsoft Entra piece of configuration.
118+
119+
#### Task 2: Register OIDC provider in ServiceNow
120+
121+
1. Login to the ServiceNow instance that needs to be integrated with ESS Agent.
122+
1. Elevate access permissions using **Elevate role**. Refer to the section **Error! Reference source not found.** – only the first part and not the tasks.
123+
1. Click **All** in the top navigation bar.
124+
1. Search for “OAuth” in the search box within dropdown navigation menu.
125+
1. Select **System OAuth à Application Registry** from the search results (if you don’t see this option, then you don’t have sufficient privileges).
126+
1. Select **New** in the configuration section pane.
127+
1. Select **Configure an OIDC provider to verify ID tokens**.
128+
1. Fill in the following information for the new application registry:
129+
130+
|Configuration |Description |
131+
|--------------|------------|
132+
|Name |a meaningful name to identify that this OIDC provider was created for ESS Agent |
133+
|Client ID |The client ID of Entra Application created in Task 1 above |
134+
|Client secret |This value will not be used; can be any value |
135+
|OAuth OIDC provider configuration |Add a new OIDC provider configuration by selecting the search icon and choosing **New** in the search popup. Fill in the fields as follows:</br> **OIDC Provider:** A name that represents the Microsoft Entra tenant from task 1 above.</br> **OIDC Metadata URL:** `login.microsoftonline.com/<tenant ID>/.well-known/openid-configuration`</br> Replace < tenant ID > with the Entra tenant ID from task 1 above.</br> **OIDC Configuration Cache Life Span:** 120</br> **Application:** Global</br> **User Claim:** oid</br> **User Field:** User ID</br> **Enable JTI claim verification:** disabled</br> Select **Submit** and update the OIDC Entity form. |
136+
137+
#### Task 3: Register an Application in Microsoft Entra ID for connector usage
138+
139+
This is the application which plays the role of a user with elevated permissions in the ServiceNow instance.
140+
141+
1. Login to Entra administration portal as global administrator (or) cloud app administrator.
142+
1. Go to **Applications** > **App registrations**.
143+
1. Select **New registration**.
144+
1. In the new registration form, fill in the following fields:.
145+
1. **Name:** any name that represents the purpose of app registration.
146+
2. **Redirect URI:** Not needed.
147+
1. Click **Register** to complete the creation of new app registration.
148+
1. Select **Certificates & secrets** then upload the .cer file of the certificate. In case of SNI certificate, just add trustedCertificateSubjects in the manifest of the application with the relevant authorityId and subjectName.
149+
150+
#### Task 4: Create a System User in ServiceNow
151+
152+
This is the Application created in the above task 3 which is a user in ServiceNow instance.
153+
154+
Go to **User Administration** > **Users** to create a new user.
155+
156+
**User ID:** The object ID of the service principal of Application created in Task 3 above.
157+
158+
Check **Web service access only**.
159+
160+
### Microsoft Entra ID OAuth User Login
161+
162+
This is user-token based authentication where the end user can sign into Entra ID 1st party application i.e. ServiceNow connector 1st party app and get an access token with scope for the ServiceNow representative Entra ID app.
163+
164+
Perform Task 1 & Task 2 from the previous section Microsoft Entra ID OAuth using Certificate.
165+
166+
In the Task 1 – add the 1st party application i.e., ServiceNow connector to the permission scope – Client ID = c26b24aa-7874-4e06-ad55-7d06b1f79b63.
167+
168+
In the Task 2 – update the user claim to upn or any other custom claim property from the token in ServiceNow. The user field should match the ServiceNow system user table field containing the upn or user ID.
169+
170+
### Using OAuth2 authentication - Create an OAuth Application Registry
92171

93172
1. Log in to the ServiceNow instance that needs to be integrated with ESS Agent.
94173
2. Elevate access permissions using **Elevate role**.
@@ -104,7 +183,7 @@ This section outlines the tasks required to be configured in ServiceNow by an ad
104183
| **Name** | a meaningful name to identify that this application registry is created for ESS Agent |
105184
| **Client ID** | autogenerated code <br><div class="alert">**Note**</br>This value is used in Microsoft 365 Copilot Connector configuration, if no Advanced Scripting is used. |
106185
| **Client Secret** | leave it blank to automatically generate a string <br><div class="alert">**Note**</br>This value is used in Microsoft 365 Copilot Connector configuration, if no Advanced Scripting is used. |
107-
| **Redirect URL** | a required callback URL that the authorization server redirects to </br>For Microsoft 365 Enterprise:</br>`https://gcs.office.com/v1.0/admin/oauth/callback`</br>For Microsoft 365 Government:</br>`https://gcsgcc.office.com/v1.0/admin/oauth/callback`|
186+
| **Redirect URL** | a required callback URL that the authorization server redirects to </br>For Microsoft 365 Enterprise:</br>`https://gcs.office.com/v1.0/admin/oauth/callback`</br>For Microsoft 365 Government:</br>`https://gcsgcc.office.com/v1.0/admin/oauth/callback` Refer to the note after the table for more information.|
108187
| **Logo URL** | A URL that contains the image for the application logo |
109188
| **Active** | Set to active |
110189
| **Refresh token lifespan** | The number of seconds that a refresh token is valid. </br>By default, refresh tokens expire in 100 days (8,640,000 seconds). Recommended value is 31,536,000 (one year) |
@@ -113,6 +192,9 @@ This section outlines the tasks required to be configured in ServiceNow by an ad
113192
| **Accessible from** | All application scopes |
114193
| **Client Type** | Integration as a Service |
115194

195+
>[!NOTE]
196+
>[Please use the actual callback URL from the sign-in popup window during connection configuration by following the steps below, when the URL redirection fails with the error **Invalid redirect_uri**:</br> Copy/paste the complete URL from the authorization popup window</br> Extract redirect_uri parameter.</br> Example: `redirect_uri=https%3a%2f%2ftip1-shared.consent.azure-apim.net%2fredirect`</br> After decoding the URL – replacing %3a with : and %2f with /</br> Update the Redirect URL field.]
197+
116198
9. Select **Submit** or **Update** button to save the changes.
117199

118200
### Install ServiceNow HRSD extension pack

microsoft-365/lti/TOC.yml

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ items:
77
href: browser-cookies.md
88
- name: Canvas integrations
99
items:
10+
- name: Deploy Microsoft 365 LTI in Canvas
11+
href: microsoft-365-lti-canvas.md
1012
- name: Use Microsoft OneDrive LTI with Canvas
1113
href: onedrive-lti.md
1214
- name: Use Microsoft Teams Assignments with Canvas
1315
href: teams-assignments-with-canvas.md
14-
- name: Use Microsoft Teams classes with Canvas
16+
- name: Use Microsoft Teams with Canvas
1517
href: teams-classes-with-canvas.md
16-
- name: Use Microsoft Teams meetings with Canvas
17-
href: teams-meetings-with-canvas.md
1818
- name: Use Microsoft Reflect LTI with Canvas
1919
href: reflect-lti-canvas.md
2020
- name: Blackboard integrations
@@ -23,9 +23,7 @@ items:
2323
href: onedrive-lti-blackboard.md
2424
- name: Use Microsoft Teams Assignments with Blackboard
2525
href: teams-assignments-with-blackboard.md
26-
- name: Use Microsoft Teams meetings with Blackboard Learn
27-
href: teams-meetings-with-blackboard-learn.md
28-
- name: Use Microsoft Teams classes with Blackboard Learn Ultra
26+
- name: Use Microsoft Teams with Blackboard Learn Ultra
2927
href: teams-classes-with-blackboard.md
3028
- name: Use Microsoft Reflect LTI with Blackboard Learn
3129
href: reflect-lti-blackboard.md
@@ -35,24 +33,18 @@ items:
3533
href: moodle-plugin-configuration.md
3634
- name: Use Microsoft Teams Assignments with Moodle
3735
href: teams-assignments-with-moodle.md
38-
- name: Use Microsoft Teams classes and meetings with Moodle
39-
href: teams-classes-meetings-with-moodle.md
4036
- name: Use Microsoft Reflect LTI with Moodle
4137
href: reflect-lti-moodle.md
4238
- name: Open LMS integrations
4339
items:
4440
- name: Set up and configure the Moodle plugin for Open LMS
4541
href: open-lms-plugin-configuration.md
46-
- name: Use Microsoft Teams classes and meetings with Open LMS
47-
href: open-lms-teams-classes-and-meetings.md
4842
- name: D2L Brightspace integrations
4943
items:
5044
- name: Use Microsoft OneDrive LTI with Brightspace
5145
href: onedrive-lti-brightspace.md
5246
- name: Use Microsoft Teams Assignments with Brightspace
5347
href: teams-assignments-with-brightspace.md
54-
- name: Use Microsoft Teams classes and meetings with Brightspace
55-
href: teams-classes-meetings-with-brightspace.md
5648
- name: Use Microsoft Reflect LTI with D2L Brightspace
5749
href: reflect-lti-brightspace.md
5850
- name: Schoology Learning integrations
@@ -61,14 +53,10 @@ items:
6153
href: onedrive-lti-schoology.md
6254
- name: Use Microsoft Teams Assignments with Schoology Learning
6355
href: teams-assignments-with-schoology.md
64-
- name: Use Microsoft Teams meetings with Schoology Learning
65-
href: teams-classes-and-meetings-with-schoology.md
6656
- name: Use Microsoft Reflect LTI with Schoology Learning
6757
href: reflect-lti-schoology.md
6858
- name: Other LMS integrations
6959
items:
70-
- name: Use Microsoft Teams Meetings LTI with any LTI 1.3 compliant LMS
71-
href: integrate-with-other-lms.md
7260
- name: Use Microsoft Teams Assignments LTI with any LTI 1.3 compliant LMS
7361
href: teams-assignments-with-other-lms.md
7462

microsoft-365/lti/index.md

Lines changed: 30 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
---
22
title: An overview of Microsoft LTI apps
3-
author: DaniEASmith
4-
ms.author: danismith
5-
manager: jacktremper
3+
author: jennplatt
4+
ms.author: avering
5+
manager: michal.gideoni
66
ms.reviewer: amitman, sovaish
7-
ms.date: 06/15/2021
7+
last.review.by:
8+
last.review.date: 06/15/2021
9+
ms.date: 07/10/2025
810
audience: admin
911
ms.topic: concept-article
1012
ms.service: msteams
@@ -14,7 +16,7 @@ ms.collection:
1416
- M365-modern-desktop
1517
- tier2
1618
ms.localizationpriority: medium
17-
description: Learn about Learning Tools Interoperability (LTI) Microsoft apps, and how they will help educators when integrating Microsoft apps into their Learning Management System (LMS).
19+
description: Learn about Learning Tools Interoperability (LTI) Microsoft apps, and how they help educators when integrating Microsoft apps into their Learning Management System (LMS).
1820
---
1921

2022
# Integrating Microsoft products with your Learning Management System (LMS)
@@ -27,36 +29,29 @@ These tools include:
2729

2830
- [OneDrive LTI](#onedrive-lti-apps)
2931
- [Teams Assignments LTI](#teams-assignments-lti)
30-
- [Teams Meetings LTI](#teams-meetings-lti)
31-
- [Teams Classes LTI](#teams-classes-lti)
3232
- [Microsoft Reflect LTI](#microsoft-reflect-lti)
3333

34+
You can also [sync teams with your LMS](#sync-teams-with-your-lms).
35+
3436
For general information on managing Microsoft LTI apps, see [Manage Microsoft LTI apps for any LMS](manage-microsoft-one-lti.md).
3537

3638
> [!IMPORTANT]
3739
> We're streamlining the LTI® (Learning Tools Interoperability) experiences for education customers who may be using different LMS systems. We're simplifying onboarding and usage by consolidating the capabilities of multiple LTI tools available today into fewer and more functional tools.
3840
>
39-
> The capabilities of the Teams Classes LTI and Meetings LTI tools are among the first tools updated in this consolidation. Microsoft is announcing the end of support for the Teams Classes LTI and Meetings LTI tools on September 15, 2025, as their capabilities will be superseded by a new, unified experience. Release details for the unified experience are forthcoming.
41+
> The capabilities of the Teams LTI and Meetings LTI tools are among the first tools updated in this consolidation. Microsoft is announcing the end of support for the Teams Classes LTI and Meetings LTI tools on September 15, 2025, as their capabilities will be superseded by a new, unified experience. Release details for the unified experience are forthcoming.
4042
4143
## OneDrive LTI apps
4244

4345
Learn more about using Microsoft OneDrive with your Learning Management System (LMS).
4446

45-
- **Brings Microsoft 365 directly into your workflows**
46-
47-
The Microsoft OneDrive LTI app integrates with your LMS to bring Microsoft OneDrive and Microsoft 365 directly into your most important workflows that include:
48-
49-
- Attaching resources and organizing content.
50-
- Starting collaborative documents.
51-
- Creating and grading assignments.
47+
- **Brings Microsoft 365 directly into your workflows** - The Microsoft OneDrive LTI app integrates with your LMS to bring Microsoft OneDrive and Microsoft 365 directly into your most important workflows that include:
48+
- Attaching resources and organizing content.
49+
- Starting collaborative documents.
50+
- Creating and grading assignments.
5251

53-
- **Secure and fully compliant with latest LTI standards**
52+
- **Secure and fully compliant with latest LTI standards** - The Microsoft OneDrive LTI App is compatible with LTI 1.3 and LTI Advantage, allowing for a secure and integrated user experience.
5453

55-
The Microsoft OneDrive LTI App is compatible with LTI 1.3 and LTI Advantage, allowing for a secure and integrated user experience.
56-
57-
- **Modern and rich user experience**
58-
59-
We're improving upon the existing Microsoft 365 integration in your LMS by delivering a modern user experience, complete with an expanded Microsoft OneDrive file picker and rich editing experiences for Office files.
54+
- **Modern and rich user experience** - We're improving upon the existing Microsoft 365 integration in your LMS by delivering a modern user experience, complete with an expanded Microsoft OneDrive file picker and rich editing experiences for Office files.
6055

6156
Microsoft owns the OneDrive LTI app, which means you’ll always get the latest updates from Microsoft automatically.
6257

@@ -78,6 +73,7 @@ For configuration steps, see:
7873
- [Microsoft OneDrive LTI with D2L Brightspace](onedrive-lti-brightspace.md)
7974

8075
## Teams Assignments LTI
76+
8177
The Microsoft Teams Assignments LTI brings the Learning Accelerators: Reading Progress, Math Progress. Search Progress and Speaker Progress along with Microsoft Forms, Whiteboard, OneNote Pages, and all of the new generative AI features of Teams Assignments to your LTI v1.3 Advantage compliant LMS.
8278
The integration allows you to Connect Class Teams and add Teams Assignments right into your LMS assignments list where students can launch and complete them and sync grades and feedback automatically back to the LMS.
8379

@@ -88,32 +84,7 @@ The integration allows you to Connect Class Teams and add Teams Assignments righ
8884
- [Microsoft Assignments integration with Desire2Learn Brightspace](teams-assignments-with-brightspace.md).
8985
- [Microsoft Assignments integration with any LTI 1.3 compliant LMS](teams-assignments-with-other-lms.md).
9086

91-
More LMS support coming soon! Please sign up for more information on current and future LMS integration previews at https://aka.ms/LMSPreview
92-
93-
## Teams Meetings LTI
94-
95-
Microsoft Teams Meetings LTI app incorporates Teams meetings into LMS courses. Educators and students can view past and upcoming meetings, schedule individual or recurring meetings, and join team meetings related to the course, all from within their LMS.
96-
97-
For configuration steps, see:
98-
99-
- [Microsoft Teams Meetings with Canvas](teams-meetings-with-canvas.md).
100-
- [Microsoft Teams Meetings with Moodle](teams-classes-meetings-with-moodle.md).
101-
- [Microsoft Teams Meetings with Open LMS](open-lms-teams-classes-and-meetings.md).
102-
- [Microsoft Teams Meetings with Desire2Learn Brightspace](teams-classes-meetings-with-brightspace.md).
103-
- [Microsoft Teams Meetings with Schoology Learning](teams-classes-and-meetings-with-schoology.md).
104-
- [Microsoft Teams Meetings LTI with any LTI 1.3 compliant LMS](integrate-with-other-lms.md).
105-
106-
## Teams Classes LTI
107-
108-
The Microsoft Teams Classes LTI app helps educators and students navigate between their LMS and Teams. Users can access their class teams associated with their course within their LMS.
109-
110-
For configuration steps, see:
111-
112-
- [Microsoft Teams Classes with Canvas](teams-classes-with-canvas.md).
113-
- [Microsoft Teams Classes with Blackboard](teams-classes-with-blackboard.md).
114-
- [Microsoft Teams Classes with Moodle](teams-classes-meetings-with-moodle.md).
115-
- [Microsoft Teams Classes with Open LMS](open-lms-teams-classes-and-meetings.md).
116-
- [Microsoft Teams Classes with Desire2Learn Brightspace](teams-classes-meetings-with-brightspace.md).
87+
More LMS support coming soon! Sign up for more information on current and future LMS integration previews at https://aka.ms/LMSPreview
11788

11889
## Microsoft Reflect LTI
11990

@@ -128,3 +99,15 @@ For configuration steps, see:
12899
- [Microsoft Reflect with Moodle](reflect-lti-moodle.md).
129100
- [Microsoft Reflect with D2L Brightspace](reflect-lti-brightspace.md).
130101
- [Microsoft Reflect with Blackboard Learn](reflect-lti-blackboard.md).
102+
103+
## Sync Teams with your LMS
104+
105+
Syncing Microsoft Teams with your LMS helps educators and students navigate between their LMS and Teams. Users can access their teams associated with their course within their LMS.
106+
107+
For configuration steps, see:
108+
109+
- [Microsoft Teams with Canvas](teams-classes-with-canvas.md).
110+
- [Microsoft Teams with Blackboard](teams-classes-with-blackboard.md).
111+
- [Microsoft Teams with Moodle](teams-classes-meetings-with-moodle.md).
112+
- [Microsoft Teams with Open LMS](open-lms-teams-classes-and-meetings.md).
113+
- [Microsoft Teams with Desire2Learn Brightspace](teams-classes-meetings-with-brightspace.md).
6.3 KB
Loading

0 commit comments

Comments
 (0)