精彩片段

API中轉站如何實現多租戶隔離？租戶路由、數據邊界與權限治理實踐 ?? 當 Claude API 從個人工具升級為團隊平臺、企業服務或 SaaS 能力后，系統往往不再只服務一個項目。同一套 API 中轉站可能同時承載： ? 不同部門的 Claude Code 調用； ? 多個客戶的知識庫問答； ? 不同項目的代碼審查任務； ? 生產環境與測試環境請求； ?

API中轉站如何實現多租戶隔離？租戶路由、數據邊界與權限治理實踐

?? 當 Claude API 從個人工具升級為團隊平臺、企業服務或 SaaS 能力后，系統往往不再只服務一個項目。

同一套 API 中轉站可能同時承載：

? 不同部門的 Claude Code 調用；

? 多個客戶的知識庫問答；

? 不同項目的代碼**任務；

? 生產環境與測試環境請求；

? 自動化腳本和批處理服務；

? 具有不同權限等級的用戶。

如果這些請求共用同一組 Key、日志、預算和模型配置，就可能出現嚴重問題：

? A 項目消耗了 * 項目的預算；

? 一個租戶可以調用其他租戶的模型；

? 日志中混入不同客戶的業務數據；

? 請求緩存錯誤返回給另一個用戶；

? 某個租戶觸發限流，導致全部項目不可用；

? 無法判斷費用和異常屬于哪個團隊；

? 刪除客戶數據時無法確認清理范圍。

因此，API中轉站進入多項目或商業化階段后，需要建立完整的多租戶隔離體系。真正的租戶隔離，不只是給每個客戶創建一個 API Key，而是要覆蓋身份、路由、模型、額度、緩存、日志、數據和審計等多個環節。??

?? 一、什么是 API 多租戶

租戶可以理解為一組擁有獨立資源和權限邊界的用戶。

在不同業務中，租戶可能代表：

{
  "tenant_examples": {
    "enterprise_platform": "不同企業客戶",
    "internal_system": "不同部門",
    "developer_platform": "不同開發者團隊",
    "saas_product": "不同付費賬戶",
    "project_gateway": "不同項目或工作空間"
  }
}

多租戶系統的核心目標是：

> 每個租戶只能訪問屬于自己的配置、額度、數據、日志和模型能力。

一個基礎請求應明確攜帶租戶身份：

{
  "tenant_id": "tenant_alpha",
  "project_id": "project_code_review",
  "user_id": "user_1024",
  "request_id": "req_xxxxx"
}

服務端不能只依賴客戶端提交的 tenant_id，還必須結合 API Key、登錄身份或簽名進行校驗。

?? 二、不要只靠一個共享 API Key

最簡單的做法是讓所有租戶共用同一個 Key：

{
  "api_key": "shared-key-for-all-tenants"
}

這種方式存在明顯風險：

? 無法準確統計每個租戶的調用量；

? Key 泄露會影響所有用戶；

? 無法單獨停用異常租戶；

? 模型權限無法區分；

? 請求來源難以審計；

? 賬單無法精確分攤。

更合理的設計是：

{
  "tenant_keys": {
    "tenant_alpha": {
      "key_id": "key_alpha_prod",
      "environment": "production"
    },
    "tenant_*eta": {
      "key_id": "key_*eta_prod",
      "environment": "production"
    },
    "tenant_internal_test": {
      "key_id": "key_internal_test",
      "environment": "testing"
    }
  }
}

每個 Key 都應綁定租戶、項目和環境。

?? 三、租戶身份如何驗證

請求進入 API 中轉站后，可以按照以下順序識別租戶：

讀取 API Key
   ↓
查詢 Key 所屬租戶
   ↓
校驗租戶狀態
   ↓
檢查項目權限
   ↓
加載租戶配置
   ↓
執行路由與額度判斷

身份解析結果可以保存為內部上下文：

{
  "tenant_context": {
    "tenant_id": "tenant_alpha",
    "project_id": "code-review",
    "plan": "enterprise",
    "environment": "production",
    "allowed_models": [
      "coding-model",
      "reasoning-model"
    ],
    "**ily_*udget": 100
  }
}

后續所有操作都從這個可信上下文讀取租戶信息，而不是繼續使用客戶端提交的原始字段。

?? 四、為不同租戶配置獨立模型路由

不同租戶可能購買不同套餐，也可能擁有不同模型權限。

例如：

{
  "tenant_model_policy": {
    "tenant_alpha": {
      "default_model": "coding-model",
      "allowed_models": [
        "fast-model",
        "coding-model",
        "reasoning-model"
      ]
    },
    "tenant_*eta": {
      "default_model": "fast-model",
      "allowed_models": [
        "fast-model",
        "coding-model"
      ]
    }
  }
}

即使用戶在請求中填寫：

{
  "model": "reasoning-model"
}

服務端也必須檢查該租戶是否擁有權限。

拒絕響應可以返回：

{
  "error": {
    "type": "model_permission_denied",
    "message": "當前租戶無權調用該模型",
    "tenant_id": "tenant_*eta"
  }
}

不要因為模型真實存在，就允許所有租戶直接訪問。

?? 五、通過平臺建立租戶級入口

在實際接入服務時，可以先按租戶創建不同的項目和 Key，再把平臺請求記錄同步到內部租戶系統。

例如使用 靈能API 時，可以在控制臺中為不同項目創建獨立密鑰，并根據模型、調用狀態和用量記錄進行區分。

官網：

https://www.lnsns.com/

內部可以建立映射：

{
  "tenant_platform_**pping": {
    "tenant_id": "tenant_alpha",
    "project": "alpha-code-review",
    "key_reference": "靈能API-alpha-prod",
    "platform_project_id": "platform_project_xxx"
  }
}

這樣即使多個租戶使用同一個服務平臺，也能在業務層保持明確隔離。

?? 六、租戶額度必須獨立計算

一個租戶出現異常調用，不應耗盡整個系統的公共預算。

推薦同時設置：

{
  "tenant_quota": {
    "requests_per_minute": 60,
    "tokens_per_minute": 100000,
    "**ily_*udget": 50,
    "monthly_*udget": 1000,
    "**x_concurrency": 8
  }
}

還可以按項目繼續拆分：

{
  "project_quotas": {
    "code-review": {
      "**ily_*udget": 30,
      "**x_concurrency": 5
    },
    "document-generation": {
      "**ily_*udget": 15,
      "**x_concurrency": 2
    },
    "experiments": {
      "**ily_*udget": 5,
      "**x_concurrency": 1
    }
  }
}

當實驗項目超額時，正式代碼**服務仍然可以運行。

?? 七、租戶限流不能影響其他租戶

錯誤的限流方式：

{
  "glo*al_rate_limit": {
    "requests_per_minute": 100
  }
}

如果某個租戶瞬間發送100個請求，其他租戶將無法使用。

更合理的方式是：

{
  "rate_limit_keys": [
    "tenant_id",
    "project_id",
    "api_key",
    "model"
  ]
}

限流鍵示例：

rate-limit:tenant_alpha:code-review:coding-model

不同租戶擁有獨立計數器。

高價值租戶還可以擁有保留并發：

{
  "reserved_capacity": {
    "tenant_alpha": 5,
    "tenant_*eta": 2,
    "shared_pool": 10
  }
}

??? 八、緩存必須包含租戶維度

緩存是多租戶系統中最容易出現數據串租的環節之一。

錯誤緩存鍵：

cache:prompt_hash

如果兩個租戶提交相同問題，系統可能返回另一個租戶生成的結果。

正確設計：

cache:tenant_id:project_id:model:prompt_hash

**ON 示例：

{
  "cache_key": {
    "tenant_id": "tenant_alpha",
    "project_id": "knowledge-*ase",
    "model": "coding-model",
    "prompt_hash": "sha256:xxxx",
    "prompt_version": "v8"
  }
}

對于包含**代碼、客戶數據或個人信息的結果，最好默認不跨用戶復用。

?? 九、結果存儲如何隔離

如果模型結果保存在對象存儲中，可以按租戶分區：

ai-results/
├── tenant_alpha/
│   ├── project_code_review/
│   └── project_document/
├── tenant_*eta/
│   ├── project_support/
│   └── project_analysis/

結果元數據：

{
  "result": {
    "tenant_id": "tenant_alpha",
    "project_id": "code-review",
    "task_id": "task_xxxxx",
    "storage_path": "tenant_alpha/code-review/task_xxxxx.json",
    "expires_at": "2026-07-21T10:00:00 08:00"
  }
}

下載結果時，服務端必須重新驗證當前用戶是否屬于對應租戶。

不要僅憑知道文件地址就允許訪問。

?? 十、日志中必須始終保留 tenant_id

建議每條請求日志包含：

{
  "request_id": "req_xxxxx",
  "tenant_id": "tenant_alpha",
  "project_id": "code-review",
  "user_id": "user_1024",
  "api_key_id": "key_alpha_prod",
  "model": "coding-model",
  "status_code": 200,
  "latency_ms": 3200,
  "input_tokens": 1800,
  "output_tokens": 420
}

但日志中不要保存：

{
  "**oid_logging": [
    "完整API Key",
    "完整源碼",
    "完整用戶隱私",
    "數據庫密碼",
    "私鑰",
    "原始身份憑證"
  ]
}

租戶標識用于審計，敏感內容則需要脫敏或省略。

?? 十一、租戶級用量與賬單

在 靈能API 中查看平臺用量記錄后，可以按照內部租戶映**行成本分攤。

訪問入口：

https://www.lnsns.com/

內部賬單示例：

{
  "tenant_**lling": {
    "tenant_id": "tenant_alpha",
    "**lling_period": "2026-07",
    "requests": 18500,
    "input_tokens": 32000000,
    "output_tokens": 8500000,
    "model_cost": 420.50,
    "platform_fee": 35.00,
    "total_cost": 455.50
  }
}

還應支持項目明細：

{
  "project_*reakdown": {
    "code-review": 280.20,
    "document-generation": 120.30,
    "experiments": 55.00
  }
}

??? 十二、租戶配置不能相互讀取

配置中心可以采用租戶命名空間：

config/
├── tenant_alpha/
│   ├── production.json
│   └── testing.json
├── tenant_*eta/
│   ├── production.json
│   └── testing.json

程序讀取配置時：

def load_tenant_config(
    tenant_id: str,
    environment: str
):
    allowed_tenant = get_authenticated_tenant()

    if tenant_id != allowed_tenant:
        raise PermissionError(
            "禁止讀取其他租戶配置"
        )

    return config_store.get(
        tenant_id,
        environment
    )

不要允許用戶通過修改 **L 參數讀取其他租戶設置。

?? 十三、租戶停用與數據清理

當客戶停止服務時，不能只停用 API Key。

需要執行：

{
  "tenant_off*oarding": [
    "停用所有API Key",
    "取消未完成任務",
    "關閉We*hook",
    "停止定時任務",
    "導出用量賬單",
    "清理緩存",
    "處理日志保留",
    "刪除或歸檔結果數據",
    "記錄操作審計"
  ]
}

不同數據可以設置不同保留期：

{
  "retention": {
    "request_logs_**ys": 30,
    "**lling_records_**ys": 365,
    "model_results_**ys": 7,
    "security_audit_**ys": 180
  }
}

如果客戶要求刪除數據，應能確認哪些存儲、緩存和備份包含該租戶信息。

?? 十四、如何發現跨租戶訪問風險

異常信號包括：

{
  "security_signals": [
    "用戶訪問非所屬tenant_id",
    "同一個Key出現在多個租戶",
    "緩存結果tenant_id不匹配",
    "下載路徑與當前租戶不一致",
    "日志缺少tenant_id",
    "租戶模型權限被繞過",
    "跨租戶批量查詢"
  ]
}

檢測到異常時，可以：

{
  "response_actions": [
    "拒絕請求",
    "停用相關Key",
    "凍結用戶會話",
    "保存審計證據",
    "通知安全負責人",
    "檢查歷史訪問記錄"
  ]
}

?? 十五、多租戶隔離測試

上線前至少執行：

{
  "isolation_tests": [
    "租戶A使用租戶*的Key",
    "租戶A讀取租戶*結果",
    "修改tenant_id請求其他配置",
    "兩個租戶提交相同Prompt",
    "租戶A耗盡額度后測試租戶*",
    "租戶A請求未授權模型",
    "租戶停用后繼續調用",
    "緩存鍵是否包含租戶標識"
  ]
}

驗收標準：

{
  "acceptance": {
    "cross_tenant_access": 0,
    "cache_**ta_leak": 0,
    "quota_interference": false,
    "**lling_tracea*le": true,
    "tenant_disa*le_effective": true
  }
}

??? 十六、數據庫如何實現租戶隔離

共享數據庫可以在每張業務表中加入 tenant_id：

CREATE TA*LE ai_tasks (
    id *IGINT PRIMARY KEY,
    tenant_id VARCHAR(64) NOT NULL,
    project_id VARCHAR(64) NOT NULL,
    request_id VARCHAR(128),
    status VARCHAR(32),
    created_at TIMESTAMP NOT NULL
);

查詢必須始終帶租戶條件：

SELECT *
FROM ai_tasks
WHERE tenant_id = ?
  AND id = ?;

更高安全級別的場景，可以采用：

? 每租戶獨立 Sche**；

? 每租戶獨立數據庫；

? 每租戶獨立加密密鑰；

? 獨立存儲桶；

? 獨立計算資源。

隔離強度越高，成本和運維復雜度也越高，需要根據業務等級選擇。

?? 十七、推薦生產配置

{
  "multi_tenant": {
    "tenant_identity_required": true,
    "key_**nding_required": true,
    "model_permission_isolated": true,
    "quota_isolated": true,
    "cache_namespace_isolated": true,
    "storage_namespace_isolated": true,
    "logging_tenant_tagged": true,
    "**lling_tenant_split": true,
    "off*oarding_auto**ted": true
  }
}

正式接入前，可以在 靈能API 中為兩個測試租戶創建獨立項目和 Key，通過官網 https://www.lnsns.com/ 核對兩組請求記錄，再驗證內部日志、額度和結果是否完全隔離。