You need to enable JavaScript to run this app. 如何通过API将Azure AD用户导入Dynamics 365 Finance & Operations (D365FO)
优惠活动
大模型
产品
解决方案
定价
更多

如何通过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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 02:27:00