Hyper-V环境下无需Azure门户本地配置Postman访问D365FO服务咨询

一、D365FO Hyper-V本地环境前置配置 #

• 登录Hyper-V内的D365FO虚拟机，打开System administration > Users > Users页面，创建或确认用于接口调用的服务账号，确保该账号拥有你创建的自定义服务的访问权限，同时记录账号的用户名、密码
• 进入System administration > Setup > Azure Active Directory applications，点击新建，填写以下参数：
  • Client Id：自定义无特殊字符的字符串即可，示例：D365FO_Postman_Local，不需要和Azure注册的应用ID一致
  • Name：填写可识别的客户端名称即可，示例：Postman本地调用客户端
  • User ID：选择上一步创建的服务账号ID
• 保存配置后，记录本地D365FO的根URL，格式通常为https://<你的VM主机名>.cloudax.dynamics.com/，默认开发VM也可能为https://usnconeboxax1aos.cloud.onebox.dynamics.com/

二、Postman本地认证配置 #

• 打开Postman新建请求，进入Authorization标签页，Type选择OAuth 2.0，Token存放位置选择Header
• 下拉到「Configure New Token」区域，填写对应参数：
  • Token Name：自定义名称，示例：D365FO本地访问令牌
  • Grant Type：选择Password Credentials
  • Access Token URL：填写https://<你的D365FO根URL>/oauth/token
  • Client ID：填写上一步在D365FO中配置的自定义Client Id
  • Client Secret：留空即可，本地配置无需填写
  • Username：填写服务账号完整用户名，示例：admin@contoso.com
  • Password：填写服务账号对应密码
  • Scope：填写https://<你的D365FO根URL>/.default
• 点击「Get New Access Token」，获取成功后点击「Use Token」即可完成认证配置

三、自定义服务调用验证 #

• 按照你创建的自定义服务参数要求填写请求URL、请求方法、请求头、请求体
• 请求头需固定添加Content-Type: application/json
• 点击发送即可完成调用，可根据返回错误码排查问题：
  • 401错误：检查认证配置参数是否正确，服务账号状态是否正常
  • 403错误：检查服务账号是否分配了自定义服务的访问权限
  • 404错误：检查自定义服务的URL路径、请求方法是否填写正确

内容的提问来源于stack exchange，提问作者Jesus David Medina Rivera