HTTP 认证

    插件：

    提示

    EMQX 在设备连接事件中使用当前客户端相关信息作为参数，向用户自定义的认证服务发起请求查询权限，通过返回的 HTTP 响应状态码 (HTTP statusCode) 来处理认证请求。

    • 认证失败：API 返回非 200 状态码
    • 认证成功：API 返回 200 状态码
    • 忽略认证：API 返回 200 状态码且消息体 ignore

    HTTP 在请求中传递明文密码，加盐规则与哈希方法取决于 HTTP 应用。

    3. ## 请求地址
    6. ## Value: post | get | put
    7. auth.http.auth_req.method = post
    9. ## 认证请求的 HTTP 请求头部，默认情况下配置 Content-Type 头部。
    11. auth.http.auth_req.headers.content-type = application/x-www-form-urlencoded
    13. auth.http.auth_req.params = clientid=%c,username=%u,password=%P

    HTTP 请求方法为 GET 时，请求参数将以 URL 查询字符串的形式传递；POST、PUT 请求则将请求参数以普通表单形式或者以 Json 形式提交（由 content-type 的值决定）。

    你可以在认证请求中使用以下占位符，请求时 EMQX 将自动填充为客户端信息：

    • %u：用户名
    • %c：Client ID
    • %a：客户端 IP 地址
    • %r：客户端接入协议
    • %P：明文密码
    • %p：客户端端口
    • %C：TLS 证书公用名（证书的域名或子域名），仅当 TLS 连接时有效
    • %d：TLS 证书 subject，仅当 TLS 连接时有效

    推荐使用 POST 与 PUT 方法，使用 GET 方法时明文密码可能会随 URL 被记录到传输过程中的服务器日志中。