新连接优先核对 Ed25519 支持。官方已把 HMAC 标记为弃用;这不等于所有现有连接立即失效,也不能靠改下拉菜单完成迁移。

先看工具支持哪种密钥,教程截图放后面
面对三个算法名字,先别急着生成。打开工具当前版本的接入文档,找它明确支持的密钥类型、运行方式和导入字段。文档如果只给了 API 标识和密钥两个输入框,又没说非对称密钥怎么导入,就去问提供方,别把私钥文件内容试着塞进那个密钥框。交易所支持某种类型,只说明平台那一端准备好了;你的第三方程序有没有实现对应的签名流程,得看程序自己的说明。
把官方方向与当前兼容性放在两列
2026 年 10 月查看开发者文档的 API Key Types 一页,上面写着推荐使用 Ed25519,HMAC 已弃用,建议改用 Ed25519 或 RSA 这类非对称密钥。把这条记成“后续维护要求”,另一列写你的工具现在支不支持。已有的 HMAC 连接,去问提供方迁移路线、从哪个版本开始支持、切换时要不要停机。官方没给统一的失效日期,旧教学视频里说“HMAC 一直能用”也不作数。
不同类型意味着保管对象不同
HMAC 使用共享秘密;RSA 与 Ed25519 使用公私钥配对,提交给平台的是公钥,签署请求依赖私钥。实际操作中,文件名字含有 public 或 private 只能提供线索,不能替代对内容及工具说明的核对。将公钥和私钥放在同一共享文件夹,或者为了方便支持人员检查而上传完整压缩包,都会破坏原本想建立的秘密边界。
连接表单应该能解释每个字段
记录一份不包含秘密的字段对照:API 标识填在哪、私钥是选择本地路径还是由服务托管、带口令的私钥是否受支持、哪一组件真正完成签名。这几项决定程序怎么部署。服务只接受上传私钥的话,签名能力就交到了对方手里,先读它怎么保管凭证。算法再新,第三方照样能读到你授权给它的数据。
只换 API 标识、不换私钥:迁移并没有完成
设想旧看板支持 HMAC,新版说明新增 Ed25519。你创建新配对后,必须让新的 API 标识与对应私钥作为一组进入工具配置;只替换标识、继续使用旧秘密不会完成迁移。同样,不要在没有导入支持时仅把配置标签改成 Ed25519。最好在私有记录中区分旧标签、新标签、版本和切换时间,避免两个相似文件名造成混用。
用只读结果检查兼容,不用实盘试单
迁移验证先选择工具本来需要的读取功能,确认请求使用新标签且返回的是新数据。失败时分别检查文件能否被运行进程读取、口令输入渠道、选定算法和环境,不一次改变所有设置。官方生成器能生成哪些类型,和某个具体 API 产品接受哪些类型,是两份说明,要分别看。
完成切换后,旧凭证必须有结局
无泄露迹象的计划迁移可以安排受控切换,确认新连接后撤销旧凭证;若已有泄露迹象,应走紧急撤销流程。不要因为迁移“看起来完成”就把旧文件无限期留在下载目录、压缩包和历史配置里。变更记录里写标签、时间和撤销结果就够了,别顺手留一套还能用的备用私钥。对尚无支持路线的工具,可以暂停新接入并要求明确答复。
用一张兼容性表做选择
可以用四列记录候选连接:工具版本、官方说明支持的算法、秘密保管方式、尚未确认的问题。第一行若只写“支持币安”,信息仍然不够,因为产品名称不能替代密钥类型。第二行如果写“支持 Ed25519,但仅支持某个部署版本”,就要把版本限制保留下来。说明里没提到的能力,空着或写“未确认”,每个勾都要能指回原说明里的那一句。
自行运行与服务托管的取舍
自行运行程序时,你负责文件访问、进程权限和部署;服务托管时,需要理解提供方接收并保管什么。这两种方式没有仅凭名字就能得出的安全排名。例如,本机文件夹如果被不受控同步或备份,同样可能扩大私钥接触范围;托管服务就算公开说用了加密存储,也还得讲清谁能触发签名。
文件可以打开,不等于程序可以读取
操作系统里双击文件正常,只证明当前交互用户能访问它。后台程序可能使用另一个运行身份、另一份工作目录,或只读取配置中指定的绝对路径。排查时可以检查路径存在与权限状态,不需要把文件内容打印进日志。移动文件后,旧路径不会自动随新位置变化;更换文件名也不会让程序自动重新加载。路径、加载时机和运行身份都不是秘密,可以直接写进配置记录,下次排查就不用重建钥匙去试。
给服务方的三个明确问题
第一,当前版本支持哪些类型,说明链接在哪里;第二,保存配置后是立即生效还是需要重启某个服务;第三,升级到推荐类型时,旧连接如何停止、新连接如何验证。对方只回复“把密钥发来看看”,并没有回答任何兼容性问题。你可以请求其用虚构凭证示范字段结构,或提供不包含客户信息的配置说明。
不要把算法比较扩展成收益比较
密钥类型属于请求认证和运维选择,不会因此让一个资产看板预测更准,也不能证明某个执行工具表现更好。如果产品介绍把切换算法直接连到利润提升,需要另外核实其依据。换类型这件事做完的标志只有四个:两端都支持这个类型,私钥放在哪、谁能碰说得清,一次必要的读取正常返回,旧授权按计划撤掉。
选型记录何时需要重新看
当工具发布新版本、改用托管运行、要求重新导入或改变认证说明时,应重新核对兼容性表。不要把首次连接的结论永久沿用。可以先保留原文档日期与支持答复,再记录本次哪些字段发生变化;没有变化的部分无需反复操作账户。若变化仅涉及文档名称,也不能因此断言旧凭证已失效。要不要迁移,看当前官方方向、工具支持和实际配置这三样。复核时顺手记下这次是被什么触发的。