跳到主要内容

认证与授权

介绍​

在分布式系统中，**认证（Authentication）和授权（Authorization）**是保障安全性的两大核心机制。

  • 认证：验证用户或服务的身份（如用户名/密码、API密钥）。
  • 授权：确定已认证的用户或服务是否有权限执行特定操作（如访问某个追踪数据）。

Jaeger默认不启用认证与授权，但在生产环境中必须配置这些功能以防止未授权访问。本文将介绍如何通过Jaeger的组件（如Collector和Query）实现基础认证与授权。

1. 基础认证配置​

Jaeger支持通过以下方式实现认证：

  • HTTP基本认证（Basic Auth）
  • Bearer Token（如JWT）
  • TLS客户端证书

示例：启用HTTP基本认证​

在Jaeger Collector或Query服务的启动配置中添加环境变量：

# docker-compose.yml 示例
services:
  jaeger-query:
    environment:
      - BASIC_AUTH_USERNAME=admin
      - BASIC_AUTH_PASSWORD=securepassword

验证配置：
访问Jaeger UI时，浏览器会弹出登录窗口，输入上述用户名和密码即可。

备注

生产环境中请使用htpasswd生成密码哈希，避免明文存储。

2. 基于角色的授权​

Jaeger可以与外部授权系统（如Open Policy Agent或自定义中间件）集成，实现细粒度权限控制。

示例：通过Open Policy Agent（OPA）授权​

  1. 定义OPA策略（policy.rego）：
package jaeger.authz

default allow = false

allow {
    input.method == "GET"
    input.path = ["api", "traces"]
    input.user.roles[_] == "viewer"
}
  1. 在Jaeger Query服务中配置OPA：
environment:
  - QUERY_BEARER_TOKEN_PROPAGATION=true
  - AUTHORIZATION_HTTP_URL=http://opa:8181/v1/data/jaeger/authz
提示

角色viewer的用户只能查询追踪数据，不能执行删除或配置操作。

3. 实际案例：Kubernetes中的Jaeger安全配置​

在Kubernetes中，可以通过Ingress和ServiceAccount实现端到端安全：

  1. Ingress配置：
# Kubernetes Ingress 示例
annotations:
  nginx.ingress.kubernetes.io/auth-type: basic
  nginx.ingress.kubernetes.io/auth-secret: jaeger-basic-auth
  1. ServiceAccount授权：
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
rules:
- apiGroups: [""]
  resources: ["traces"]
  verbs: ["get", "list"]

4. 常见问题与调试​

  • 问题1：认证失败导致401 Unauthorized
    解决：检查环境变量（如BASIC_AUTH_USERNAME）是否传递到容器。

  • 问题2：授权策略未生效
    解决：通过OPA的/v1/data接口验证策略是否加载：

    curl http://opa:8181/v1/data/jaeger/authz -d '{"input": {"user": {"roles": ["viewer"]}}}'

总结​

机制适用场景工具示例
HTTP基本认证内部团队简单访问控制Nginx, Docker
JWT/OAuth2多租户或第三方集成Keycloak, Auth0
mTLS服务间通信Istio, Linkerd

附加资源：

练习：

  1. 在本地Docker中部署带Basic Auth的Jaeger Query服务。
  2. 通过curl -u admin:securepassword http://localhost:16686测试访问。