Premiers pas avec le registre universel

Découvrez comment intégrer un réseau Universal Ledger et activer l'API Universal Ledger dans vos projets Google Cloud .

Demande d'intégration

Avant d'envoyer des transactions à un réseau, vous devez d'abord créer un compte Universal Ledger. Consultez la page Présentation du produit pour vous familiariser avec les différents types de comptes de gestionnaire et d'opérateur.

Les comptes de registre doivent être créés par un compte administrateur privilégié sur le registre. Consultez le guide pour identifier qui peut créer votre compte afin de lui envoyer les informations d'intégration requises.

Pour configurer un compte d'opérateur de devise ou pour discuter de votre cas d'utilisation, contactez-nous à l'adresse gcul-help@google.com.

Activer l'API

Vous pouvez activer l'API Universal Ledger à l'aide de gcloud et attribuer un accès précis aux membres de votre équipe à l'aide de rôles IAM spécifiques.

  1. Activer l'API à l'aide de gcloud

    Pour activer l'API, utilisez la commande gcloud services enable :

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

    Remplacez PROJECT_ID par l'ID du projet dans lequel vous souhaitez activer l'API.

    Si vous êtes propriétaire du projet, vous devriez maintenant pouvoir envoyer des requêtes à l'API.

  2. Configurer un accès précis à l'aide de rôles IAM

    Pour gérer l'accès précis à l'API Universal Ledger pour les autres membres de votre organisation, vous pouvez leur attribuer des rôles IAM. Trois rôles IAM sont configurés pour l'API, chacun fournissant différents niveaux d'accès :

    • roles/universalledger.viewer : accès en lecture seule aux points de terminaison et aux réseaux disponibles. Permet d'afficher les points de terminaison et d'interroger le réseau à l'aide d'un point de terminaison.
    • roles/universalledger.editor : accès complet aux points de terminaison et aux réseaux disponibles. Permet d'interroger les réseaux et d'envoyer des transactions.
    • roles/universalledger.admin : accès complet aux points de terminaison et aux réseaux disponibles. Accorde l'accès permettant d'interroger les réseaux et d'envoyer des transactions. Ce rôle dispose des mêmes autorisations que le rôle d'éditeur Universal Ledger, qui sont susceptibles d'être modifiées à l'avenir.

    Pour ajouter un rôle IAM à un utilisateur, utilisez la commande gcloud projects add-iam-policy-binding :

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

    Remplacez les éléments suivants :

    • PROJECT_ID : projet dans lequel ajouter la liaison de stratégie IAM
    • PRINCIPAL : compte principal auquel le rôle est ajouté, par exemple user:test-user@gmail.com ou serviceAccount:test123@example.domain.com.
    • ROLE : l'un des rôles décrits précédemment à attribuer au compte principal.

Envoyer votre première requête

Vous pouvez maintenant commencer à utiliser l'API.

Pour vérifier que la configuration précédente fonctionne correctement, commencez par vous authentifier à l'aide de la commande gcloud auth application-default login :

gcloud auth application-default login

Essayez ensuite d'envoyer une requête 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"

Les requêtes adressées à un réseau Universal Ledger donné sont envoyées à l'aide de points de terminaison d'API, qui se présentent sous la forme suivante :

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

En suivant ces étapes, vous validez votre accès à l'API Universal Ledger.

Étapes suivantes