Universal Ledger 시작하기

Universal Ledger 네트워크에 온보딩하고 Google Cloud 프로젝트에서 Universal Ledger API를 사용 설정하는 방법을 알아봅니다.

온보딩 요청

네트워크에 트랜잭션을 제출하기 전에 먼저 Universal Ledger 계정을 만들어야 합니다. 제품 개요 페이지를 검토하여 다양한 관리자 및 운영자 계정 유형을 숙지합니다.

원장 계정은 원장의 권한이 있는 관리자 계정으로 만들어야 합니다. 계정을 만들 수 있는 사용자 식별 가이드를 확인하여 필요한 온보딩 세부정보를 보낼 수 있습니다.

통화 운영자 계정을 설정하거나 사용 사례를 논의하려면 [e-mail]으로 문의하세요.

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:[e-mail] 또는 serviceAccount:[e-mail])
   • 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에 대한 액세스 권한이 검증됩니다.

다음 단계

• 사용 가능한 Universal Ledger 네트워크 및 리전 목록을 검토합니다.
• 원장에 계정 생성을 요청합니다.
• Python으로 RPC 요청을 전송하는 방법을 알아보세요.