2.2.5 应用接入

菜单入口：平台端 → 系统管理 → 应用接入。该模块用于注册接入大数据平台的第三方应用、设置应用配额，以及签发和维护第三方应用接入凭证。平台管理员按“注册应用 → 签发凭证 → 安全保存密钥 → 接入系统配置”的顺序完成首次接入。

“接入应用”页签维护应用身份和配额；“访问凭证”页签维护凭证及有效期。使用时先核对目标应用，避免把其他应用的凭证交给接入系统。页面是否提供相关操作，以当前账号权限为准。

2.2.5.1 查询接入应用

1. 在“应用接入管理”选择“接入应用”页签。需要按应用定位时，在“名称或编码”中输入目标名称或编码；需要按状态筛选时，在“状态”中选择目标状态。
2. 点击“查询”，检查列表中的应用名称与编码、租户绑定上限及状态。示例中的“埋点平台（tracker）”表示应用名称为埋点平台、编码为 tracker。

3. 点击“重置”清除查询条件；修改条件后再次点击“查询”。列表行内“编辑”用于修改应用资料，“停用”等状态操作用于调整应用可用状态。

操作结果：定位目标应用及其当前状态。首次接入前，先检查是否已有对应应用；已有应用时核对现有资料后继续签发凭证。

2.2.5.2 注册应用

1. 在“接入应用”页签点击“注册应用”，打开注册窗口。
2. 填写“应用编码”和“应用名称”，使其能够对应实际接入系统；应用编码在后续编辑时不可修改，提交前应仔细核对。
3. 设置“租户绑定上限”，用于填写应用可绑定的租户数量上限；设置“客户 QPS 配额”和“客户存储配额（GB）”，分别填写约定的请求配额和存储配额。当前页面三项默认值均为 100，应根据部署约定检查调整。

4. 按需要填写“备注”，补充应用用途或管理说明。带星号字段为必填项，核对后点击“确认”；放弃新增时点击“取消”。
5. 返回列表，用名称或编码查询新应用，检查名称、编码、上限及状态是否符合预期。应用记录准备好后，再切换“访问凭证”页签签发凭证。

2.2.5.3 编辑应用与调整状态

1. 在应用列表定位目标记录，核对应用名称及编码，点击该行“编辑”。
2. 编辑窗口中“应用编码”为灰色不可修改；可调整应用名称、租户绑定上限、客户 QPS 配额、客户存储配额（GB）及备注。按实际资源约定修改后点击“确认”；不保存时点击“取消”。

3. 需要停用应用时，点击该行“停用”，阅读确认提示。页面明确提示：该应用相关凭证将在下一次请求时重新校验。应先核对接入方使用情况，再点击“确定”；不执行时点击“取消”。

4. 状态操作提交后，重新查询目标应用，核对最新状态。恢复使用时按该行实际提供的状态操作及确认提示处理，完成后同时核对接入方请求结果。

2.2.5.4 查询并签发访问凭证

1. 切换到“访问凭证”页签。输入“名称或编码”、选择状态后点击“查询”，或点击“重置”清空条件。列表展示凭证、所属应用、类型、项目、到期时间和状态等信息。

2. 核对目标应用及凭证类型。示例类型为“第三方应用接入凭证”，项目显示为“－”；不应将其解释为某个项目的 SDK 令牌。
3. 点击“签发凭证”，填写“凭证名称”，选择“所属应用”，设置“到期时间”。名称应便于识别用途及环境，所属应用必须与接入系统一致。

4. 检查名称、应用及到期时间后点击“确认”。签发成功后立即按下一节保存一次性密钥。页面预填到期日期仅为当前表单值，提交时应按实际管理要求确认。

2.2.5.5 保存一次性密钥并交接接入配置

1. 凭证签发完成后，出现“保存一次性密钥”窗口，展示“凭证编号”和“密钥”。密钥只显示这一次，关闭后无法找回。

2. 在关闭窗口前，将凭证编号和密钥保存到服务端密钥管理系统，并核对两项信息已完整保存。手册截图中的值已隐藏，不能用于实际配置。
3. 确认安全保存后，点击“已安全保存，关闭”。回到访问凭证列表，查询目标凭证，核对所属应用、到期时间及状态。列表中的名称、到期时间等信息不能代替签发时的一次性密钥。
4. 将凭证编号与密钥安全交给负责接入的运维人员，由接入系统按自身配置方式使用。例如埋点系统需由运维配置到 admin 的 Nacos 中；具体配置项、生效及验证步骤见对应运维操作手册。
5. 在到期前安排后续维护。需要更换凭证时使用“轮换”，永久停止使用某条凭证时使用“撤销”，操作影响及具体步骤见后续两节。

2.2.5.6 轮换凭证

适用场景：接入方需要更换凭证。操作前先确认目标凭证所属应用、接入方和配置更新时间，安排新旧凭证切换。

1. 在“访问凭证”列表定位目标凭证，点击“轮换”。
2. 设置新凭证的“到期时间”；填写“旧凭证重叠时间（分钟，最多 1440）”。当前默认值为 0，表示立即撤销旧凭证；需要为接入方切换配置保留时间时，按约定填写重叠分钟数。

3. 阅读窗口提示：新凭证保留类型和项目归属，并重新检查当前状态。确认目标及时间安排无误后再点击“确认”；暂不执行时点击“取消”。
4. 轮换后如出现一次性密钥保存窗口，按 2.2.5.5 立即安全保存新凭证编号及密钥，并交接给接入方更新配置。旧凭证重叠时间为 0 时，应特别注意立即失效对在用请求的影响。
5. 由接入方完成配置更新和调用验证，再回到列表核对凭证状态及到期时间。不要仅以窗口关闭判断接入方已经切换成功。

2.2.5.7 撤销凭证

适用场景：某条凭证不再使用，需要终止其后续使用。撤销不可恢复，应先确认目标记录及接入方配置情况。

1. 在“访问凭证”页签按名称或编码查询，核对凭证名称、所属应用、类型、项目及到期时间，避免选错记录。
2. 点击目标行“撤销”。系统提示“撤销不可恢复，确认撤销此凭证？”。

3. 需要保留当前凭证时点击“取消”；确认停止使用且接入方已做好安排后，点击“确定”提交撤销。
4. 重新查询目标凭证，检查最新状态，并通知接入方核对后续调用。若仍需使用该应用能力，应由管理员安排有效凭证并完成接入方配置验证，不能依赖恢复已撤销凭证。

应用停用与凭证撤销的对象不同：前者调整应用状态并触发相关凭证后续重新校验，后者针对选定凭证执行不可恢复的撤销。操作前应先明确需要处理的对象。