使用.NET创建Azure IoT Hub设备及REST API创建设备未授权问题求助

一、REST API创建设备未授权异常的排查与解决 #

调用创建设备的REST API时触发401未授权，大概率是权限配置或授权令牌的问题，你可以按以下步骤排查：

1. 确认共享访问策略的权限 #

用来发起API请求的共享访问密钥，必须具备RegistryWrite权限。登录Azure门户，找到你的IoT Hub，进入「共享访问策略」：

• 若使用内置策略，优先选iothubowner（权限全，但生产环境建议用自定义策略）；
• 自定义策略需勾选「RegistryWrite」和「RegistryRead」权限，用该策略的密钥生成授权令牌。

2. 保证授权令牌生成正确 #

REST API要求请求头携带Authorization参数，常用的SAS令牌生成需注意以下细节：

• 签名的资源URI是你的IoT Hub主机名（格式：{your-hub-name}.azure-devices.net）；
• 过期时间设置合理（比如1小时后，避免令牌过早失效）；
• 采用HMAC-SHA256算法生成签名，再进行Base64编码。

这里给个简化的C#伪代码示例，展示SAS令牌的生成逻辑：

using System;
using System.Security.Cryptography;
using System.Text;

string resourceUri = "your-hub-name.azure-devices.net";
string sharedAccessKey = "your-policy-key";
string policyName = "your-policy-name";
TimeSpan expiryTime = TimeSpan.FromHours(1);

long expiryTicks = DateTimeOffset.UtcNow.Add(expiryTime).ToUnixTimeSeconds();
string signatureString = $"{Uri.EscapeDataUri(resourceUri)}\n{expiryTicks}";

HMACSHA256 hmac = new HMACSHA256(Convert.FromBase64String(sharedAccessKey));
string signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(signatureString)));

string sasToken = $"SharedAccessSignature sr={Uri.EscapeDataUri(resourceUri)}&sig={Uri.EscapeDataUri(signature)}&se={expiryTicks}&skn={policyName}";

生成后将sasToken填入请求头的Authorization字段即可。

3. 检查请求头的完整性 #

除了Authorization，还需确保请求头包含：

• Content-Type: application/json（创建设备的请求体为JSON格式）；
• x-ms-date 或 Date 头（用于验证请求的时效性，避免因时间差导致授权失败）。

二、使用.NET创建Azure IoT Hub设备 #

推荐两种主流实现方式，根据你的业务场景选择：

方式1：IoT Hub服务SDK（面向设备管理场景） #

这是最常用的方式，适合直接操作IoT Hub内的设备。首先安装NuGet包：Microsoft.Azure.Devices

完整示例代码：

using Microsoft.Azure.Devices;
using System;
using System.Threading.Tasks;

namespace IoTHubDeviceCreation
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // 替换为你的IoT Hub连接字符串（从共享访问策略中获取）
            string iotHubConnectionString = "HostName=your-hub-name.azure-devices.net;SharedAccessKeyName=your-policy-name;SharedAccessKey=your-policy-key";
            RegistryManager registryManager = RegistryManager.CreateFromConnectionString(iotHubConnectionString);

            try
            {
                string deviceId = "my-new-device-001";
                // 创建设备，可自定义设备属性（比如禁用对称密钥、设置孪生属性等）
                Device newDevice = await registryManager.AddDeviceAsync(new Device(deviceId));

                Console.WriteLine($"设备创建成功！");
                Console.WriteLine($"设备ID: {newDevice.Id}");
                Console.WriteLine($"主密钥: {newDevice.Authentication.SymmetricKey.PrimaryKey}");
                Console.WriteLine($"设备连接字符串: HostName=your-hub-name.azure-devices.net;DeviceId={newDevice.Id};SharedAccessKey={newDevice.Authentication.SymmetricKey.PrimaryKey}");
            }
            catch (DeviceAlreadyExistsException ex)
            {
                Console.WriteLine($"设备 {ex.Message} 已存在");
            }
            finally
            {
                await registryManager.CloseAsync();
            }
        }
    }
}

方式2：Azure资源管理器SDK（面向资源管理场景） #

如果需要通过Azure资源管理层面操作（比如批量创建、结合ARM模板），可以使用这个SDK。首先安装NuGet包：Azure.ResourceManager.IotHubs

示例代码：

using Azure.Identity;
using Azure.ResourceManager.IotHubs;
using Azure.ResourceManager.IotHubs.Models;
using System;
using System.Threading.Tasks;

namespace IoTHubDeviceCreationWithARM
{
    class Program
    {
        static async Task Main(string[] args)
        {
            // 替换为你的订阅ID、资源组名称、IoT Hub名称
            string subscriptionId = "your-subscription-id";
            string resourceGroupName = "your-resource-group";
            string iotHubName = "your-hub-name";
            string deviceId = "my-arm-managed-device";

            // 使用DefaultAzureCredential认证（支持Azure CLI、环境变量、托管身份等）
            var credential = new DefaultAzureCredential();
            var iotHubManager = new IotHubManager(credential, subscriptionId);

            try
            {
                // 获取目标IoT Hub资源
                IotHubResource iotHubResource = await iotHubManager.IotHubs.GetAsync(resourceGroupName, iotHubName);

                // 创建设备
                var deviceInfo = new IotHubDeviceInfo(deviceId);
                var createdDevice = await iotHubResource.GetIotHubDevices().CreateOrUpdateAsync(WaitUntil.Completed, deviceId, deviceInfo);

                Console.WriteLine($"设备创建成功！设备ID: {createdDevice.Data.Id}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"创建设备失败: {ex.Message}");
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Rohi_Dev_1.0