使用 ClientSecret 授权方式 在 .NET 控制台应用中连接 Dynamics 365

步骤(一) 获取 ClientId 和 ClientSecret#

Step 1. 注册 Azure 应用#

（1）访问并登录 Azure Portal

Tip

国际版请访问：https://portal.azure.com

世纪互联版请访问：https://portal.azure.cn

（2）在顶部的搜索框，搜索“应用注册” 并点击它

（3）点击“+新注册”

（4）在弹出的页面输入一个有意义的应用程序名称 –> 勾选受支持的账号类型 –> 点击“注册”按钮

Step 2. 获取 ClientId#

完成应用注册后，在 “概览(Overview)” 页面中可以看到 应用程序(客户端)ID ，请将该值复制并保存，后续配置会用到

Step 3. 创建 ClientSecret#

• 打开 “证书和密码”
• 选择 客户端密码
• 点击 “+ 新客户端密码”
• 填写描述并设置有效期
• 点击 “添加”

• 创建完成后，请立即复制 ClientSecret 的“值”并保存

Tip

页面刷新后该值将被隐藏，若未保存只能删除后重新创建

步骤（二）在 Power Platform 中添加应用程序用户#

接下来需要将刚创建的应用与 Dynamics 365 环境关联上，步骤如下：

登录 Power Platform 管理中心 —> 选择目标环境 —> 设置 —> 进入 “应用程序用户” —> 点击 “+ 新建应用用户

配置项说明：

• 应用：选择刚才在 Azure 中注册的应用
• 业务部门：建议选择 根业务部门
• 安全角色：至少分配 系统管理员

完成后点击 “创建”

步骤（三）创建控制台应用程序进行连接测试#

Step 1. 创建控制台应用程序#

打开 Visual Studio —> 创建新项目，选择 “控制台应用(.NET Framework)”

输入项目名称 —> 选择 “.NET Framework 版本” —> 点击 “创建”

Step 2. 添加NuGet包#

为项目安装以下依赖：

1. Microsoft.CrmSdk.CoreAssemblies
2. System.Configuration.ConfigurationManage

下面是具体的操作步骤说明和截图：

项目 —> 右键 —> 管理 NuGet 程序包 —>

浏览 —> 搜索 —> 安装

Step 3. 为 App.config 添加连接信息#

在 App.config 文件中添加连接字符串配置：

• 打开 App.config 文件
• 在 <configuration> 节点下添加 <connectionStrings> 节
• 替换以下占位符为实际值：

1
<connectionStrings>
2
  <!-- Dev 环境（ClientSecret 认证方式） -->
3
  <add name="Dev-ClientSecret" connectionString="
4
     Url=https://xxx.crm.dynamics.cn/;
5
     AuthType=ClientSecret;
6
     ClientId=yourClientId;
7
     ClientSecret=yourClientSecret;" />
8
</connectionStrings>

需要替换的值：

• Url —> Dynamics 365 环境访问地址
• ClientId —> 应用程序 ID
• ClientSecret —> 客户端密钥

Step 4. 添加测试代码#

在 Program.cs 中：

引用命名空间

1
using Microsoft.Crm.Sdk.Messages;
2
using Microsoft.Xrm.Sdk;
3
using Microsoft.Xrm.Tooling.Connector;
4
using System;
5
using System.Configuration;

Main 方法代码

1
string connectionStr = ConfigurationManager.ConnectionStrings["Dev-ClientSecret"].ConnectionString;
2
CrmServiceClient client = new CrmServiceClient(connectionStr);
3
if (client.IsReady)
4
{
5
    IOrganizationService orgServiceorgService = client;
6
    // 使用 WhoAmI 进行测试
7
    WhoAmIResponse resTest = (WhoAmIResponse)orgServiceorgService.Execute(new WhoAmIRequest());
8
    Console.Write($"UserId: {resTest.UserId}");
9
    Console.Read();
10
}
11
else
12
{
13
    throw new Exception(client.LastCrmError);
14
}

Step 5. 运行#

1. 将当前项目设为 启动项目

2. 使用 F5 或点击 “启动” 按钮

3. 如果程序成功输出 UserId，说明：

• ClientSecret 认证成功
• 已成功连接 Dynamics 365
• 可继续使用 IOrganizationService 进行 CRUD 操作