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 には 3 つの 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 へのアクセスが検証されます。

次のステップ