使用 Cobo OAuth 进行身份验证

​

Cobo OAuth 与 Cobo Auth

• 如果您正在开发 Cobo Portal Apps 以供不同团队安装和使用，请使用 Cobo OAuth 进行 API 请求的身份验证。
• 如果您正在开发其他类型的 App 以访问您自己团队内的数据和资源，请改用 Cobo Auth。有关 Cobo Auth 的更多详细信息，请参阅 使用 Cobo Auth 进行身份验证。

​

使用 WaaS SDK

from cobo_waas2 import Configuration, ApiClient, WalletsApi

configuration = Configuration(
    # 对于开发环境使用 `https://api.dev.cobo.com/v2`，对于生产环境使用 `https://api.cobo.com/v2`。
    host="https://api.dev.cobo.com/v2",
    # 将 `<APP_SECRET>` 替换为您的 App Secret。
    api_private_key="<APP_SECRET>",
)

client = ApiClient(configuration=configuration)
# 将 `{ORG_ACCESS_TOKEN}` 替换为 Org Access Tokens 。
client.set_default_header("AUTHORIZATION", f"Bearer {ORG_ACCESS_TOKEN}")

• 要了解如何生成 App Key 和 App Secret，请参阅 生成 App Key 和 App Secret。
• 要了解如何获取和使用 Org Access Tokens ，请参阅 Org Access Tokens 。

​

不使用 WaaS SDK

headers = {
    // 将 `{ORG_ACCESS_TOKEN}` 替换为 Org Access Tokens 。
    "Authorization": Bearer {ORG_ACCESS_TOKEN},
    // 将 `<APP_KEY>` 替换为您的 App Key。
    "Biz-Api-Key": {APP_KEY}.hex(),
    // 将 `{Nonce}` 替换为用作请求 nonce 的随机字符串。
    // 此值必须与 API 签名中的 `TIMESTAMP` 字段值相同。
    "Biz-Api-Nonce": {Nonce},
    // 将 `{YOUR_API_SIGNATURE}` 替换为计算的 API 签名。
    "Biz-Api-Signature": {YOUR_API_SIGNATURE}.hex(),
}

• 要了解如何生成 App Key 和 App Secret，请参阅 生成 App Key 和 App Secret。
• 要了解如何获取和使用 Org Access Tokens ，请参阅 Org Access Tokens 。
• 要了解如何使用 App Secret计算 API 签名，请参阅 计算 API 签名。

​

App Key 和 App Secret

​

App Key

​

App Secret

• App Key包含在 API 请求中，以标识 App 。它还需要包含在 App Manifest 文件中。有关更多信息，请参阅 配置Manifest 文件。
• App Secret签名请求。WaaS 服务验证签名以确认请求的真实性和完整性。

​

生成 App Key 和 App Secret

​

使用 Cobo CLI

1. 使用以下命令安装 Cobo CLI：
   # 使用 pip 安装 Cobo CLI（需要 Python 3.9 或更高版本）。
   pip install cobo-cli
   # 或者，您可以使用 Homebrew 安装 Cobo CLI。
   brew install cobo-cli
   # 测试安装是否成功
   cobo version
   
   有关 Cobo CLI 的系统要求，请参阅 安装 Cobo CLI。
2. 使用 keys generate 命令生成 App Key 密钥对，如下所示：
   # 生成 App Key 密钥对
   cobo keys generate --key-type APP
   
   生成的密钥将安全地存储在您的配置文件中（默认：~/.cobo/config.toml）。有关更多信息，请参阅 密钥管理。

​

使用 OpenSSL

openssl genpkey -algorithm ed25519 -out private_key.pem

openssl pkey -in private_key.pem -pubout -out public_key.pem

echo "私钥（十六进制）:"
openssl pkey -in private_key.pem -text | grep 'priv:' -A 3 | tail -n +2 | tr -d ':\n ' && echo

echo "公钥（十六进制）:"
openssl pkey -pubin -in public_key.pem -text | grep 'pub:' -A 3 | tail -n +2 | tr -d ':\n ' && echo

私钥（十六进制）:
06f78882576ec0e05b1e51a33548da7e8cf958c190ba96be77b1c671f98a2b5f
公钥（十六进制）:
5987dedc180167b7ab1d27e6009e5065d10d764cd85d7b64f8c968ca40326e28

​

使用 Python 库

1. 安装 PyNaCl Python 库。 在终端窗口中，运行以下命令：
   pip install PyNaCl
   
2. 生成密钥对。 导入函数从 Python 库生成 Ed25519 算法的密钥对，如下所示：
   from nacl.signing import SigningKey
   # 生成密钥对。
   sk = SigningKey.generate()
   # 打印私钥的十六进制格式。
   print("私钥:", sk.encode().hex())
   # 打印公钥的十六进制格式。
   print("公钥:", sk.verify_key.encode().hex())
   

​

计算 API 签名

1. 首先，根据您的请求连接一个字符串，如下所示： str_to_sign = {METHOD}|{PATH}|{TIMESTAMP}|{PARAMS}|{BODY}

   字段	描述	示例
   METHOD	HTTP 方法。	GET
   PATH	API 端点。	/v2/transactions/transfer
   TIMESTAMP	Nonce 值。此值必须与请求头 Biz-Api-Nonce 的值相同。	1718587017026
   PARAMS	（如果适用）查询参数。	chain_id=ETH&limit=10
   BODY	（如果适用）原始请求包体的字符串格式。	{"name":"Default","wallet_subtype":"Asset","wallet_type":"Custodial"}

2. 使用 hashlib 库对字符串进行两次 SHA-256 散列，如下所示：
   import hashlib
   
   content_hash = hashlib.sha256(hashlib.sha256(str_to_sign.encode()).digest()).digest()
   
3. 使用您的 App Secret签名字符串，如下所示：
   # 将 `app_secret` 替换为您的 App Secret。
   sk = ed25519.SigningKey(sk_s=bytes.fromhex(app_secret))
   # 签名哈希消息
   signature = sk.sign(content_hash)