« 与 Elasticsearch 的安全通信 使用 Linux 安全计算模式 (seccomp) »
Elastic 文档 ›Heartbeat 参考 [8.14] ›安全 Heartbeat

与 Logstash 的安全通信

编辑

与 Logstash 的安全通信编辑

您可以使用 SSL 双向认证来保护 Heartbeat 和 Logstash 之间的连接。这确保 Heartbeat 仅将加密数据发送到受信任的 Logstash 服务器，并且 Logstash 服务器仅接收来自受信任的 Heartbeat 客户端的数据。

要使用 SSL 双向认证

  1. 创建一个证书颁发机构 (CA)，并使用它来签署您打算用于 Heartbeat 和 Logstash 的证书。创建正确的 SSL/TLS 基础设施超出了本文档的范围。网上有许多资源介绍如何创建证书。

    如果您使用安全功能，则可以使用 elasticsearch-certutil 工具 生成证书。

  2. 配置 Heartbeat 以使用 SSL。在 heartbeat.yml 配置文件中，在 ssl 下指定以下设置

    • certificate_authorities：配置 Heartbeat 以信任由指定 CA 签署的任何证书。如果 certificate_authorities 为空或未设置，则使用主机系统的受信任证书颁发机构。

    • certificate 和 key：指定 Heartbeat 用于向 Logstash 认证的证书和密钥。

      例如

      output.logstash:
  hosts: ["logs.mycompany.com:5044"]
  ssl.certificate_authorities: ["/etc/ca.crt"]
  ssl.certificate: "/etc/client.crt"
  ssl.key: "/etc/client.key"

      有关这些配置选项的更多信息，请参见 SSL。

  3. 配置 Logstash 以使用 SSL。在 Logstash 配置文件中，为 用于 Logstash 的 Beats 输入插件 指定以下设置

    • ssl：设置为 true 时，启用 Logstash 使用 SSL/TLS。
    • ssl_certificate_authorities：配置 Logstash 以信任由指定 CA 签署的任何证书。
    • ssl_certificate 和 ssl_key：指定 Logstash 用于向客户端认证的证书和密钥。

    • ssl_verify_mode：指定 Logstash 服务器是否将客户端证书与 CA 进行验证。您需要指定 peer 或 force_peer 以使服务器要求证书并对其进行验证。如果您指定 force_peer，并且 Heartbeat 未提供证书，则 Logstash 连接将关闭。如果您选择不使用 certutil，则您获得的证书必须允许 clientAuth 和 serverAuth（如果存在扩展密钥使用扩展）。

      例如

      input {
  beats {
    port => 5044
    ssl => true
    ssl_certificate_authorities => ["/etc/ca.crt"]
    ssl_certificate => "/etc/server.crt"
    ssl_key => "/etc/server.key"
    ssl_verify_mode => "force_peer"
  }
}

      有关这些选项的更多信息，请参见 Beats 输入插件文档。

验证 Logstash 服务器的证书编辑

在运行 Heartbeat 之前，您应该验证 Logstash 服务器的证书。您可以使用 curl 验证证书，即使用于与 Logstash 通信的协议不是基于 HTTP 的。例如

curl -v --cacert ca.crt https://logs.mycompany.com:5044

如果测试成功，您将收到一个空的响应错误

* Rebuilt URL to: https://logs.mycompany.com:5044/
*   Trying 192.168.99.100...
* Connected to logs.mycompany.com (192.168.99.100) port 5044 (#0)
* TLS 1.2 connection using TLS_DHE_RSA_WITH_AES_256_CBC_SHA
* Server certificate: logs.mycompany.com
* Server certificate: mycompany.com
> GET / HTTP/1.1
> Host: logs.mycompany.com:5044
> User-Agent: curl/7.43.0
> Accept: */*
>
* Empty reply from server
* Connection #0 to host logs.mycompany.com left intact
curl: (52) Empty reply from server

以下示例使用 IP 地址而不是主机名来验证证书

curl -v --cacert ca.crt https://192.168.99.100:5044

此测试的验证失败，因为证书对指定的 IP 地址无效。它只对 logs.mycompany.com 有效，该主机名出现在证书的主题字段中。

* Rebuilt URL to: https://192.168.99.100:5044/
*   Trying 192.168.99.100...
* Connected to 192.168.99.100 (192.168.99.100) port 5044 (#0)
* WARNING: using IP address, SNI is being disabled by the OS.
* SSL: certificate verification failed (result: 5)
* Closing connection 0
curl: (51) SSL: certificate verification failed (result: 5)

有关解决此问题的更多信息，请参见 故障排除文档。

测试 Heartbeat 到 Logstash 的连接编辑

如果您将 Heartbeat 作为服务运行，请先停止服务。然后，通过在前台运行 Heartbeat 来测试您的设置，这样您就可以快速查看出现的任何错误

heartbeat -c heartbeat.yml -e -v

任何错误都将打印到控制台。有关解决常见错误的更多信息，请参见 故障排除文档。

« 与 Elasticsearch 的安全通信 使用 Linux 安全计算模式 (seccomp) »