使用模拟身份代表另一个 Microsoft Dataverse 用户执行业务逻辑。 通过使用模拟用户的适当角色和基于对象的安全性,可以提供所需的功能或服务。
各种客户端和服务都可以通过模拟身份,代表 Dataverse 用户调用 Dataverse Web 服务。
模拟登录涉及两个不同的用户账户:
| 冒充者 | 被冒充的用户 |
|---|---|
| 执行代码时使用的用户帐户 | 代表其执行任务的用户帐户。 |
所需权限
模拟用户需要具有“代表另一用户执行操作”权限(prvActOnBehalfOfAnotherUser)。 此权限包含在 委托 安全角色中,也可以为任何安全角色启用。
注释
用户可以与多个安全角色相关联。 将 委托 安全角色分配给用户可授予 prvActOnBehalfOfAnotherUser 权限以及与用户帐户关联的任何其他安全角色提供的权限。
用于修改数据的实际特权集是 模拟 用户与 模拟用户拥有的特权的交集。
换句话说,模拟方当且仅当模拟方和被模拟用户都具有执行该操作所需的特权时,才被允许执行某项操作。
必须直接分配
必须将 代表其他用户 权限(prvActOnBehalfOfAnotherUser)或包含该权限的角色直接分配给用户。 用户无法通过团队继承此权限。 由于特权的敏感性质,需要此直接分配。
使用服务器间身份验证进行身份模拟
如果要创建需要代表订阅用户的用户帐户的 Web 客户端应用程序,请使用特殊的 应用程序 用户帐户,以便无需使用付费 Dataverse 用户许可证。
详细信息: 使用服务器到服务器(S2S)身份验证生成 Web 应用程序。
使用 Web API 冒充其他用户
在将请求发送到 Web 服务之前,可以通过传递具有相应用户 ID 的请求标头来模拟用户。
如何模拟用户
使用以下标头之一:
-
首选:将
CallerObjectId设置为模拟用户的 Microsoft Entra ID 对象 ID。 此值存储在 SystemUser.AzureActiveDirectoryObjectId 中。 -
旧版: 将
MSCRMCallerID设置为被模拟用户的 SystemUser.SystemUserId GUID 值。
以下示例代表具有 Microsoft Entra ID 对象 ID aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 的用户创建客户行。
请求:
POST [Organization URI]/api/data/v9.2/accounts HTTP/1.1
CallerObjectId: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
{"name":"Sample Account created using impersonation"}
响应:
HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: [Organization URI]/api/data/v9.2/accounts(00000000-0000-0000-0000-000000000003)
确定实际用户
使用模拟创建行时,查询 createdonbehalfby 单值导航属性以查找实际执行操作的用户。 对于更新,请使用相应的 modifiedonbehalfby 单值导航属性。
以下示例检索在上一示例中创建的帐户。
owninguser 属性和 createdby 属性标识模拟用户,同时 createdonbehalfby 标识实际用户。
请求:
GET [Organization URI]/api/data/v9.2/accounts(00000000-0000-0000-0000-000000000003)?$select=name&$expand=createdby($select=fullname,azureactivedirectoryobjectid),createdonbehalfby($select=fullname,azureactivedirectoryobjectid),owninguser($select=fullname,azureactivedirectoryobjectid) HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
响应:
HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
ETag: W/"2751197"
{
"@odata.context": "[Organization URI]/api/data/v9.2/$metadata#accounts(name,createdby(fullname,azureactivedirectoryobjectid),createdonbehalfby(fullname,azureactivedirectoryobjectid),owninguser(fullname,azureactivedirectoryobjectid))/$entity",
"@odata.etag": "W/\"2751197\"",
"name": "Sample Account created using impersonation",
"accountid": "00000000-0000-0000-0000-000000000003",
"createdby": {
"@odata.etag": "W/\"2632435\"",
"fullname": "Impersonated User",
"azureactivedirectoryobjectid": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"systemuserid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"ownerid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
},
"createdonbehalfby": {
"@odata.etag": "W/\"2632445\"",
"fullname": "Actual User",
"azureactivedirectoryobjectid": "bbbbbbbb-1111-2222-3333-cccccccccccc",
"systemuserid": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
"ownerid": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff"
},
"owninguser": {
"@odata.etag": "W/\"2632435\"",
"fullname": "Impersonated User",
"azureactivedirectoryobjectid": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"systemuserid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"ownerid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
}
}
使用 .NET SDK 模拟其他用户
若要模拟其他用户,请将 CallerId 该属性设置为模拟用户的 Guid 值。 实现的以下类 IOrganizationService 包括此属性。
使用插件模拟其他用户
可以注册包含代码的插件,以指定操作应使用的用户。 详细信息: 模拟用户。