密钥交换
本页面适用于转让方、发起人、投资者和分销商:您自行生成密钥对,并将公钥发送给 QI Tech 集成团队。
管理人和顾问
管理人和顾问通过门户自行注册公钥并获取 API key,无需通过邮件发送密钥。请参见通过门户集成。
1. 签名请求
所有对 QI DTVM API 的请求都使用 HTTPS(TLS 1.2 或 1.3),并携带两个 header:
API-CLIENT-KEY:标识您集成的 API key,由集成团队发送。AUTHORIZATION:使用您的私钥签名的 JWT,构造方式参见认证测试。
QI DTVM 使用非对称密钥:私钥用于签名请求,公钥供 QI 验证签名。密钥对由您生成,只需将公钥交给 QI。
注意
私钥仅供贵公司使用,必须妥善保管。QI DTVM 绝不会要求您提供私钥。
2. 生成密钥对
在 UNIX 终端中生成 EC P-521 私钥:
ssh-keygen -t ecdsa -b 521 -m PEM -f private.key
再由私钥生成公钥:
openssl ec -in private.key -pubout -outform PEM -out public.key.pub
公钥即 public.key.pub 文件,只需将该文件发送给 QI。使用 private.key 签名请求时,请使用与 P-521 曲线对应的 ES512 算法。
3. 提交公钥
将 public.key.pub 文件发送至 integracao.dtvm@qitech.com.br,等待集成配置完成。集成团队会回复您所属角色的 API key。该 API key 只在该角色的主机上有效:参见环境(主机)。