開始使用 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。

    如果您是專案擁有者，現在應該可以向 API 傳送要求。

  2. 使用 IAM 角色設定精細存取權

    如要管理機構其他成員對 Universal Ledger API 的精細存取權，您可以指派 IAM 角色給他們。這個 API 已設定三個 IAM 角色，每個角色提供不同的存取層級：

    • roles/universalledger.viewer：可唯讀存取可用的端點和網路。可查看端點，並透過端點查詢網路。
    • roles/universalledger.editor：可完整存取可用的端點和網路。可查詢網路及提交交易。
    • roles/universalledger.admin：可完整存取可用的端點和網路。可查詢網路及提交交易。這個角色與 Universal Ledger 編輯者角色具備相同的權限，日後可能會有變動。

    如要為使用者新增 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。

後續步驟