Erste Schritte mit dem Universal Ledger

Hier erfahren Sie, wie Sie sich bei einem Universal Ledger-Netzwerk anmelden und die Universal Ledger API in Ihren Google Cloud -Projekten aktivieren.

Onboarding-Anfrage

Bevor Sie Transaktionen an ein Netzwerk senden können, müssen Sie ein Universal Ledger-Konto erstellen. Lesen Sie die Seite Produktübersicht, um sich mit den verschiedenen Manager- und Operatorkontotypen vertraut zu machen.

Ledger-Konten müssen von einem privilegierten Administratorkonto im Ledger erstellt werden. Sehen Sie sich den Leitfaden Wer kann Ihr Konto erstellen? an, um herauszufinden, wer Ihr Konto erstellen kann, damit Sie dieser Person die erforderlichen Onboarding-Details senden können.

Wenn Sie ein Währungsbetreiberkonto einrichten oder Ihren Anwendungsfall besprechen möchten, wenden Sie sich an gcul-help@google.com.

API aktivieren

Sie können die Universal Ledger API mit gcloud aktivieren und Ihren Teammitgliedern mit bestimmten IAM-Rollen detaillierten Zugriff zuweisen.

  1. API mit gcloud aktivieren

    Verwenden Sie den Befehl gcloud services enable, um die API zu aktivieren:

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

    Ersetzen Sie PROJECT_ID durch die ID des Projekts, in dem Sie die API aktivieren möchten.

    Wenn Sie ein Project Owner sind, sollten Sie jetzt Anfragen an die API senden können.

  2. Detaillierten Zugriff mithilfe von IAM-Rollen einrichten

    Wenn Sie den detaillierten Zugriff auf die Universal Ledger API für andere Mitglieder Ihrer Organisation verwalten möchten, können Sie ihnen IAM-Rollen zuweisen. Für die API sind drei IAM-Rollen konfiguriert, die jeweils unterschiedliche Zugriffsebenen bieten:

    • roles/universalledger.viewer: Lesezugriff auf verfügbare Endpunkte und Netzwerke. Gewährt die Berechtigung zum Ansehen von Endpunkten und zum Abfragen des Netzwerks über einen Endpunkt.
    • roles/universalledger.editor: Vollständiger Zugriff auf verfügbare Endpunkte und Netzwerke. Gewährt Zugriff zum Abfragen der Netzwerke und zum Senden von Transaktionen.
    • roles/universalledger.admin: Vollständiger Zugriff auf verfügbare Endpunkte und Netzwerke. Gewährt Zugriff zum Abfragen der Netzwerke und zum Senden von Transaktionen. Diese Rolle hat dieselben Berechtigungen wie die Rolle „Universal Ledger Editor“. Dies kann sich in Zukunft ändern.

    Verwenden Sie den Befehl gcloud projects add-iam-policy-binding, um einem Nutzer eine neue IAM-Rolle hinzuzufügen:

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: das Projekt, in dem die IAM-Richtlinienbindung hinzugefügt werden soll
    • PRINCIPAL: das Hauptkonto, dem die Rolle hinzugefügt wird, z. B. user:test-user@gmail.com oder serviceAccount:test123@example.domain.com.
    • ROLE: eine der zuvor beschriebenen Rollen, die dem Hauptkonto zugewiesen werden soll

Erste Anfrage senden

Jetzt können Sie die API verwenden.

Um zu prüfen, ob die vorherige Konfiguration ordnungsgemäß funktioniert, authentifizieren Sie sich zuerst mit dem Befehl gcloud auth application-default login:

gcloud auth application-default login

Senden Sie dann eine endpoints.list-Anfrage:

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"

Anfragen an ein bestimmtes Universal Ledger-Netzwerk werden über API-Endpunkte gesendet, die folgendes Format haben:

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

Durch diese Schritte wird Ihr Zugriff auf die Universal Ledger API validiert.

Nächste Schritte