如何借助DPS服务客户端获取IoT Hub连接字符串并构建ServiceClient调用设备方法

关键前提 #

DPS服务客户端仅能返回设备分配的IoT Hub名称（AssignedHub），无法直接获取对应IoT Hub的连接字符串——因为连接字符串属于IoT Hub的敏感凭据，不会通过DPS接口对外暴露。因此需要提前将所有可能接收DPS预配设备的IoT Hub连接字符串，配置到Azure函数应用的应用设置中。

具体实现步骤 #

1. 配置IoT Hub连接字符串到函数应用

   • 登录Azure门户，进入目标函数应用 → 打开「配置」→「应用程序设置」
   • 为每个相关IoT Hub添加配置项，建议键名格式为IOTHUB_CONN_{HubName}（例如IOTHUB_CONN_myiothub01），值填对应IoT Hub的服务端连接字符串

2. 通过DPS获取设备的AssignedHub
   假设你已通过ProvisioningServiceClient拿到设备分配信息，示例代码：

   using Microsoft.Azure.Devices.Provisioning.Service;
   
   var provisioningServiceClient = ProvisioningServiceClient.CreateFromConnectionString("<你的DPS连接字符串>");
   var deviceRegistration = await provisioningServiceClient.GetRegistrationStatusAsync("<设备注册ID>");
   string assignedHub = deviceRegistration.AssignedHub;
   

3. 匹配连接字符串并构建ServiceClient
   从函数应用配置中读取对应IoT Hub的连接字符串，初始化ServiceClient并调用设备方法：

   using Microsoft.Azure.Devices;
   
   // 拼接配置项键名，读取对应连接字符串
   string connStringKey = $"IOTHUB_CONN_{assignedHub}";
   string iotHubConnString = Environment.GetEnvironmentVariable(connStringKey);
   
   if (string.IsNullOrEmpty(iotHubConnString))
   {
       throw new InvalidOperationException($"未找到IoT Hub {assignedHub} 的连接字符串配置");
   }
   
   // 构建ServiceClient并执行设备方法调用
   using var serviceClient = ServiceClient.CreateFromConnectionString(iotHubConnString);
   var methodInvocation = new CloudToDeviceMethod("目标设备方法名")
   {
       ResponseTimeout = TimeSpan.FromSeconds(30),
       ConnectionTimeout = TimeSpan.FromSeconds(5)
   };
   // 按需设置方法参数
   methodInvocation.SetPayloadJson("{\"param\": \"testValue\"}");
   
   var response = await serviceClient.InvokeDeviceMethodAsync("<设备ID>", methodInvocation);
   

补充说明 #

• 若DPS需分配设备到大量IoT Hub，建议将连接字符串存储到Azure Key Vault，通过函数应用的托管标识访问Key Vault，避免直接在应用设置中存储敏感凭据。
• 确保ProvisioningServiceClient使用的DPS连接字符串拥有「读取设备注册状态」的权限。

内容的提问来源于stack exchange，提问作者hafij