将密钥存入受保护字段
数据库 URI 通常包含用户名、密码、主机和数据库名称。通过 SDK 保存连接时,请按照文档规定的连接结构,将 URI 放入 `endpoint.credentials`。
单独的 `endpoint.uri` 字段以明文保存,不应包含密码或其他秘密信息。
连接设置调用只会记录配置,并不能证明数据库可访问或凭据有效。保存后,请针对预期数据库执行一个小型只读操作,以验证连接和权限。不要将完整 URI 放入日志、截图、支持工单或 FAQ 示例中。
限制访问并谨慎处理凭据变更
使用权限仅覆盖应用所需操作的数据库用户,并选择不会泄露敏感信息的连接名称。不要向不需要的人分享已保存的连接。如果凭据可能已泄露,请在数据库服务商处轮换密钥,并通过批准的设置更新连接。
排查问题时,请提供服务商、操作、时间和脱敏后的错误信息,而不要提供 URI。应分别检查数据库名称和网络访问,因为它们与身份验证一样可能独立失败。
静态加密可以保护存储字段,但不代表在提示词或复制的诊断文本中暴露密钥就是安全的。