您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

了解 LocalConfiguration.json 文件 - C 代理

Defender for IoT 安全代理使用来自本地配置文件的配置。 安全代理在启动时读取一次配置。 在本地配置文件中找到的配置包含身份验证配置和其他与代理相关的配置。 该文件包含“键值”对中采用 JSON 表示法的配置,并在安装代理时填充这些配置。

默认情况下,该文件位于:/var/ASCIoTAgent/LocalConfiguration.json

代理重启时,配置文件会进行更改。

适用于 C 的安全代理配置

配置名称 可能值 详细信息
AgentId GUID 代理唯一标识符
TriggerdEventsInterval ISO8601 字符串 计划程序收集已触发事件的间隔
ConnectionTimeout ISO8601 字符串 IoThub 连接超时之前的时间段
身份验证 JsonObject 身份验证配置。 此对象包含针对 IoTHub 进行身份验证所需的所有信息
标识 “DPS”、“SecurityModule”、“Device” 身份验证标识 - 如果通过 DPS 进行身份验证,则该值为“DPS”;如果通过 Defender-IoT-micro-agent 凭据进行身份验证,则该值为“SecurityModule”;如果使用设备凭据进行身份验证,则该值为“Device”
AuthenticationMethod “SasToken”、“SelfSignedCertificate” 用于身份验证的用户机密 - 如果用户机密是对称密钥,请选择“SasToken”;如果机密是自签名证书,请选择“SelfSignedCertificate”
文件路径 文件路径(字符串) 包含身份验证机密的文件的路径
HostName string Azure IoT 中心的主机名。 通常是 .azure-devices.net
DeviceId string 设备的 ID(已注册到 Azure IoT 中心)
DPS JsonObject DPS 相关配置
IDScope string DPS 的 ID 范围
RegistrationId string DPS 设备注册 ID
日志记录 JsonObject 代理记录器相关配置
SystemLoggerMinimumSeverity 0 <= 数字 <= 4 等于或高于此严重级别的日志消息将被记录到 /var/log/syslog(0 是最低严重级别)
DiagnosticEventMinimumSeverity 0 <= 数字 <= 4 等于或高于此严重级别的日志消息将被作为诊断事件发送(0 是最低严重级别)

安全代理配置代码示例

{
    "Configuration" : {
        "AgentId" : "b97faf0a-0f57-471f-9dab-46a8e1764946",
        "TriggerdEventsInterval" : "PT2M",
        "ConnectionTimeout" : "PT30S",
        "Authentication" : {
            "Identity" : "Device",
            "AuthenticationMethod" : "SasToken",
            "FilePath" : "/path/to/my/SymmetricKey",
            "DeviceId" : "my-device",
            "HostName" : "my-iothub.azure-devices.net",
            "DPS" : {
                "IDScope" : "",
                "RegistrationId" : ""
            }
        },
        "Logging": {
            "SystemLoggerMinimumSeverity": 0,
            "DiagnoticEventMinimumSeverity": 2
        }
    }
}

后续步骤