Comienza a usar el Universal Ledger

Obtén información para incorporarte a una red de Universal Ledger y habilitar la API de Universal Ledger en tus proyectos de Google Cloud .

Solicitud de incorporación

Antes de enviar transacciones a una red, primero debes crear una cuenta de Universal Ledger. Revisa la página Descripción general del producto para familiarizarte con los distintos tipos de cuentas de administrador y operador.

Las cuentas de libro mayor deben crearse con una cuenta de administrador con privilegios en el libro mayor. Consulta la guía para identificar quién puede crear tu cuenta y enviarle los detalles de incorporación necesarios.

Para configurar una cuenta de operador de moneda o analizar tu caso de uso, comunícate con nosotros a través de gcul-help@google.com.

Habilitar la API

Puedes habilitar la API de Universal Ledger con gcloud y asignar acceso detallado a los miembros de tu equipo con roles de IAM específicos.

  1. Habilita la API con gcloud

    Para habilitar la API, usa el comando gcloud services enable:

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

    Reemplaza PROJECT_ID por el ID del proyecto en el que deseas habilitar la API.

    Si eres propietario del proyecto, ahora deberías poder enviar solicitudes a la API.

  2. Configura el acceso detallado con roles de IAM

    Para administrar el acceso detallado a la API de Universal Ledger para otros miembros de tu organización, puedes asignarles roles de IAM. La API tiene tres roles de IAM configurados, cada uno de los cuales proporciona diferentes capas de acceso:

    • roles/universalledger.viewer: Acceso de solo lectura a los extremos y las redes disponibles. Otorga la capacidad de ver los extremos y consultar la red con un extremo.
    • roles/universalledger.editor: Acceso completo a los extremos y las redes disponibles. Otorga acceso para consultar las redes y enviar transacciones.
    • roles/universalledger.admin: Acceso completo a los extremos y las redes disponibles. Otorga acceso para consultar las redes y enviar transacciones. Este rol tiene los mismos permisos que el rol Editor de Universal Ledger, sujeto a cambios en el futuro.

    Para agregar un rol de IAM nuevo a un usuario, usa el comando gcloud projects add-iam-policy-binding:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: el proyecto en el que se agregará la vinculación de la política de IAM
    • PRINCIPAL: Es la principal a la que se agrega el rol, por ejemplo: user:test-user@gmail.com o serviceAccount:test123@example.domain.com.
    • ROLE: Es uno de los roles descritos anteriormente para asignar a la principal.

Envía tu primera solicitud

Ahora puedes comenzar a usar la API.

Para validar que la configuración anterior funcione de forma correcta, primero autentica con el comando gcloud auth application-default login:

gcloud auth application-default login

Luego, intenta enviar una solicitud 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"

Las solicitudes a una red de Universal Ledger determinada se envían con endpoints de API, que tendrán el formato

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

Cuando completes estos pasos, se validará tu acceso a la API de Universal Ledger.

¿Qué sigue?