安全的移动访问
本页面介绍了确保 Zabbix 移动应用和 Zabbix bridge adapter 安全的最佳实践。
保护移动设备
为防止他人打开您移动设备上的应用,请在应用的 设置 中启用应用锁。
如果设备丢失或遭到入侵,请在 Zabbix 前端中将其移除。 这会撤销并移除设备的访问凭据,因此该设备将无法再访问 Zabbix。 根据您的用户角色权限,您可以在以下部分移除设备:
您还可以限制移动设备可以访问 Zabbix 的哪些部分。 为此,请为用户分配一个仅授予应用所需权限的用户角色。 所需的最小权限如下:
| 部分 | 配置 |
|---|---|
| 访问 UI 元素 | 清除所有复选框。 |
| 访问服务 | 将 对服务的读写访问权限 和 对服务的只读访问权限 设置为 None。 |
| 访问模块 | 清除所有复选框。 |
| 访问 API | 清除 已启用 复选框。 |
| 访问操作 | 清除所有复选框。 若要允许用户在应用中更新问题,还应勾选他们所需的操作: - 添加问题评论 - 更改严重性 - 确认问题 - 抑制问题 - 关闭问题 请注意,用户可以在应用中看到的问题还取决于其对主机的访问权限。 若要允许用户更改接收的推送通知(例如严重性和活动时段),还应勾选 创建和编辑自己的媒介。这样,他们就可以编辑自己的媒介,包括推送通知以外的媒介。 |
| 设备 | 勾选 已启用 复选框。 若要允许用户添加和移除自己的移动设备,还应勾选 管理自己的设备 复选框;否则,超级管理员 必须在 用户 > 设备 中管理他们的设备。 |
保护 Zabbix bridge adapter
Zabbix bridge adapter 将其数据(状态文件和加密密钥)存储在 Zabbix bridge adapter 配置文件中 DataDir 参数指定的目录中。
请确保该目录的权限为 0700,并且其中存储的所有文件的权限均为 0600。
Zabbix bridge adapter 将来自移动设备的请求传递给 Zabbix API。
要限制可通过 Zabbix bridge adapter 调用的 API 方法,请使用其 AllowedAPIMethods 参数。
例如,仅允许移动应用所需的最小方法集;如果不希望使用某些移动应用功能,也可以允许更少的方法(例如,如果移动应用用户不应更新问题,请不要允许使用 event.acknowledge)。
Zabbix bridge adapter 在其 ListenPort 上接受来自 Zabbix 服务器的连接。
除非将 TLSConfig.Mode 设置为 mtls,否则 Zabbix bridge adapter 会接受来自任何能够访问此端口的主机的连接。
仅允许 Zabbix 服务器连接此端口(例如使用防火墙;或者在 Zabbix bridge adapter 和 Zabbix 服务器运行在同一系统上时,将 ListenIP 设置为 127.0.0.1),或者使用 mTLS。
Zabbix bridge adapter 在 ListenHealthPort 上提供的健康检查端点始终使用未加密的 HTTP,且不进行身份验证;其错误消息可能会泄露有关您环境的详细信息。
如果不受信任的网络可以访问此端口,请限制对该端口的访问(例如使用防火墙)。
加密组件之间的连接
如果 Zabbix bridge adapter、Zabbix 服务器和 Zabbix 前端(提供 Zabbix API)安装在不同的系统上,建议对它们之间的数据流进行加密。 本节介绍如何保护这些连接:
- 从 Zabbix 服务器到 Zabbix bridge adapter
- 从 Zabbix bridge adapter 到 Zabbix 前端(API)
本节不介绍如何管理证书。 有关一般指导,请参阅使用证书进行加密。
从 Zabbix 服务器到 Zabbix bridge adapter 的 TLS
Zabbix 服务器使用其 BridgeAdapterURL 参数中指定的 URL 连接到 Zabbix bridge adapter。
bridge adapter 使用其 TLSConfig.Mode 参数确定接受哪些连接:
none(默认)- 仅接受未加密的连接。BridgeAdapterURL必须使用http://。tls- 仅接受加密连接;bridge adapter 向 Zabbix 服务器提供其证书。BridgeAdapterURL必须使用https://。mtls- 除了tls的功能外,bridge adapter 还会验证 Zabbix 服务器的客户端证书。
配置 tls:
1. 选择用于签发 Zabbix bridge adapter 证书的 CA:
- 已签发 Zabbix 服务器当前使用的证书的 CA - 如果 Zabbix 服务器对 Zabbix proxy 或 agent 使用基于证书的加密,请选择此项(其
TLSCAFile、TLSCertFile和TLSKeyFile参数已设置)。 - 其证书位于 Zabbix 服务器所在操作系统的 CA 存储中的 CA(例如公共 CA)。
- 任何其他 CA(例如组织的私有 CA)。
2. 如果在步骤 1 中选择了其他 CA,请在 Zabbix 服务器所在的系统上准备以下文件,且所有文件均为 PEM 格式:
- 包含所选 CA 证书的 CA 文件。
- 由所选 CA 签发的服务器证书(或证书链)。
- 服务器私钥;确保只有运行服务器的用户(通常为
zabbix)可以读取该私钥。
3. 编辑 Zabbix 服务器配置文件:
BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc
# 如果在步骤 1 中选择了其他 CA(如果选择了 Zabbix 服务器当前使用的 CA,则已设置):
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key
4. 在安装 Zabbix bridge adapter 的系统上准备以下文件,且所有文件均为 PEM 格式:
- 由所选 CA 签发的 bridge adapter 证书(或证书链);确保其 Subject Alternative Name (SAN) 扩展包含 Zabbix 服务器
BridgeAdapterURL中的主机名或 IP 地址。 - bridge adapter 私钥;确保只有运行 bridge adapter 的用户(通常为
zabbix-bridge-adapter)可以读取该私钥。
5. 编辑 Zabbix bridge adapter 配置文件:
TLSConfig.Mode=tls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key
6. 重启 Zabbix bridge adapter:
systemctl restart zabbix-bridge-adapter
7. 重启 Zabbix 服务器。 例如(参见其他选项):
systemctl restart zabbix-server
配置 mtls:
1. 选择用于签发 Zabbix 服务器和 Zabbix bridge adapter 证书的 CA:
- 已签发 Zabbix 服务器当前使用的证书的 CA - 如果 Zabbix 服务器对 Zabbix proxy 或 agent 使用基于证书的加密,请选择此项(其
TLSCAFile、TLSCertFile和TLSKeyFile参数已设置)。 - 任何其他 CA(例如组织的私有 CA)。
2. 如果在步骤 1 中选择了其他 CA,请在 Zabbix 服务器所在的系统上准备以下文件,且所有文件均为 PEM 格式:
- 包含所选 CA 证书的 CA 文件。
- 由所选 CA 签发的服务器证书(或证书链)。
- 服务器私钥;确保只有运行服务器的用户(通常为
zabbix)可以读取该私钥。
3. 编辑 Zabbix 服务器配置文件:
BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc
# 如果选择了 Zabbix 服务器当前使用的 CA,则已设置:
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key
4. 在安装 Zabbix bridge adapter 的系统上准备以下文件,且所有文件均为 PEM 格式:
- 包含所选 CA 证书的 CA 文件(即使是公共 CA,也必须提供,因为 bridge adapter 不使用操作系统的 CA 存储)。
- 由所选 CA 签发的 bridge adapter 证书(或证书链);确保其 Subject Alternative Name (SAN) 扩展包含 Zabbix 服务器
BridgeAdapterURL中的主机名或 IP 地址。 - bridge adapter 私钥;确保只有运行 bridge adapter 的用户(通常为
zabbix-bridge-adapter)可以读取该私钥。
5. 编辑 Zabbix bridge adapter 配置文件:
TLSConfig.Mode=mtls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key
TLSConfig.CAFile=/etc/zabbix/certs/zabbix_ca_file.crt
# Zabbix 服务器证书的 Common Name (CN)(必须完全匹配,区分大小写;不会检查 SAN):
TLSConfig.AllowedCN=zabbix-server
6. 重启 Zabbix bridge adapter:
systemctl restart zabbix-bridge-adapter
7. 重启 Zabbix 服务器。 例如(参见其他选项):
systemctl restart zabbix-server
从 Zabbix bridge adapter 到 Zabbix API 的 TLS
Zabbix bridge adapter 使用其 ZabbixAPIURL 参数中指定的 URL 连接到 Zabbix API。
bridge adapter 使用其 ZabbixAPITLSConnect 参数确定验证 Zabbix 前端证书的严格程度:
disabled- 连接未加密。仅在使用此选项时,ZabbixAPIURL必须使用http://。required(默认)- 连接已加密,但 bridge adapter 接受任何证书。verify_ca- 连接已加密,且证书必须由ZabbixAPITLSCAFile文件中的 CA 签发。verify_full- 连接已加密,证书必须由ZabbixAPITLSCAFile文件中的 CA 签发,并且ZabbixAPIURL中的主机名必须与证书匹配。
配置 required、verify_ca 或 verify_full:
1. 在安装 Zabbix 前端的系统上,确保:
- Zabbix 前端通过 HTTPS 提供服务(参见为 Zabbix 前端设置 SSL)。
- 对于
verify_full,Zabbix 前端证书的主题备用名称(SAN)扩展中包含 bridge adapter 的ZabbixAPIURL中的主机名或 IP 地址。
2. 对于 verify_ca 和 verify_full,在安装 Zabbix bridge adapter 的系统上,准备一个包含签发 Zabbix 前端证书的 CA 证书的 PEM 文件。
- 如果 Zabbix 前端证书是自签名证书,则该文件包含 Zabbix 前端证书本身。
- 如果 Zabbix 前端证书由公共 CA 签发,则该文件可以是操作系统的 CA 捆绑包(例如 Ubuntu 上的
/etc/ssl/certs/ca-certificates.crt)。 bridge adapter 仅使用此文件中的 CA 证书,不使用操作系统的 CA 存储。 - 确保运行 bridge adapter 的用户(通常为
zabbix-bridge-adapter)可以读取该 PEM 文件。
3. 编辑 Zabbix bridge adapter 配置文件:
ZabbixAPIURL=https://zabbix.example.com/zabbix/api_jsonrpc.php
# 对于 required、verify_ca 或 verify_full:
ZabbixAPITLSConnect=verify_full
# 对于 verify_ca 或 verify_full:
ZabbixAPITLSCAFile=/etc/zabbix/certs/zabbix_api_ca.crt
4. 重启 Zabbix bridge adapter:
systemctl restart zabbix-bridge-adapter