注意:在深入研究下面的技术细节之前,我们想强调的是,Prometheus 作为一个监控系统,会收集并提供有关它所监控的系统的信息。因此,Prometheus 组件提供的 HTTP 端点不应暴露给公共可访问的网络(如互联网),除非您知道自己在做什么并已采取适当的措施。这包括(但不限于)仪表化二进制文件的 /metrics 端点、服务器组件的各种 API 端点以及用 Go 实现的服务器组件的 /pprof 端点。此外,很容易通过对这些端点的请求来过载并最终导致服务器的 DoS。

安全模型

Prometheus 是一个复杂的系统,包含许多组件以及与其他系统的许多集成。它可以部署在各种受信任和不受信任的环境中。

此页面描述了 Prometheus 的一般安全假设以及某些配置可能启用的攻击向量。

与任何复杂系统一样,几乎可以肯定会发现错误,其中一些与安全相关。如果您发现安全漏洞,请私下向相关存储库的 MAINTAINERS 中列出的维护人员报告,并抄送 [email protected]。我们将尽快修复问题并与您协调发布日期。您可以选择是否要公开承认您的努力以及是否要提及您的姓名。

自动化安全扫描器

安全扫描器用户特别注意:请注意生成的报告。大多数扫描器是通用的,会产生大量的误报。越来越多的报告被发送给我们,我们需要花费大量的工作来逐一检查所有报告并以您期望的谨慎态度回复。Go 和 NPM 依赖项扫描器的问题尤其严重。

为了对我们和我们的时间表示感谢,我们要求您不要提交原始报告。相反,请提交包含分析的报告,概述哪些具体结果适用于我们以及原因。

Prometheus 由志愿者维护,而不是由公司维护。因此,修复安全问题是在尽力而为的基础上完成的。我们努力在 7 天内发布以下安全修复:Prometheus、Alertmanager、Node Exporter、Blackbox Exporter 和 Pushgateway。

Prometheus

假设不受信任的用户可以访问 Prometheus HTTP 端点和日志。他们可以访问数据库中包含的所有时间序列信息,以及各种操作/调试信息。

还假设只有受信任的用户才能更改命令行、配置文件、规则文件以及 Prometheus 和其他组件的运行时环境的其他方面。

Prometheus 抓取哪些目标、频率以及其他设置完全由配置文件确定。管理员可以决定使用来自服务发现系统的信息,结合重新标记,可以将某些控制权授予任何可以修改该服务发现系统中数据的人。

抓取的目标可能由不受信任的用户运行。默认情况下,目标不应能够暴露伪装成不同目标的数据。honor_labels 选项会删除此保护,某些重新标记设置也是如此。

从 Prometheus 2.0 开始,--web.enable-admin-api 标志控制对管理 HTTP API 的访问,其中包括删除时间序列等功能。默认情况下,此功能处于禁用状态。如果启用,则可以通过 /api/*/admin/ 路径访问管理和更改功能。--web.enable-lifecycle 标志控制 Prometheus 的 HTTP 重新加载和关闭。默认情况下,此功能也处于禁用状态。如果启用,则可以通过 /-/reload/-/quit 路径访问它们。

在 Prometheus 1.x 中,任何有权访问 HTTP API 的人都可以访问 /-/reload 和在 /api/v1/series 上使用 DELETE/-/quit 端点默认禁用,但可以使用 -web.enable-remote-shutdown 标志启用。

远程读取功能允许任何具有 HTTP 访问权限的人员向远程读取端点发送查询。例如,如果 PromQL 查询最终直接针对关系数据库运行,则任何有权向 Prometheus 发送查询的人员(例如通过 Grafana)都可以在该数据库上运行任意 SQL。

Alertmanager

任何有权访问 Alertmanager HTTP 端点的用户都可以访问其数据。他们可以创建和解决告警。他们可以创建、修改和删除静默。

通知发送到哪里由配置文件决定。使用某些模板设置,可以将通知发送到告警定义的目标。例如,如果通知使用告警标签作为目标电子邮件地址,则任何可以向 Alertmanager 发送告警的人员都可以向任何电子邮件地址发送通知。如果告警定义的目标是可模板化的秘密字段,则任何有权访问 Prometheus 或 Alertmanager 的人都可以查看秘密。

任何可模板化的秘密字段都用于在上述用例中路由通知。它们并非旨在作为一种使用模板文件功能将秘密与配置文件分开的方式。任何存储在模板文件中的秘密都可能被任何能够在 Alertmanager 配置文件中配置接收器的人员泄露。例如,在大型设置中,每个团队可能都有一个他们完全控制的 alertmanager 配置文件片段,然后将其组合成最终的完整配置文件。

Pushgateway

任何有权访问 Pushgateway HTTP 端点的用户都可以创建、修改和删除其中包含的指标。由于 Pushgateway 通常在启用 honor_labels 的情况下抓取,这意味着任何有权访问 Pushgateway 的人都可以创建 Prometheus 中的任何时间序列。

--web.enable-admin-api 标志控制对管理 HTTP API 的访问,其中包括擦除所有现有指标组等功能。默认情况下,此功能处于禁用状态。如果启用,则可以通过 /api/*/admin/ 路径访问管理功能。

导出器

导出器通常只与一个配置的实例通信,其中包含一组预设的命令/请求,这些命令/请求无法通过其 HTTP 端点进行扩展。

还有一些导出器(如 SNMP 和 Blackbox 导出器)从 URL 参数中获取目标。因此,任何有权访问这些导出器的 HTTP 人员都可以使它们向任意端点发送请求。由于它们还支持客户端身份验证,这可能会导致秘密泄漏,例如 HTTP 基本身份验证密码或 SNMP 社区字符串。TLS 等质询响应身份验证机制不受此影响。

客户端库

客户端库旨在包含在用户的应用程序中。

如果使用客户端库提供的 HTTP 处理程序,则恶意请求到达该处理程序时不应导致超出额外负载和抓取失败的那些问题。

身份验证、授权和加密

Prometheus 和大多数导出器都支持 TLS。包括通过 TLS 客户端证书对客户端进行身份验证。有关配置 Prometheus 的详细信息,请访问此处

Go 项目共享相同的 TLS 库,该库基于 Go crypto/tls 库。我们默认使用 TLS 1.2 作为最低版本。我们关于此的政策基于 Qualys SSL Labs 的建议,我们努力通过默认配置和正确提供的证书实现 'A' 级,同时尽可能接近上游 Go 默认值。实现该等级可以在完美的安全性和可用性之间取得平衡。

未来,TLS 将添加到 Java 导出器中。

如果您有特殊的 TLS 需求,例如不同的密码套件或旧的 TLS 版本,您可以调整最低 TLS 版本和密码,只要该密码在 crypto/tls 库中没有被标记为不安全即可。如果这仍然不适合您,则当前的 TLS 设置使您可以在服务器和具有更多特殊要求的反向代理之间构建安全隧道。

HTTP 基本身份验证也受支持。基本身份验证可以在没有 TLS 的情况下使用,但这会将用户名和密码以明文形式暴露在网络上。

在服务器端,基本身份验证密码使用 bcrypt 算法存储为哈希值。您有责任选择符合您安全标准的轮数。更多的轮数会增加暴力破解的难度,但会以消耗更多的 CPU 功率和更长的请求身份验证时间为代价。

各种 Prometheus 组件支持客户端身份验证和加密。如果提供 TLS 客户端支持,通常还会有一个名为 insecure_skip_verify 的选项,该选项会跳过 SSL 验证。

API 安全

由于管理和修改端点旨在通过诸如 cURL 之类的简单工具访问,因此没有内置的 CSRF 保护,因为这会破坏此类用例。因此,在使用反向代理时,您可能希望阻止此类路径以防止 CSRF。

对于非修改端点,您可能希望在反向代理中设置 CORS 标头,例如 Access-Control-Allow-Origin,以防止 XSS

如果您正在编写包含来自不受信任用户的输入的 PromQL 查询(例如,控制台模板的 URL 参数,或您自己构建的内容),而这些用户不应能够运行任意 PromQL 查询,请确保对任何不受信任的输入进行适当的转义以防止注入攻击。例如,如果 <user_input>"} or some_metric{zzz=",则 up{job="<user_input>"} 将变为 up{job=""} or some_metric{zzz=""}

对于使用 Grafana 的用户,请注意仪表板权限不是数据源权限,因此不要限制用户在代理模式下运行任意查询的能力。

密钥

非机密信息或字段可以通过 HTTP API 和/或日志获得。

在 Prometheus 中,从服务发现检索的元数据不被认为是机密的。在整个 Prometheus 系统中,指标不被认为是机密的。

配置文件中包含密钥的字段(在文档中明确标记为密钥)不会在日志中或通过 HTTP API 公开。密钥不应放置在其他配置字段中,因为组件通常会通过其 HTTP 端点公开其配置。用户有责任保护磁盘上的文件免受不必要的读取和写入。

依赖项使用的其他来源的密钥(例如,EC2 服务发现使用的 AWS_SECRET_KEY 环境变量)可能会由于我们无法控制的代码或由于碰巧公开其存储位置的功能而最终暴露。

拒绝服务

对于过多的负载或代价高昂的查询,有一些缓解措施。但是,如果提供的查询/指标过多或代价过高,组件将会崩溃。组件更有可能被受信任的用户意外地移除,而不是恶意行为。

用户有责任确保他们为组件提供足够的资源,包括 CPU、RAM、磁盘空间、IOPS、文件描述符和带宽。

建议监控所有组件的故障,并在故障时自动重启它们。

本文档考虑从原始源代码构建的 vanilla 二进制文件。如果您修改 Prometheus 源代码,或在您自己的代码中使用 Prometheus 内部组件(超出官方客户端库 API),则此处提供的信息不适用。

构建过程

Prometheus 的构建管道在第三方提供商上运行,Prometheus 开发团队的许多成员和这些提供商的员工都可以访问。如果您担心二进制文件的确切来源,建议您自己构建它们,而不是依赖项目提供的预构建二进制文件。

Prometheus-Community

Prometheus-Community 组织下的存储库由第三方维护人员支持。

如果您在 Prometheus-Community 组织中发现安全漏洞,请将其私下报告给相关存储库的维护者,并在抄送中包含 [email protected]

该组织下的一些存储库可能具有与本文档中介绍的安全模型不同的安全模型。在这种情况下,请参阅这些存储库的文档。

外部审计

本文档是开源的。请通过提交问题或拉取请求来帮助改进它。