Gerenciar Nós Proxy REST

Este tópico contém informações para ajudá-lo a entender como o proxy REST é usado, adicionar inscrições ao proxy REST e exibir e editar os nós proxy REST.

Como o Proxy REST é Usado?

O proxy REST mapeia uma identidade de aplicativo para um membro de blockchain, o que permite que usuários e aplicativos chamem as APIs REST do Oracle Blockchain Platform.

Em vez de usar as APIs nativas do Hyperledger Fabric, o Oracle Blockchain Platform pode usar o proxy REST para interagir com a rede do Hyperledger Fabric. Ao usar as APIs nativas do Hyperledger Fabric, você se conecta aos pares e ao solicitante diretamente. No entanto, o proxy REST permite consultar ou chamar um chaincode do Fabric por meio do protocolo RESTful.

Adicionar Inscrições ao Proxy REST

É possível adicionar inscrições do Hyperledger Fabric ao proxy REST. As inscrições permitem que os usuários chamem o proxy REST sem um certificado de inscrição.

Se você quiser adicionar um usuário a uma inscrição, ele já deverá existir no IDCS e ser designado à atribuição REST_USER.

Use a console do Blockchain Platform para adicionar novas inscrições e associar usuários do IDCS a essas inscrições. As inscrições são gerenciadas inteiramente no Blockchain Platform, não no IDCS.

Para obter informações sobre como os usuários acessam os recursos REST, consulte API REST para o Oracle Blockchain Platform.

1. Vá para a console e selecione a guia Nós.
2. Na guia Nós, localize o nó proxy REST ao qual você deseja adicionar uma inscrição e clique no menu Ação desse nó.
3. Clique em Exibir ou Gerenciar Inscrições para ver uma lista das inscrições atuais do nó.
   Uma lista das inscrições atuais é exibida. Você pode excluir inscrições existentes, bem como adicionar novas inscrições desta página.
4. Expanda Criar Nova Inscrição.
5. No campo ID da Inscrição, informe o nome da inscrição a ser adicionada.
   O ID de inscrição só pode incluir caracteres alfanuméricos, hifens (-) e sublinhados (_).
6. Opcionalmente, no campo ID do Usuário, digite o ID de um usuário com a atribuição REST_USER a ser associada à inscrição. Clique em Inscrever-se.
   Depois de clicar em Inscrever:

   • A inscrição é criada e exibida na tabela Inscrições.
   • A nova inscrição é copiada para cada nó Proxy REST na rede.
   • Se você tiver especificado um ID de usuário, esse ID será associado à inscrição e não poderá ser removido da lista de usuários REST associados. Se o ID do usuário não for um usuário REST válido, um erro será retornado.
   • Se você tiver especificado um ID de usuário, o certificado de inscrição gerado incluirá o ID como o atributo username.
   • Os IDs de usuário que contêm dois-pontos (:) não são suportados para chamadas de API REST que usam autenticação básica.
7. No painel Usuários do Cliente REST Associados, você pode exibir e gerenciar todos os usuários associados a uma inscrição atual, incluindo a exclusão de um usuário de uma inscrição.
8. Adicione outro usuário à inscrição expandindo Associar Novos Usuários. Informe o e-mail ou o ID de um usuário que já recebeu a atribuição REST_USER. Clique em Associar.

Depois de criar uma inscrição e associar um usuário a ela, quando você usar o REST para executar transações no blockchain, o iniciador listado nos detalhes do bloco será listado como a nova inscrição, em vez do usuário padrão original.

Exibir e Editar a Configuração do Nó Proxy REST

A configuração de um nó proxy REST determina como o nó é executado e se comporta na rede.

Somente administradores podem alterar a configuração de um nó. Se você tiver permissões de usuário, poderá exibir as definições de configuração de um nó. Consulte Atributos do Nó Proxy REST.

1. Vá para a console e selecione a guia Nós.
2. Na guia Nós, vá para a tabela Nós, localize o nó proxy REST para o qual você deseja informações de configuração e clique no botão Mais Ações do nó.
3. A opção de configuração é determinada pelas suas permissões. Se você for um administrador, localize e clique em Editar Configuração. Se você for um usuário, localize e clique em Exibir.
   A caixa de diálogo Configurar é exibida.
4. Se você for um administrador, modifique os atributos Tempo de Espera da Proposta (ms), Tempo de Espera da Transação (ms), Nível de Log e Registro em Log do Evento de Transação, conforme necessário.
5. Clique em Submeter para salvar as alterações de configuração ou clique em X para fechar a caixa de diálogo Configurar.

Exibir Informações de Integridade de um Nó Proxy REST

Você pode verificar as métricas de um nó proxy REST para ver como o nó está sendo executado na rede blockchain. Essas informações ajudam a descobrir e diagnosticar problemas de desempenho.

O painel Saúde exibe estas métricas de desempenho: utilização de CPU e utilização de memória.

1. Vá para a console e selecione a guia Nós.
2. Na guia Nós, clique no nó proxy REST cujas informações de integridade você deseja ver.
   A página Informações do Nó é exibida.
3. Clique no painel Saúde para exibir as métricas de desempenho do nó.
   Se as porcentagens de utilização forem consistentemente altas, entre em contato com o Suporte Técnico da Oracle.