开始使用 Universal Ledger

了解如何加入 Universal Ledger 网络并在 Google Cloud 项目中启用 Universal Ledger API。

入驻申请

在向网络提交交易之前，您必须先创建一个 Universal Ledger 账号。查看产品概览页面，熟悉各种经理和操作员账号类型。

账本账号必须由账本上的特权管理员账号创建。请参阅确定谁可以创建您的账号指南，以便向其发送所需的初始配置详细信息。

如需设置货币运营商账号或讨论您的用例，请通过 gcul-help@google.com 与我们联系。

启用 API

您可以使用 gcloud 启用 Universal Ledger API，并使用特定 IAM 角色为团队成员分配精细访问权限。

  1. 使用 gcloud 启用 API

    如需启用 API，请使用 gcloud services enable 命令：

    gcloud services enable universalledger.googleapis.com \
    --project=PROJECT_ID

    将 PROJECT_ID 替换为要启用 API 的项目的 ID。

    如果您是 Project Owner，现在应该能够向 API 发送请求。

  2. 使用 IAM 角色设置精细访问权限

    如需为组织中的其他成员管理对 Universal Ledger API 的精细访问权限，您可以为他们分配 IAM 角色。该 API 配置了三个 IAM 角色，每个角色提供不同的访问权限层级：

    • roles/universalledger.viewer：对可用端点和网络的只读访问权限。授予查看端点以及使用端点查询网络的权限。
    • roles/universalledger.editor：拥有对可用端点和网络的完整访问权限。授予查询网络和提交事务的权限。
    • roles/universalledger.admin：拥有对可用端点和网络的完整访问权限。授予查询网络和提交事务的权限。此角色与 Universal Ledger Editor 角色具有相同的权限，未来可能会发生变化。

    如需向用户添加新的 IAM 角色，请使用 gcloud projects add-iam-policy-binding 命令：

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="PRINCIPAL" \
    --role="ROLE"

    替换以下内容：

    • PROJECT_ID：要添加 IAM 政策绑定的项目
    • PRINCIPAL：要向其添加角色的主账号，例如 user:test-user@gmail.com 或 serviceAccount:test123@example.domain.com。
    • ROLE：要分配给主账号的上述角色之一

发送第一个请求

现在，您可以开始使用该 API 了！

如需验证之前的配置是否正常运行，请先使用 gcloud auth application-default login 命令进行身份验证：

gcloud auth application-default login

然后，尝试发送 endpoints.list 请求：

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -X GET "https://universalledger.us-central1.rep.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints"

对给定 Universal Ledger 网络的请求是使用 API 端点发送的，其格式如下

https://universalledger.REGION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/endpoints/NETWORK_NAME

完成这些步骤后，系统会验证您对 Universal Ledger API 的访问权限。

后续步骤