# 仓库今天公开，会泄露哪个客户的密钥？

> 一套代码服务多个客户时，配置与密钥要分开存放，合同终止或泄露当天，密钥必须能吊销。

原文: https://fdetimes.net/zh/guides/per-customer-config-and-secrets/

你的方案在第一个客户那里运行顺利。接着第二个客户签约，为了赶工期，你加了一行 `if customer == "B":` 来切换 CRM 地址。到第三个客户时，仓库里多了 `config_a.yaml` 和 `config_b.yaml` 两个文件，还有某人晚上 11 点提交的一个 token。

没人想故意把代码库搞乱。它是在一次次仓促交付中慢慢变坏的。对前线部署工程师（FDE）来说，这是日常，而不是极端情况：同一个产品要部署到不同的基础设施、不同的数据和不同的安全规范之下。

这里需要的能力，是分清代码、配置和密钥，再把它们各自放到该放的位置。做对了，第十个客户只需要一组新的值，而不是又一条代码分支。

## 代码不随客户变化，配置才会

Twelve-Factor App 的配置原则基于一个观察：不同部署之间，配置差异很大，代码却不变。对 FDE 而言，“一次部署”就是一个客户。每个客户都是一次部署，各有自己的 API 地址、模型名称、批大小和访问密钥。

要检验分离是否彻底，12-factor 给出了一个测试：这个代码库能否随时开源，而不暴露任何一个凭证？对 FDE 来说，这个测试还要加一条：仓库也不能透露客户名称、内部 URL，或客户的系统是如何组织的。

12-factor 选择用环境变量保存配置。对 FDE 来说，实际理由很简单：当你站在客户机房里，被允许改参数却不能重新构建镜像时，环境变量可以当场修改，不用动一行代码。

## 别让“环境”数量随客户数翻倍

很多人习惯按环境命名配置集：`dev`、`staging`、`prod`。有了三个客户，列表就变成 `prod-a`、`staging-a`、`prod-b`，用不了多久，就没人记得这些文件之间有什么区别。

更清晰的做法，是把每个客户描述成一份扁平的变量清单，标明类型并写好说明。设想一个从客户 CRM 读取工单的智能体，部署在两个地方：

| 变量 | 客户 A（假设） | 客户 B（假设） | 类型 |
|---|---|---|---|
| `TENANT_ID` | `acme` | `beta` | 配置 |
| `CRM_BASE_URL` | `https://crm.a.example` | `https://crm.b.example` | 配置 |
| `BATCH_SIZE` | 未设置，使用代码中的共享默认值 | `20` | 配置 |
| `CRM_API_TOKEN` | 存于密钥存储 | 存于密钥存储 | 密钥 |

最后一列最重要。前三行中与客户相关的值不能放在仓库里；代码中只能保留共享且无害的默认值，比如批大小。

前三个值泄露，损失主要是客户系统的信息。第四个值泄露，就是一起涉及客户的安全事件，还可能构成违约。

## 示例：缺少变量就立即停止的加载器

最危险的配置错误，往往来自一个没人注意到的默认值。应用正常启动，三天后却调用了另一个客户的 CRM。下面的加载器反其道而行：缺少必需变量就立即停止，并且从不打印密钥。

```python
# config.py：从环境变量读取配置，缺少任何一项就立即停止
import os
from dataclasses import dataclass, field

class ConfigError(RuntimeError):
    pass

def _required(name: str) -> str:
    value = os.environ.get(name)
    if not value:
        raise ConfigError(f"缺少必需的环境变量：{name}")
    return value

@dataclass(frozen=True)
class Settings:
    tenant_id: str
    crm_base_url: str
    batch_size: int
    crm_api_token: str = field(repr=False)  # 密钥：绝不出现在日志中

def load() -> Settings:
    return Settings(
        tenant_id=_required("TENANT_ID"),
        crm_base_url=_required("CRM_BASE_URL"),
        batch_size=int(os.environ.get("BATCH_SIZE", "100")),  # 共享默认值，不属于任何客户
        crm_api_token=_required("CRM_API_TOKEN"),
    )
```

有三点值得注意。代码里没有出现任何客户名称。代码中的默认值只允许用于 `BATCH_SIZE` 这类无害参数：100 是安全的共享值，不是某个客户的专属数字；需要其他值的客户自行设置变量，就像客户 B 设置为 20。

凡是决定数据流向的变量，都必须显式声明，不设默认值。而 `repr=False` 保证调试时随手一个 `print(settings)` 也不会把 token 泄露到客户的日志里。

## 在 Kubernetes 上：配置用 ConfigMap，密钥用 Secret

如果客户使用 Kubernetes，ConfigMap 自然是前三个变量的归宿，它本就用于存放随环境变化的非敏感设置。一个镜像，多个客户集群。

```yaml
envFrom:
  - configMapRef:
      name: app-config-customer-b
  - secretRef:
      name: app-secrets-customer-b
```

陷阱在第二项。Kubernetes 文档明确指出，ConfigMap 不提供任何保密或加密能力，敏感数据必须放进 Secret，这样密码和 token 才不会出现在应用代码里。但即便是 Secret，默认也以未加密形式存储在 etcd 中，任何能访问 API 或 etcd 的人都能读取。

因此，Secret 只有在额外加固后才安全。在与客户基础设施团队的启动会上，直接问清楚：这个集群是否启用了 Secret 加密？目前谁对这个命名空间里的 Secret 有读取权限？

**要点:** 配置可以各不相同，密钥必须相互隔离，两者永远不放在同一个地方。

## 密钥需要有效期

永不过期的 token 是一颗潜伏的雷，只等泄露那天引爆。OWASP 建议定期轮换密钥，让被盗凭证只能在很短时间内使用，并把密钥的存储、分发、审计和轮换集中到一处管理。

Vault 通过租约（lease）把这一思路更进一步。租约被吊销后，密钥立即失效，也无法再续期。

这彻底改变了 FDE 面对的两种最棘手局面：与客户的合同终止时，吊销该客户的租约即可，不用逐台机器排查；怀疑泄露时，先吊销，再调查。

客户之间的边界也必须同样清晰。在多租户系统中，每个租户的密钥都需要严格隔离，例如每个租户使用独立的存储，且不在客户之间共用同一把加密密钥，这样一个客户出事，不会波及其他客户。

在 CI/CD 流水线中，这意味着每个客户使用独立的服务账号：为客户 B 部署的流水线，没有任何理由能读取客户 A 的 token。

## 现场让配置出错的四个错误

最常见的是让客户名称混进代码，哪怕只是一条“临时” `if` 分支。其次是给决定数据流向的变量设默认值。再次是把 token 放进 ConfigMap，理由是“反正在客户集群里”。

最后一个更隐蔽：你的开发机跑 SQLite，客户跑 Postgres，配置直到到了现场才出问题。12-factor 建议让开发环境与生产环境尽可能一致，让差异只存在于配置中。在自己机器上，使用与客户同类的数据库和同类的队列。

## 客户 B 要走了，token 可能已泄露，怎么办？

这个问题值得在客户提出之前就演练一遍，也是 FDE 面试前很好的练习场景。OWASP 把快速响应已暴露的密钥列为重点关注事项之一。

好的回答会逐层处理：吊销 B 的租约，确认 B 的 CI 服务账号碰不到其他任何客户的密钥，为仍在运行的部分签发新密钥，把所有操作记入审计日志，并且完全不改代码。

如果你在真实项目中做过这件事，就把它写进简历，用一句具体的话：客户数量、密钥如何隔离、吊销花了多长时间。

到交付第十个客户时，你的工作只是填一份变量清单、创建一个新租约。代码库始终干净到随时可以开源。

**本周动手试试:**

- 在你正要交付的仓库里 grep 客户名称、内部 URL 和疑似 token 的字符串，记下所有需要改为环境变量的位置。
- 为项目写一个 load() 函数：所有必需变量都必须存在，缺少任何一个就停止程序，密钥绝不出现在 repr 或日志中。
- 检查你的 CI/CD 服务账号：它能否同时读取多个客户的密钥？如果能，拆分为每个客户一个账号。

## 信源

- [The Twelve-Factor App – Config](https://12factor.net/config)

- [The Twelve-Factor App – Dev/prod parity](https://12factor.net/dev-prod-parity)

- [Secrets | Kubernetes](https://kubernetes.io/docs/concepts/configuration/secret/)

- [ConfigMaps | Kubernetes](https://kubernetes.io/docs/concepts/configuration/configmap/)

- [Lease, renew, and revoke | Vault | HashiCorp Developer](https://developer.hashicorp.com/vault/docs/concepts/lease)

- [Secrets Management Cheat Sheet – OWASP Cheat Sheet Series](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)

- [How to Implement Tenant-Specific Secret Stores with Dapr](https://oneuptime.com/blog/post/2026-03-31-dapr-tenant-specific-secret-stores/markdown)

- [Establish multi-tenant security for B2B SaaS applications](https://prismatic.io/blog/establish-multi-tenant-security-for-b2b-saas-applications/)
