Introdução ao Universal Ledger

Saiba como integrar uma rede do Universal Ledger e ativar a API Universal Ledger nos seus projetos do Google Cloud .

Solicitação de integração

Antes de enviar transações para uma rede, é preciso criar uma conta do Universal Ledger. Consulte a página Visão geral do produto para se familiarizar com os vários tipos de conta de administrador e operador.

As contas de contabilidade precisam ser criadas por uma conta de administrador privilegiada na contabilidade. Confira o guia para identificar quem pode criar sua conta e envie os detalhes de integração necessários.

Para configurar uma conta de operador de moeda ou discutir seu caso de uso, entre em contato pelo e-mail gcul-help@google.com.

Ativar a API

É possível ativar a API Universal Ledger usando gcloud e atribuir acesso granular aos membros da equipe usando papéis específicos do IAM.

  1. Ativar a API usando a gcloud

    Para ativar a API, use o comando gcloud services enable:

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

    Substitua PROJECT_ID pelo ID do projeto em que você quer ativar a API.

    Se você for proprietário de um projeto, já poderá enviar solicitações para a API.

  2. Configurar o acesso granular usando papéis do IAM

    Para gerenciar o acesso granular à API Universal Ledger para outros membros da sua organização, atribua papéis do IAM a eles. A API tem três papéis do IAM configurados, cada um fornecendo diferentes camadas de acesso:

    • roles/universalledger.viewer: acesso somente leitura a endpoints e redes disponíveis. Concede a capacidade de visualizar os endpoints e consultar a rede usando um endpoint.
    • roles/universalledger.editor: acesso total aos endpoints e às redes disponíveis. Concede acesso para consultar as redes e enviar transações.
    • roles/universalledger.admin: acesso total aos endpoints e às redes disponíveis. Concede acesso para consultar as redes e enviar transações. Esse papel tem as mesmas permissões que o papel de Editor do Universal Ledger, sujeito a alterações no futuro.

    Para adicionar um novo papel do IAM a um usuário, use o comando gcloud projects add-iam-policy-binding:

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

    Substitua:

    • PROJECT_ID: o projeto em que a vinculação da política do IAM será adicionada.
    • PRINCIPAL: o principal a quem o papel é adicionado, por exemplo: user:test-user@gmail.com ou serviceAccount:test123@example.domain.com.
    • ROLE: um dos papéis descritos anteriormente para atribuir ao principal.

Como enviar sua primeira solicitação

Agora você pode começar a usar a API.

Para validar se a configuração anterior está funcionando corretamente, primeiro autentique-se usando o comando gcloud auth application-default login:

gcloud auth application-default login

Em seguida, tente enviar uma solicitação 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"

As solicitações para uma determinada rede do Universal Ledger são enviadas usando endpoints de API, que terão o formato

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

Ao concluir essas etapas, você valida seu acesso à API Universal Ledger.

A seguir