Gerenciar Nós de 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 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 Hyperledger Fabric. Ao usar as APIs nativas do Hyperledger Fabric, você se conecta diretamente aos pares e ao solicitante. No entanto, o proxy REST permite consultar ou chamar um chaincode Fabric por meio do protocolo RESTful.

Adicionar Inscrições ao Proxy REST

As inscrições permitem que os usuários chamem o proxy REST sem um certificado de inscrição. As inscrições exigem que um novo grupo de usuários seja definido no servidor de autenticação.

Adicionando Inscrições ao Usar o Microsoft Active Directory como seu Servidor de Autenticação

Adicionar uma inscrição ao Proxy REST requer que um novo grupo de usuários seja adicionado ao Active Directory: <Rest Proxy Client Users group name>_<custom enrolment name>. Em seguida, você pode usar a console do Blockchain Platform para mapear a inscrição para este grupo.

1. Crie um novo grupo do Active Directory chamado <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Adicione qualquer usuário que precise usar a inscrição personalizada para este grupo.
3. Vá para a console do Blockchain Platform e selecione a guia Nós.
4. Na guia Nós, localize o nó de proxy REST ao qual você deseja adicionar uma inscrição e abra o menu Mais Ações.
5. Clique em Exibir ou criar inscrições para ver uma lista das inscrições atuais do nó.
6. Clique em Criar Nova Inscrição.
7. No campo Nome do Usuário, digite <custom enrolment name> na primeira etapa. Observe que isso faz distinção entre maiúsculas e minúsculas e deve corresponder ao grupo de usuários que você criou. Clique em Inscrever.
   • A inscrição é criada e exibida na tabela Enrollments.
   • A nova inscrição é copiada para cada nó de proxy REST na rede.

Adicionando Inscrições ao Usar o OpenLDAP ou o Oracle Internet Directory como Seu Servidor de Autenticação

Adicionar uma inscrição ao Proxy REST cria uma nova função de usuário no grupo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> no servidor LDAP.

Depois que a inscrição é criada no console, o Administrador usa o servidor LDAP para atribuir os usuários necessários a essa função.

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ó de proxy REST ao qual você deseja adicionar uma inscrição e abra o menu Mais Ações.
3. Clique em Exibir ou criar inscrições para ver uma lista das inscrições atuais do nó.
4. Clique em Criar Nova Inscrição.
   A caixa de diálogo Criar Nova Inscrição é exibida.
5. No campo Nome do Usuário, informe um nome para a inscrição. Clique em Inscrever.
   Depois de clicar em Enroll:

   • A inscrição é criada e exibida na tabela Enrollments.
   • A nova inscrição é copiada para cada nó de proxy REST na rede.
   • Uma nova atribuição de usuário no grupo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> no servidor LDAP.

Exibir e Editar a Configuração do Nó de 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ó de 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ó de proxy REST cujas informações de configuração você deseja 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 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.