管理API Key
在使用MaaS时，用户经常需要通过API接口调用模型服务进行数据请求和模型推理等操作。然而，如果API Key管理不当（如密钥丢失或泄露），可能导致未经授权的访问风险，从而影响服务的安全性和稳定性。如何确保API Key的安全管理，防止未授权访问？为了解决这个问题，MaaS平台提供了API Key管理功能，支持对API Key进行创建、编辑、权限管理等操作，确保只有具备有效API Key的用户才能成功调用模型服务，且只有具备相应权限的用户才能管理API Key，同时减少密钥长期暴露的风险。本文介绍如何对API Key进行创建、编辑和删除等操作。
约束限制
- 数量限制：每个账户最多可同时存在30个有效API Key，超出后需要删除旧API Key才能新建。
- 不可找回：新建API Key后需立即保存，系统不会存储明文，丢失后无法恢复。
- 鉴权时效：删除API Key后，基于该Key的接口调用将立即失效。
创建API Key
最多可创建30个API Key。API Key仅会在新建后显示一次，请及时复制并妥善保存。如果密钥丢失，请新建API Key。
- 登录MaaS控制台，在顶部导航栏中选择目标区域。
- 在左侧导航栏，选择 。
- 在“API Key管理”页面，单击“创建API Key”，配置基础信息和权限设置，单击“创建”。
标签在创建完成后，不支持修改。
表1 创建API Key参数说明 参数
说明
基础信息
标签
自定义API Key的标签。标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符。
描述
自定义API Key的描述，长度范围为1~100个字符。
权限设置
权限范围
支持选择“全部（访问所有资源不受限）”或“自定义（指定访问资源范围）”。默认为“全部（访问所有资源不受限）”。
IP 调用白名单
当“权限范围”选择“自定义（指定访问资源范围）”时，可配置此参数。
开启后，仅白名单中的IP地址可调用模型服务。支持IPv4网段，输入后按Enter生效，支持输入100个地址。IPv4格式示例：- 192.168.1.1
- 192.168.1.10-192.168.1.100
- 192.168.10.0/24
图1 IP调用白名单
模型服务访问范围
当“权限范围”选择“自定义（指定访问资源范围）”时，可配置此参数。
支持选择“预置服务”或“自定义接入点”。
说明：自定义接入点当前处于受限使用阶段，如需使用请提交工单。
- 预置服务：使用该API Key通过model参数发起调用时，仅支持访问已勾选的模型及版本。默认“全选”，即选择全部预置服务及版本，包括后续新增预置服务及版本，您也可以按需选择。
- 自定义接入点：默认“全选”，即选择全部自定义接入点，包括后续新增自定义接入点，您也可以按需选择。关于如何创建自定义接入点，请参见使用自定义接入点。
- 在“您的API Key”对话框，仔细阅读提示信息，复制密钥并保存至安全位置，然后单击“我已保存，确认关闭”。 图2 保存API Key
关闭后将无法再次查看密钥。创建成功后，在“API Key管理”页面，可以看到新建的API Key，默认显示API Key的前四位和后四位。
图3 API Key
编辑API Key
API Key创建后，不支持修改标签，其他配置可按需修改。修改权限可能导致当前部分模型服务、自定义接入点等鉴权失败，请确认业务影响后再操作。
删除API Key
当API Key数量达到上限，或者API Key发生泄露、遗忘等情况时，建议您及时删除不再使用的API Key。删除后该API Key将无法使用且无法找回，请谨慎操作。
- 登录MaaS控制台，在顶部导航栏中选择目标区域。
- 在左侧导航栏，选择 。
- 在“API Key管理”页面右侧，单击API Key右侧的“删除”。
- 在“删除API Key”对话框，单击“确定”。
