Inizia a utilizzare Universal Ledger

Scopri come eseguire l'onboarding in una rete Universal Ledger e abilitare l'API Universal Ledger nei tuoi progetti Google Cloud .

Richiesta di onboarding

Prima di inviare transazioni a una rete, devi creare un account Universal Ledger. Consulta la pagina Panoramica del prodotto per acquisire familiarità con i vari tipi di account gestore e operatore.

Gli account del ledger devono essere creati da un account amministratore con privilegi sul ledger. Consulta la guida per identificare chi può creare il tuo account in modo da poter inviare i dettagli di onboarding richiesti.

Per configurare un account Operatore di valuta o per discutere del tuo caso d'uso, contattaci all'indirizzo [e-mail].

Attivazione dell'API

Puoi abilitare l'API Universal Ledger utilizzando gcloud e assegnare l'accesso granulare ai membri del tuo team utilizzando ruoli IAM specifici.

1. Abilita l'API utilizzando gcloud

   Per abilitare l'API, utilizza il comando gcloud services enable:

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

   Sostituisci PROJECT_ID con l'ID del progetto in cui vuoi abilitare l'API.

   Se sei un Project Owner, ora dovresti essere in grado di inviare richieste all'API.

2. Configura l'accesso granulare utilizzando i ruoli IAM

   Per gestire l'accesso granulare all'API Universal Ledger per altri membri della tua organizzazione, puoi assegnare loro ruoli IAM. L'API ha tre ruoli IAM configurati, ognuno dei quali fornisce diversi livelli di accesso:

   • roles/universalledger.viewer: accesso di sola lettura agli endpoint e alle reti disponibili. Concede la possibilità di visualizzare gli endpoint ed eseguire query sulla rete tramite un endpoint.
   • roles/universalledger.editor: accesso completo agli endpoint e alle reti disponibili. Concede l'accesso per eseguire query sulle reti e inviare transazioni.
   • roles/universalledger.admin: accesso completo agli endpoint e alle reti disponibili. Concede l'accesso per eseguire query sulle reti e inviare transazioni. Questo ruolo dispone delle stesse autorizzazioni del ruolo Universal Ledger Editor, soggette a modifiche in futuro.

   Per aggiungere un nuovo ruolo IAM a un utente, utilizza il comando gcloud projects add-iam-policy-binding:

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

   Sostituisci quanto segue:

   • PROJECT_ID: il progetto in cui aggiungere l'associazione della policy IAM
   • PRINCIPAL: l'entità a cui viene aggiunto il ruolo, ad esempio user:[e-mail] o serviceAccount:[e-mail].
   • thought ROLE: uno dei ruoli descritti in precedenza da assegnare all'entità

Invio della prima richiesta

Ora puoi iniziare a utilizzare l'API.

Per verificare che la configurazione precedente funzioni correttamente, esegui prima l'autenticazione utilizzando il comando gcloud auth application-default login:

gcloud auth application-default login

Poi prova a inviare una richiesta 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"

Le richieste a una determinata rete Universal Ledger vengono inviate utilizzando gli endpoint API, che avranno il formato

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

Il completamento di questi passaggi convalida l'accesso all'API Universal Ledger.

Passaggi successivi

• Consulta l'elenco delle reti e delle regioni Universal Ledger disponibili.
• Richiedi la creazione di un account nel registro.
• Scopri come inviare richieste RPC con Python.