main/%E9%A1%B9%E7%9B%AE%E7%9B%B8%E5%85%B3%E6%96%87%E6%A1%A3/2026-07-16%E4%BB%A3%E7%A0%81%E4%BC%98%E5%8C%96.md

# 2026-07-16 泰额版代码优化
本文档说明 **泰额版后端** 当日对 `tenant-select` 出参、默认管理员凭据加密及 Web 登录入参的改造。仅涉及泰额版 `Yi.Abp.Net8`，前端需同步对接。
---
## 一、变更概述
| 项 | 说明 |
|----|------|
| 接口 | `GET /api/app/th-multi-tenancy/tenant-select` |
| 目的 | 登录页展示租户列表时不再暴露租户 Id、数据库连接串；改为返回创建时间与可解密的默认管理员凭据 |
| 登录 | `POST /api/app/th-web-auth/login` 支持 `tenantName` 替代 `tenantId` |
| 配置 | 新增 `FoodLabeling:TenantSelectCrypto:SecretKey` |
---
## 二、tenant-select 出参变更
### 2.1 新旧字段对比
| 旧字段 | 新字段 | 说明 |
|--------|--------|------|
| `id` | — | **已移除**，不再返回租户 Guid |
| `name` | `name` | 保留，租户名称 |
| — | `creationTime` | **新增**，租户创建时间（主库 `yitenant`） |
| — | `loginAccount` | **新增**，默认管理员账号，固定为 `admin`（与 `UserDataSeed` 一致） |
| — | `password` | **新增**，AES-CBC 加密后的 Base64 密文（**非**库内不可逆哈希） |
| — | `passwordSalt` | **新增**，AES IV 的 Base64，前端解密时使用 |
| `tenantConnectionString` / 连接串相关 | — | **从未在此接口返回**；仍不暴露 |
### 2.2 出参示例
```json
[
  {
    "name": "Default",
    "creationTime": "2026-01-15T10:30:00",
    "loginAccount": "admin",
    "password": "xK3mP9vL2nQ8wR1sT4uV7yZ0aB5cD6eF8gH9iJ0kL1m=",
    "passwordSalt": "AbCdEfGhIjKlMnOpQrStUvWxYz0123=="
  }
]
```
> 每条记录的 `password` / `passwordSalt` 因随机 IV 而不同；明文来源均为 `RbacOptions.AdminPassword`（当前默认 `123456`）。
---
## 三、密码加盐加密与前端解密
### 3.1 算法约定
| 项 | 值 |
|----|-----|
| 算法 | AES-256-CBC |
| 填充 | PKCS7 |
| Key | `SHA256(UTF8(SecretKey))` → 32 字节 |
| IV | 每次加密随机 16 字节，Base64 写入 `passwordSalt` |
| 密文 | Base64 写入 `password` |
| 明文 | `RbacOptions.AdminPassword`（appsettings，与种子管理员一致） |
### 3.2 后端配置
`appsettings.json`：
```json
"FoodLabeling": {
  "TenantSelectCrypto": {
    "SecretKey": "FoodLabelingThTenantSelect2026Key!"
  }
}
```
- `SecretKey` 为前后端约定的字符串，**不要求**本身为 32 字节；后端用 SHA256 派生 AES-256 密钥。
- 生产环境请更换为足够长度的随机字符串，并与前端构建配置保持一致。
### 3.3 前端解密（CryptoJS 示例）
```javascript
import CryptoJS from 'crypto-js';
const SECRET_KEY = 'FoodLabelingThTenantSelect2026Key!'; // 与后端 TenantSelectCrypto:SecretKey 一致
function decryptTenantPassword(passwordBase64, passwordSaltBase64) {
  const key = CryptoJS.SHA256(CryptoJS.enc.Utf8.parse(SECRET_KEY));
  const iv = CryptoJS.enc.Base64.parse(passwordSaltBase64);
  const cipher = CryptoJS.enc.Base64.parse(passwordBase64);
  const decrypted = CryptoJS.AES.decrypt(
    { ciphertext: cipher },
    key,
    { iv, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 },
  );
  return decrypted.toString(CryptoJS.enc.Utf8);
}
```
### 3.4 前端解密（Web Crypto 伪代码）
```javascript
async function decryptTenantPassword(passwordBase64, passwordSaltBase64) {
  const secretKey = 'FoodLabelingThTenantSelect2026Key!';
  const keyMaterial = await crypto.subtle.importKey(
    'raw',
    await crypto.subtle.digest('SHA-256', new TextEncoder().encode(secretKey)),
    { name: 'AES-CBC' },
    false,
    ['decrypt'],
  );
  const iv = Uint8Array.from(atob(passwordSaltBase64), (c) => c.charCodeAt(0));
  const cipher = Uint8Array.from(atob(passwordBase64), (c) => c.charCodeAt(0));
  const plain = await crypto.subtle.decrypt({ name: 'AES-CBC', iv }, keyMaterial, cipher);
  return new TextDecoder().decode(plain);
}
```
### 3.5 安全说明
- 接口为 **匿名可访问**，密文仅降低明文密码在传输/展示中的直接暴露风险，**不能**替代 HTTPS 与生产环境改密策略。
- 解密后的密码仅用于登录表单预填或一键登录；请勿持久化明文密码。
---
## 四、Web 登录：tenantName 替代 tenantId
`tenant-select` 不再返回 `id` 后，Web 登录须使用 **租户名称**。
### 4.1 入参变更
| 字段 | 必填 | 说明 |
|------|------|------|
| `tenantId` | 否 | 与 `tenantName` 二选一 |
| `tenantName` | 否 | 与 `tenantId` 二选一，推荐 |
| `userName` | 是 | 账号或邮箱；`admin` 或 `admin@example.com` 均可 |
| `password` | 是 | 明文密码 |
二者均为空时返回：`请指定租户 Id 或租户名称`。
### 4.2 登录示例（curl）
```bash
curl -X POST "http://127.0.0.1:19002/api/app/th-web-auth/login" \
  -H "Content-Type: application/json" \
  -d "{\"tenantName\":\"Default\",\"userName\":\"admin\",\"password\":\"123456\"}"
```
### 4.3 出参（不变）
```json
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "...",
  "tenantId": "11111111-1111-1111-1111-111111111111",
  "tenantName": "Default"
}
```
Token 内仍写入真实 `TenantId` Guid；后续业务 API 行为不变。
---
## 五、泰额 App 登录说明
`POST /api/app/th-app-auth/login` **本次未改**，仍要求入参 `tenantId`（Guid）。
若 App 端也需要去掉 tenantId，需单独改造 `ThAppLoginInputVo` 与 `ThAppAuthAppService`，并与移动端联调。
---
## 六、相关接口（当日其它优化，可选）
- **开通租户** `POST /api/app/th-tenant-provisioning/provision`：创建租户后可在后台异步初始化业务库（`DatabaseInitializing` / `InitializeTenantDatabase`）。
- **同步初始化** `POST /api/app/th-tenant-provisioning/initialize-tenant-database/{tenantId}`：补跑租户库 CodeFirst + Seed。
与本次 `tenant-select` 改造无直接冲突；平台管理员仍通过 provision 创建租户，登录页通过 `tenant-select` + `tenantName` 登录。
---
## 七、改动文件列表（后端）
| 文件 | 变更 |
|------|------|
| `FoodLabeling.Th.Application.Contracts/Dtos/MultiTenancy/ThTenantSelectDto.cs` | 出参字段调整 |
| `FoodLabeling.Th.Application.Contracts/Options/FoodLabelingThTenantSelectCryptoOptions.cs` | 新增加密配置 |
| `FoodLabeling.Th.Application/MultiTenancy/TenantSelectCredentialCipher.cs` | AES-CBC 加密 |
| `FoodLabeling.Th.Application/MultiTenancy/ThTenantSelectConsts.cs` | 默认 admin 账号常量 |
| `FoodLabeling.Th.Application/MultiTenancy/TenantResolveHelper.cs` | 支持 tenantName 解析 |
| `FoodLabeling.Th.Application/Services/ThMultiTenancyAppService.cs` | tenant-select 映射与加密 |
| `FoodLabeling.Th.Application.Contracts/Dtos/Auth/ThWebLoginInputVo.cs` | TenantId 可选 + TenantName |
| `FoodLabeling.Th.Application/Services/ThWebAuthAppService.cs` | 按名称登录 |
| `FoodLabeling.Th.Application/FoodLabelingThApplicationModule.cs` | 注册加密配置 |
| `src/Yi.Abp.Web/appsettings.json` | TenantSelectCrypto 节点 |
---
## 八、前端对接 checklist
- [ ] 更新 `ThTenantSelectDto` 类型，移除 `id`，增加 `creationTime` / `loginAccount` / `password` / `passwordSalt`
- [ ] 配置与后端一致的 `SecretKey`，解密 `password` 后填入登录表单（若需）
- [ ] 登录请求改传 `tenantName: selected.name`，不再依赖 `tenantId`
- [ ] 登录成功后仍保存响应中的 `tenantId` 供业务 API / `__tenant` 头使用