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 de proxy REST.

Como o Proxy REST é Usado?

O proxy REST mapeia uma identidade de aplicativo para um membro 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 deverá 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 dentro do Blockchain Platform, não dentro do IDCS.

Para obter informações sobre como os usuários acessam os recursos REST, consulte API REST para 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 nesta página.
4. Expanda Criar Nova Inscrição.
5. No campo ID da Inscrição, digite o nome da inscrição a ser adicionada.
   O ID da inscrição pode incluir somente caracteres alfanuméricos, hifens (-) e sublinhados (_).
6. Opcionalmente, no campo ID do Usuário, informe 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-se:

   • 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.
   • 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. Você pode usar a autenticação básica para fins de teste e desenvolvimento interno. Não use autenticação básica em ambientes de produção.
7. No painel Usuários do Cliente REST Associados, você pode exibir e gerenciar qualquer usuário associado 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á tenha a atribuição REST_USER atribuída. Clique em Associar.

Depois de criar uma inscrição e associar um usuário a ela, quando você usar REST para executar transações no blockchain, o iniciador listado nos detalhes do bloco será listado como a nova inscrição, e não como o 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ó funciona 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 obter informações de configuração e clique no botão Mais Ações do nó.
3. A opção de configuração é determinada por 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 Log de Evento de Transação do nó 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ó de Proxy REST

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

O painel Integridade 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.