Azure IoT C SDK：IoTHubDeviceClient_CreateFromDeviceAuth创建设备句柄失败求助

核心问题定位 #

1. REGISTRATION_NAME设置错误：注册组场景下，custom_hsm中的REGISTRATION_NAME应设为设备ID，而非注册组名称。注册组仅用于批量预配，设备连接时需使用自身唯一标识。
2. 对称密钥误用：不能直接使用注册组的主密钥，必须用设备ID和主密钥派生设备专属对称密钥。
3. custom_hsm逻辑适配不全：移除证书后，需确保HSM接口的签名逻辑完全适配对称密钥认证流程。

分步修复方案 #

1. 修正REGISTRATION_NAME值

将custom_hsm_example中的REGISTRATION_NAME改为目标设备ID（例如test-device），与IoT Hub中已预配的设备ID完全一致（大小写敏感）。

2. 生成设备专属对称密钥

注册组主密钥需通过设备ID派生后才能给设备使用，执行以下命令生成（替换占位符）：

device_id="test-device"
primary_key="你的注册组主密钥"
derived_key=$(echo -n "$device_id" | openssl dgst -sha256 -hmac "$primary_key" | sed 's/^.* //' | xxd -r -p | base64)

将custom_hsm中的SYMMETRIC_KEY替换为上述命令输出的derived_key值。

3. 修复custom_hsm逻辑

确保移除证书后，HSM接口函数适配对称密钥认证：

• hsm_get_registeration_name返回设备ID；
• hsm_get_symmetric_key返回派生后的设备专属密钥；
• 清空hsm_init和hsm_cleanup中残留的证书初始化代码，避免初始化失败；
• 确保hsm_sign函数正确实现HMAC-SHA256签名逻辑，匹配IoT Hub的认证要求。

4. 验证设备客户端创建参数

确认IoTHubDeviceClient_CreateFromDeviceAuth的参数有效性：

• 第一个参数：IoT Hub主机名（例如test-hub.azure-devices.net，无多余前缀/后缀）；
• 第二个参数：设备ID，与预配到Hub的设备ID完全一致；
• 第三个参数：协议枚举值（例如MQTT_Protocol、HTTP_Protocol），需与SDK定义的枚举匹配。

5. 确保编译链接正确

• 确认custom_hsm_example编译生成的库（如libcustom_hsm.so）被正确链接到主程序；
• 编译主程序时添加必要的SDK链接参数，例如：

  gcc your_main_code.c -o your_app -liothub_client -laziotsharedutil -lcustom_hsm
  

调试建议 #

• 开启SDK日志输出，在初始化前添加：

  IoTHubClient_SetLogCallback((LOGGER_CALLBACK)log_callback);
  

  通过日志定位授权模块的具体失败环节；
• 检查custom_hsm各函数的返回值，确认hsm_get_symmetric_key是否正确返回密钥、hsm_sign是否生成有效签名。

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