← 博客
10 分钟阅读
|
发布于
|
更新于

区块链 API 安全:6 条实用建议与检查清单

使用区块链 API 时的六项安全实践:密钥生成、离线存储、本地签名、地址用途、API 令牌和 Webhook 签名。文中给出各失效环节的应对措施与检查位置,并说明如何先在测试网上验证整个流程,避免使用真实资金。风险主要出在您自己的密钥处理、凭据和端点上。

章节
C
Chaingateway Team
区块链专家

审核: Maurice Sobiera

区块链 API 安全是一套实践,使私钥、API 令牌和 Webhook 流量远离攻击者。风险存在于您的密钥处理、凭据和 Webhook 端点,而不在区块链本身。这六项实践适用于 Chaingateway,也适用于任何类似的 API。

应如何生成私钥?

请使用密码学安全的随机数生成器生成私钥,并在您自己控制的环境中完成。OWASP 加密存储备忘单指出,密钥必须来自密码学安全的函数,不得由常见单词或随意敲击键盘构成。弱的或可预测的密钥可能被猜中,而猜中它的人便可以动用其中的资金。

Chaingateway 可以通过 POST /api/v2/{blockchain}/addresses 为您创建地址。钱包管理指南介绍了两种模式。使用 password 时,私钥会以加密形式存储在我们这一侧,您用密码来发送交易。不使用密码时,响应中会以明文返回私钥,这适合临时地址,但不适合您打算长期保存的地址。若您希望完全掌控,请在自己的机器或硬件钱包上生成密钥,并仅在确有需要时再导入。

应如何存储私钥?

长期持有资金的密钥应保存在离线环境中,只有在服务器上的密钥才保存工作余额。连接互联网的机器上的密钥,可能被任何能够攻破该机器的程序盗走。硬件钱包和离线备份可以消除这一风险,不过硬件钱包可能丢失,因此请保留一份经过测试的恢复备份。

切勿把密钥或密码写入源代码、日志或工单中。OWASP 密钥管理备忘单指出,许多组织把机密以明文硬编码在源代码和配置文件中,并建议使用带访问控制和自动轮换的集中存储。

是否应在自己的机器上签名交易?

如果可以,应当这样做。在本地签名的交易永远不会把私钥暴露给第三方,API 只需广播签名后的结果。对于 TRON,Chaingateway 支持这一流程:build 端点返回未签名的交易,您使用 TRON 离线签名指南中介绍的 TRON 工具进行签名,然后通过 POST /api/v2/tron/transactions/broadcast 发送已签名的交易。

对于 EVM 网络,交易端点既可以接受已存储地址的 password,也可以接受请求体中的 privatekey。若使用 privatekey,密钥会随请求一起传输,因此只能通过 HTTPS 调用该 API,并且绝不要记录请求体。我们的密钥库解密指南说明了如何在本地打开已导出的密钥库文件。

能否把通过 API 创建的地址当作冷钱包使用?

不能。无论您如何称呼,只要密钥是通过在线服务创建或存储的,它就是热钱包。应把通过 API 创建的地址用作充值地址,将收到的资金转入您离线生成的冷钱包,并把充值地址视为短期使用。

归集充值资金,并为每位客户或每笔订单使用新地址,可以限制攻击者从任何一个泄露的密钥中获得的收益。若您使用的是未加保护的模式,私钥只会返回给您一次,因此请像保存密码一样保存它。

应如何保护 API 令牌?

将令牌放在 Authorization 请求头中,并使其远离 URL、前端代码和代码仓库。Chaingateway 使用 RFC 6750 定义的 Bearer 方案,即 Authorization: Bearer <token>。该 RFC 要求每个携带 Bearer 令牌的请求都必须使用 TLS,因为任何看到令牌的人都能使用它。

以下三个习惯可以降低令牌泄露造成的损失:

  • 将令牌存放在环境变量或密钥管理器中,而不是代码里。
  • 按计划轮换令牌,并在怀疑可能泄露后立即轮换,具体见我们的 API 密钥轮换指南。
  • 若您的账户面板提供,请按 IP 地址限制访问。我们关于 IP 白名单功能的文章说明了其工作方式。

OWASP API 安全十大风险把失效的身份认证(包括对令牌的薄弱处理)列为首要的 API 风险之一。

应如何校验 API 发来的 Webhook?

在信任负载之前,先校验每个 Webhook 上的 X-Signature 请求头。若不做校验,任何知道您 Webhook URL 的人都可以发送伪造的付款通知。您在个人资料设置中设定专属密钥后,Chaingateway 会为 Webhook 签名。签名是 RFC 2104 规定的 HMAC,由交易 ID 和您的密钥计算得出。

Webhook 安全指南提供了 Python、Java、PHP 和 JavaScript 的校验代码。请使用恒定时间比较函数比对签名,并在为订单入账之前在链上确认交易。Chaingateway 不会自动重试失败的 Webhook。失败的通知会列在 /api/v2/{blockchain}/webhooks/notifications/failed 下,您可以通过 /webhooks/notifications/{id}/retry 逐条重新发送,因此当付款似乎缺失时,请检查该列表。

六项是否都需要?

对于任何涉及真实价值的业务,都需要。这些实践分别覆盖不同的失效环节,跳过其中任何一项,就会让该环节保持暴露,无论其他环节做得多好。

失效环节应采取的措施检查位置
密钥生成使用密码学安全的生成器,或使用受密码保护的地址钱包管理指南
密钥存储长期资金保存在离线环境,密钥不得出现在代码和日志中OWASP 密钥管理备忘单
签名在 API 支持的情况下于本地签名,否则仅使用 HTTPSPOST /api/v2/tron/transactions/broadcast
地址用途使用 API 地址接收充值,并将资金归集到冷钱包您自己的归集任务
API 访问将 Bearer 令牌保存在密钥管理器中,并定期轮换API 密钥轮换指南
通知校验 X-Signature,并在链上确认交易Webhook 安全指南

在从测试网切换到主网之前,请复查此表。请求头 X-Network: testnet 可让您在不使用真实资金的情况下运行整个流程,包括 Webhook 校验。

我们如何撰写这些文章

准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 区块链 API 获取完整的 endpoint 参考。

C
Chaingateway Team
区块链专家

Chaingateway 团队致力于为全球开发者简化区块链集成。