本文介绍如何为应用程序配置Azure Active Directory (Azure AD) 应用程序代理。 应用程序代理提供对本地 Web 应用程序的安全远程访问和单一登录。 为应用程序配置应用程序代理后,用户可以通过外部 URL、我的应用 门户或其他内部应用程序门户访问其本地应用程序。
先决条件
- 本教程假设你已安装连接器并完成了应用程序代理的先决条件,以便连接器可以与 Azure AD 服务通信。
- 本教程假定你使用的是Graph资源管理器,但可以使用 Postman 或创建自己的客户端应用来调用 Microsoft Graph。 若要在本教程中调用 Microsoft Graph API,需要使用具有全局管理员角色和相应权限的帐户。 完成以下步骤,在Graph资源管理器中设置权限:
-
"开始"菜单Graph资源管理器。
-
选择“使用 Microsoft 登录”,然后使用 Azure AD 全局管理员账户登录。 成功登录后,可在左侧窗格中看到用户帐户详细信息。
-
选择用户帐户详细信息右侧的设置图标,然后选择“权限”。
设置权限
-
滚动浏览 目录 (3) 的权限列表,展开,然后选择
Directory.ReadWrite.All。搜索权限
-
选择“同意”,然后选择“接受”,以接受同意权限。 你不需要代表组织同意这些权限。
接受权限
-
Note: 显示的响应对象可能会为了可读性而缩短。
步骤 1:创建自定义应用程序
若要使用 API 为应用配置应用程序代理,请先创建自定义应用程序,然后更新应用程序的 onPremisesPublishing 属性以配置应用代理设置。 在本教程中,你将使用应用程序模板在租户中创建自定义应用程序和服务主体的实例以进行管理。 自定义应用程序的模板 ID 为 8adf8e6e-67b2-4cf2-a259-e3dc5476c621。
记录应用程序的 ID、 appId、 servicePrincipalId ,以便在本教程的后面部分使用。
请求
POST https://graph.microsoft.com/v1.0/applicationTemplates/8adf8e6e-67b2-4cf2-a259-e3dc5476c621/instantiate
Content-type: application/json
{
"displayName": "Contoso IWA App"
}
响应
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#applications/$entity",
"id": "bf21f7e9-9d25-4da2-82ab-7fdd85049f83",
"deletedDateTime": null,
"addIns": [],
"appId": "d7fbfe28-c60e-46d2-8335-841923950d3b",
"applicationTemplateId": null,
"identifierUris": [],
"createdDateTime": "2020-08-11T21:07:47.5919755Z",
"description": null,
"displayName": "Contoso IWA App",
"isAuthorizationServiceEnabled": false,
"isDeviceOnlyAuthSupported": null,
"isFallbackPublicClient": null,
"groupMembershipClaims": null,
"notes": null,
"optionalClaims": null,
"orgRestrictions": [],
"publisherDomain": "f128.info",
"signInAudience": "AzureADandPersonalMicrosoftAccount",
"tags": [],
"tokenEncryptionKeyId": null,
"uniqueName": null,
"verifiedPublisher": {
"displayName": null,
"verifiedPublisherId": null,
"addedDateTime": null
},
}
步骤 2:配置应用程序代理
使用为应用程序记录的 ID 启动应用程序代理配置。 更新以下属性:
- onPremisesPublishing - 在此示例中,将应用与内部 URL 配合使用:
https://contosoiwaapp.com此外,还对外部 URL 使用默认域:https://contosoiwaapp-contoso.msappproxy.net - redirectUri、 identifierUri 和 homepageUrl - 设置为 在 onPremisesPublishing 属性中配置的同一外部 URL。
- implicitGrantSettings - 设置
true为 enabledTokenIssuance 和falseenabledAccessTokenIssuance。
请求
PATCH https://graph.microsoft.com/beta/applications/bf21f7e9-9d25-4da2-82ab-7fdd85049f83
Content-type: application/json
{
"onPremisesPublishing": {
"externalAuthenticationType": "aadPreAuthentication",
"internalUrl": "https://contosoiwaapp.com",
"externalUrl": "https://contosoiwaapp-contoso.msappproxy.net"
},
"identifierUris": ["https://contosoiwaapp-contoso.msappproxy.net"],
"web": {
"redirectUris": ["https://contosoiwaapp-contoso.msappproxy.net"],
"homePageUrl": "https://contosoiwaapp-contoso.msappproxy.net",
"implicitGrantSettings": {
"enableIdTokenIssuance": true,
"enableAccessTokenIssuance": false
}
}
}
响应
HTTP/1.1 204 No content
步骤 3:将连接器组分配到应用程序
获取连接器
列出可用的连接器。 记录要分配给连接器组的连接器 的 ID 。
请求
GET https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationProxy/connectors
响应
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#connectors",
"value": [
{
"id": "d2b1e8e8-8511-49d6-a4ba-323cb083fbb0",
"machineName": "connectorA.redmond.contoso.com"",
"externalIp": "131.137.147.164",
"status": "active"
},
{
"id": "f2cab422-a1c8-4d70-a47e-2cb297a2e051",
"machineName": "connectorB.contoso.com"",
"externalIp": "68.0.191.210",
"status": "active"
}
]
}
创建 connectorGroup
在此示例中,将创建一个用于 IWA Demo Connector Group 应用程序的新连接器组。 记录要在下一步中使用的 ID 。
请求
POST https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationProxy/connectorGroups
Content-type: application/json
{
"name": "IWA Demo Connector Group"
}
响应
HTTP/1.1 201
Content-type: connectorGroup/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#connectorGroups/$entity",
"id": "3e6f4c35-a04b-4d03-b98a-66fff89b72e6",
"name": "IWA Demo Connector Group",
"connectorGroupType": "applicationProxy",
"isDefault": false
}
将连接器分配到 connectorGroup
请求
POST https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationProxy/connectors/f2cab422-a1c8-4d70-a47e-2cb297a2e051/memberOf/$ref
Content-type: application/json
{
"@odata.id":"https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationProxy/connectorGroups/3e6f4c35-a04b-4d03-b98a-66fff89b72e6"
}
响应
HTTP/1.1 204 No content
将应用程序分配到 connectorGroup
请求
PUT https://graph.microsoft.com/beta/applications/bf21f7e9-9d25-4da2-82ab-7fdd85049f83/connectorGroup/$ref
Content-type: application/json
{
"@odata.id":"https://graph.microsoft.com/onPremisesPublishingProfiles/applicationproxy/connectorGroups/3e6f4c35-a04b-4d03-b98a-66fff89b72e6"
}
响应
HTTP/1.1 204 No content
步骤 4:配置单一登录
此应用程序使用集成Windows身份验证 (IWA) 。 若要配置 IWA,请为 onPremisesPublishing 设置单一登录属性。
请求
PATCH https://graph.microsoft.com/beta/applications/bf21f7e9-9d25-4da2-82ab-7fdd85049f83
Content-type: appplication/json
{
"onPremisesPublishing": {
"singleSignOnSettings": {
"kerberosSignOnSettings": {
"kerberosServicePrincipalName": "HTTP/iwademo.contoso.com",
"kerberosSignOnMappingAttributeType": "userPrincipalName"
},
"singleSignOnMode": "onPremisesKerberos"
}
}
}
响应
HTTP/1.1 204 No content
步骤 5:分配用户
检索应用程序的 appRole
使用服务主体的 ID 获取应用程序的应用角色。 记录要在下一步中使用的 用户 应用角色的 ID。
请求
GET https://graph.microsoft.com/beta/servicePrincipals/a8cac399-cde5-4516-a674-819503c61313/appRoles
响应
HTTP/1.1 200
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#servicePrincipals('a8cac399-cde5-4516-a674-819503c61313')/appRoles",
"value": [
{
"allowedMemberTypes": [
"User"
],
"description": "User",
"displayName": "User",
"id": "18d14569-c3bd-439b-9a66-3a2aee01d14f",
"isEnabled": true,
"origin": "Application",
"value": null
},
]
}
创建用户账户
在本教程中,创建分配给应用角色的用户帐户。 在请求正文中,更改 contoso.com 为租户的域名。 可在 Azure Active Directory 概述页面上找到租户信息。 记录要在下一步中使用的用户帐户的 ID 。
请求
POST https://graph.microsoft.com/v1.0/users
Content-type: application/json
{
"accountEnabled":true,
"displayName":"MyTestUser1",
"mailNickname":"MyTestUser1",
"userPrincipalName":"MyTestUser1@contoso.com",
"passwordProfile": {
"forceChangePasswordNextSignIn":true,
"password":"Contoso1234"
}
}
响应
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"id": "4628e7df-dff3-407c-a08f-75f08c0806dc",
"businessPhones": [],
"displayName": "MyTestUser1",
"givenName": null,
"jobTitle": null,
"mail": null,
"mobilePhone": null,
"officeLocation": null,
"preferredLanguage": null,
"surname": null,
"userPrincipalName": "MyTestUser1@contoso.com"
}
将用户分配到应用程序
在以下示例中,替换以下属性的值:
- 具有用户 ID 的 principalId
- 具有应用角色 ID 的 appRoleId
- 具有服务主体 ID 的 resourceId
请求
POST https://graph.microsoft.com/beta/servicePrincipals/b00c693f-9658-4c06-bd1b-c402c4653dea/appRoleAssignments
Content-type: appRoleAssignments/json
{
"principalId": "4628e7df-dff3-407c-a08f-75f08c0806dc",
"principalType": "User",
"appRoleId":"18d14569-c3bd-439b-9a66-3a2aee01d14f",
"resourceId":"a8cac399-cde5-4516-a674-819503c61313"
}
响应
HTTP/1.1 200
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#appRoleAssignments/$entity",
"id": "I23pL8ZdNU-CIgQmqMEVyLJ0E6fx0ixEo92az8MnhtU",
"creationTimestamp": "2020-06-09T00:06:07.5129268Z",
"appRoleId": "18d14569-c3bd-439b-9a66-3a2aee01d14f",
"principalDisplayName": "MyTestUser1",
"principalId": "2fe96d23-5dc6-4f35-8222-0426a8c115c8",
"principalType": "User",
"resourceDisplayName": "Contoso IWA App",
"resourceId": "a8cac399-cde5-4516-a674-819503c61313"
}
步骤 6:测试对应用程序的访问
通过访问在浏览器上为应用配置的 外部 URL ,然后使用测试用户登录来测试应用程序。 应该能够登录到应用并访问应用程序。
第 7 步:清理资源
在本教程中创建的资源不应在生产环境中使用。 在此步骤中,将删除创建的资源。
删除用户账户
删除 MyTestUser1 用户帐户。
请求
DELETE https://graph.microsoft.com/v1.0/users/4628e7df-dff3-407c-a08f-75f08c0806dc
响应
No Content - 204
删除应用程序
请求
DELETE https://graph.microsoft.com/v1.0/applications/bf21f7e9-9d25-4da2-82ab-7fdd85049f83
响应
No Content - 204
删除连接器组
请求
DELETE https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationProxy/connectorGroups/3e6f4c35-a04b-4d03-b98a-66fff89b72e6
响应
No Content - 204
另请参阅
- 应用程序代理
- application
- applicationTemplate:实例化
- appRoleAssignment
- connector
- connectorGroup
- implicitGrantSettings
- 本地发布配置文件
- servicePrincipal
- singleSignOnSettings
- 用户
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 FaithOmbongi)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
