配置管理
功能概述
后台服务域名配置用于管理 superapp 与后端服务器通信时使用的域名地址。通过配置多个后台服务域名，您可以为不同的环境（如开发、测试、生产）或不同的业务场景设置独立的服务端点。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | superapp 管理员 | superapp 高级开发者 |
配置管理 | 只读 | 只读 | ✓ | ✓ |
超级管理员/平台管理员：拥有配置模块的只读权限。
Superapp 管理员/ Superapp 高级开发者：拥有新增、修改配置权限。
功能说明
入口
Superapp 管理 → 配置管理 → 后台服务域名。
查看域名配置
进入配置管理页面后，您可以看到当前已配置的所有后台服务域名，每个域名以卡片形式展示，包含以下信息：
信息项 | 说明 |
SecretKey | 用于鉴权，密文展示。不限制字符类型，但输入的字符长度必须在16、24、32位三种选择其一。 |
域名地址 | 具体的后台服务域名 URL。只能包含 字母（a-z）、数字（0-9）、点（.）和 连字符（-），填写长度不能超过 253 个字符。 |
备注信息 | 用于对后台服务域名的补充说明。 |
默认标识 | 带有"默认"标签的卡片表示该配置为当前默认使用的后台服务域名，在 Superapp 没有指定连接某个后台服务时，将自动连接默认配置。 |
新增域名配置
操作步骤：
1. 点击页面中带有 "+" 号的虚线框卡片
2. 在弹出的对话框中填写配置信息：
SecretKey（必填）：用于鉴权，密文展示。不限制字符类型，但输入的字符长度必须在16、24、32位三种选择其一。
域名配置（必填）：输入完整的后台服务域名地址，如
https://api.example.com，只能包含 字母（a-z）、数字（0-9）、点（.）和 连字符（-），填写长度不能超过 253 个字符。备注信息（选填）：输入易于识别的备注信息，如"生产环境"、"测试环境"。
3. 点击 "确定" 保存配置
修改域名配置
操作步骤：
1. 在目标配置卡片右上角点击 操作图标（三个点）
2. 在下拉菜单中选择 "编辑"
3. 在弹出的编辑对话框中修改配置信息
4. 点击 "确定" 按钮
5. 在确认弹窗中点击 "确认" 完成修改
说明：
编辑操作会弹出二次确认，以防止误操作。
设置默认配置
操作步骤：
1. 在目标配置卡片右上角点击 操作图标（三个点）
2. 在下拉菜单中选择 "设为默认"
3. 在确认弹窗中点击 "确认" 完成设置
说明：
默认配置仅在 Superapp 没有指定连接某个后台服务时会自动连接默认配置，可指定使用某个配置。
同一时间只能有一个默认配置。
已经是默认的配置，其"设为默认"选项会显示为禁用状态（灰色）。
使用场景示例
场景一：多环境切换
为开发、测试、生产环境分别配置不同的后台服务域名：
备注信息 | 域名地址 | 用途 |
开发环境 | https://dev-api.example.com | 本地开发调试 |
测试环境 | https://test-api.example.com | QA 测试验证 |
生产环境 | https://api.example.com | 正式上线使用（设为默认） |
场景二：灰度发布
在进行新版本灰度发布时，可以配置灰度环境的服务域名，方便快速切换：
备注信息 | 域名地址 |
生产服务 | https://api.example.com |
灰度服务 | https://canary-api.example.com |
常见问题
Q1：修改默认配置后多久生效？
修改默认配置后会立即生效，新的请求将发送到新配置的域名地址，通常会有几分钟的延迟时间。
Q2：可以删除配置吗？
当前版本暂不支持删除已添加的配置，如果需要移除某个配置，建议将其修改为不再使用的标识名称。
Q3：域名配置有数量限制吗？
目前支持配置3个后台服务域名。
文档反馈