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

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 Servidor de Autenticação

A adição de 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 o 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 a este grupo.
3. Vá para a console do Blockchain Platform e selecione a guia Nós.
4. Na guia Nós, localize o nó 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 faz distinção entre maiúsculas e minúsculas e deve corresponder ao grupo de usuários que você criou. Clique 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.

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

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

Depois que a inscrição é criada na 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ó 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, digite um nome para a 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.
   • Uma nova função de usuário no grupo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> em seu servidor LDAP.

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.