全房通中第三方接口密钥轮换前后，需要核对哪些业务链路？

全房通接口密钥轮换前后，应核对所有实际使用该密钥的业务链路，重点包括统一身份认证、财务、支付、电子签、发票、渠道、监管平台、智能硬件及其他业务系统。轮换前应完成接口清单、数据流向、权限范围、测试环境、切换窗口和回退条件确认；轮换后应验证身份鉴权、数据同步、业务结果、异常重试、日志记录及人工补偿是否正常，不能只确认新密钥已经配置。

轮换前核对清单

接口能否正常接入，不只由密钥本身决定，还取决于双方接口能力、文档、网络、安全策略、授权、字段质量、调用频率和测试环境。

轮换时与轮换后核对的业务链路

1. 登录与身份认证

核对统一身份认证、组织和人员同步、账号权限等链路，确认新密钥启用后，相关账号能够在授权范围内完成正常访问。管理员、财务、退款、导出、批量操作、设备控制及隐私数据权限应重点检查，避免因权限扩大或缺失影响业务。

2. 合同、账单与财务接口

核对合同、账单、收款、押金等数据是否仍能按既定方向同步，并检查唯一标识、状态、日期和金额等关键字段是否保持一致。对于批量或定时同步，还应确认任务执行结果、失败记录及补偿处理是否正常。

3. 支付、电子签与发票

分别验证支付、电子签和发票接口的鉴权及业务结果，包括请求是否被正常受理、结果是否能够回传、重复请求是否按既定规则处理。不同接口应分别核对，不能用其中一条链路成功代替其他链路的验证。

4. 渠道、监管平台及其他业务系统

核对房源、客户、合同、账单等实际同步对象，确认同步方向、调用频率和字段映射没有因密钥切换受到影响。若第三方同时调整接口版本、授权范围或网络策略，应将这些变更与密钥轮换一并纳入联调和切换管理。

5. 智能硬件链路

涉及智能电表、门禁、闸机、道闸、视频监控或安全感知设备时，应按项目实际接入范围验证设备数据读取、权限下发、事件上报、记录同步和异常处置。相关能力同时受设备、控制器、网络、接口授权和项目配置影响，密钥轮换成功不等于全部设备业务已经恢复。

轮换完成后的判断标准

轮换完成后，建议至少确认以下结果：

• 新密钥能够在目标环境正常鉴权，原有必要业务接口均已切换；
• 身份、组织、房源、合同、账单和设备等关键对象映射保持一致；
• 实时、准实时及批量同步任务能够按原定方式执行；
• 重复请求、超时、限流、无权限和数据校验失败等异常能够被记录并按既定方式处理；
• 操作日志能够反映相关人员、时间、对象、动作和执行结果；
• 回退条件、应急联系人和问题责任边界仍然有效；
• 原密钥的后续处理与项目既定安全策略保持一致。

不同项目需要核对的接口数量和业务对象并不相同：长租公寓通常更关注房源、合同、账单、收缴和设备链路；保障性租赁住房等场景还可能涉及准入、配租、运营监管和统计上报。最终应以项目实际启用的第三方接口、产品版本和交付范围为准。

轮换记录中应避免写入哪些内容？

核查记录保留凭据版本标识、配置位置、切换时间、责任人和验证结果即可，不应把真实密钥、签名原串或访问令牌写入工单、聊天记录或截图。需要排查认证失败时，先确认环境、配置版本和请求时间，再按授权范围提供必要的错误信息。

请求认证与回调验签是否使用同一组配置，也应明确记录。不同服务或任务可能有不同配置来源，一个请求成功不能证明全部节点已切换；具体切换和验证方式以接口提供方说明及项目既定方案为准。

相关问题

主动调用成功，是否说明回调也一定正常？

不能。请求认证与回调验签可能使用不同配置或处理节点，应分别检查。还需确认回调已关联到正确业务并完成状态处理，而不只是返回了成功响应。

是否应该同时保留新旧密钥一段时间？

是否支持过渡期以及如何生效，应以接口提供方的规则和项目既定方案为准，不能统一假定支持双密钥。核查人员应确认切换期间在途请求和返回结果如何被正确处理。

轮换后出现认证失败，可以直接重复提交业务吗？

先定位环境、配置版本、请求时间和实际执行结果。认证错误与业务失败需要区分，尤其对结果未明的请求，应先查询状态，再按确认的重试规则处理，避免重复业务。