如何通过API将Azure AD用户导入Dynamics 365 Finance & Operations (D365FO)
D365 Finance & Operations 导入Azure AD用户的API实现方案
D365FO没有专门的「一键导入AAD用户」接口,你可以通过组合Microsoft Graph取数 + D365FO OData实体写入的方式实现和UI导入完全一致的效果,具体流程如下:
前置准备
- 确保你调用接口的身份同时有AAD用户读取权限和D365FO的系统管理员权限
- 提前确认你的D365FO实例绑定的AAD租户ID和域名
操作步骤
第一步:获取目标AAD用户的核心属性
调用Microsoft Graph接口拉取待导入用户的以下信息:- 用户主体名称(UserPrincipalName)
- 显示名称(DisplayName)
- 联系邮箱(Mail)
- AAD对象ID(ObjectId)
第二步:调用D365FO的
/data/SystemUsers接口创建用户
提交POST请求,请求头携带D365FO的授权令牌,请求体参考示例:{ "Alias": "<AAD用户的UserPrincipalName>", "Name": "<AAD用户的DisplayName>", "NetworkDomain": "<AAD租户域名,例如contoso.com>", "Enabled": true, "UserInfo": { "UserName": "<自定义D365FO内的用户ID,建议和UPN前缀保持一致>", "Name": "<AAD用户的DisplayName>", "UserEmail": "<AAD用户的Mail>", "SID": "<AAD用户的ObjectId>", "IdentityProvider": "https://sts.windows.net/<你的AAD租户ID>/" } }请求返回201状态码即代表用户导入成功,后续可通过
/data/SecurityUserRoleAssignments接口为用户分配对应安全角色。
常见问题处理
- 若返回400错误提示别名重复,可先调用
GET /data/SystemUsers?$filter=Alias eq '<用户UPN>'确认是否已有同用户记录 - 10.0.21以下版本的D365FO需额外确认
IdentityProvider字段是否支持带租户ID的完整路径,部分旧版本仅需填写https://sts.windows.net/即可 - 批量导入场景可使用OData批量请求能力,单次批量请求最多支持100条用户创建操作,避免触发接口限流
内容的提问来源于stack exchange,提问作者Oleksii
相关产品推荐
相关产品推荐

