If you discover a security vulnerability in this project, please report it responsibly following our coordinated vulnerability disclosure process.

如果你在此项目中发现安全漏洞，请遵循我们的协调漏洞披露流程进行负责任的报告。

DO NOT open a public GitHub issue for security vulnerabilities.

不要为安全漏洞开公开的 GitHub issue。

Instead, please use one of the following methods: 请采用以下方式之一：

1. GitHub Private Vulnerability Reporting (Recommended) Report directly via: https://github.com/StringKe/cloudflare-operator/security/advisories/new

   GitHub 私密漏洞报告（推荐） 直接通过以下链接报告：https://github.com/StringKe/cloudflare-operator/security/advisories/new

2. Email Send vulnerability details to: stringke.me@gmail.com

   邮件 将漏洞详情发送至：stringke.me@gmail.com

• Description of the vulnerability / 漏洞描述
• Steps to reproduce / 复现步骤
• Potential impact / 潜在影响
• Affected versions / 受影响的版本
• Suggested fix (if any) / 建议的修复方案（如有）

We follow the principle of Coordinated Vulnerability Disclosure (CVD):

我们遵循协调漏洞披露 (CVD) 原则：

1. Private Reporting: Vulnerabilities are reported privately to maintainers 私密报告：漏洞私密报告给维护者

2. Assessment: We assess the vulnerability severity and impact 评估：我们评估漏洞的严重性和影响

3. Fix Development: We develop and test a fix 修复开发：我们开发并测试修复方案

4. Public Disclosure: After the fix is released, we publicly disclose the vulnerability 公开披露：修复发布后，我们公开披露漏洞信息

• Initial response: Within 48 hours / 初始响应：48 小时内
• Status update: Within 7 days / 状态更新：7 天内
• Vulnerability assessment: Within 14 days / 漏洞评估：14 天内
• Fix for critical vulnerabilities: Within 30 days / 关键漏洞修复：30 天内
• Fix for high/medium vulnerabilities: Within 90 days / 高/中危漏洞修复：90 天内
• Public disclosure: After fix is released or 90 days, whichever comes first 公开披露：修复发布后或 90 天后（以先到者为准）

When using this operator, follow these security practices:

使用此 operator 时，请遵循以下安全实践：

# ✅ Use Kubernetes Secrets for API tokens
apiVersion: v1
kind: Secret
metadata:
  name: cloudflare-credentials
type: Opaque
stringData:
  CLOUDFLARE_API_TOKEN: "<token>"

# ❌ Never hardcode tokens in CRDs
# spec:
#   cloudflare:
#     apiToken: "hardcoded-token"  # WRONG!

• Use least-privilege principles

• 使用最小权限原则

• Restrict access to Cloudflare credential secrets

• 限制对 Cloudflare 凭证 secret 的访问

• Use separate namespaces for different environments

• 为不同环境使用独立的命名空间

# Restrict secret access to specific service accounts
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: cloudflare-secret-reader
rules:
  - apiGroups: [""]
    resources: ["secrets"]
    resourceNames: ["cloudflare-credentials"]
    verbs: ["get"]

Consider implementing network policies to restrict operator communication:

考虑实施网络策略以限制 operator 通信：

apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: cloudflare-operator-egress
  namespace: cloudflare-operator-system
spec:
  podSelector:
    matchLabels:
      control-plane: controller-manager
  policyTypes:
    - Egress
  egress:
    # Allow Cloudflare API
    - to:
        - ipBlock:
            cidr: 0.0.0.0/0
      ports:
        - port: 443
          protocol: TCP

Enable Kubernetes audit logging to track: 启用 Kubernetes 审计日志以跟踪：

• Secret access / Secret 访问
• CRD modifications / CRD 修改
• Operator actions / Operator 操作

Regularly rotate Cloudflare API tokens: 定期轮换 Cloudflare API token：

1. Create new token in Cloudflare Dashboard 在 Cloudflare 控制台创建新 token

2. Update Kubernetes Secret 更新 Kubernetes Secret

3. Verify operator functionality 验证 operator 功能

4. Revoke old token 撤销旧 token

The operator sanitizes error messages in Kubernetes events to prevent credential leakage. However:

Operator 会清理 Kubernetes 事件中的错误消息以防止凭证泄露。但是：

• Review operator logs for sensitive information

• 检查 operator 日志中是否有敏感信息

• Configure log levels appropriately in production

• 在生产环境中适当配置日志级别

Tunnel credentials are stored in Kubernetes Secrets. Ensure: 隧道凭证存储在 Kubernetes Secrets 中。请确保：

• Encryption at rest is enabled

• 启用静态加密

• Access is restricted via RBAC

• 通过 RBAC 限制访问

• Secrets are not exposed in ConfigMaps or logs

• Secrets 不会在 ConfigMaps 或日志中暴露

Security updates will be released as patch versions when possible. Monitor:

安全更新将尽可能作为补丁版本发布。请关注：

• GitHub Releases for security patches
• GitHub Security Advisories
• This SECURITY.md for policy updates