Gestionar nodos de proxy REST

Este tema contiene información que le ayudará a comprender cómo se utiliza el proxy REST, agregar inscripciones al proxy REST y ver y editar los nodos de proxy REST.

¿Cómo se utiliza el proxy REST?

El proxy REST asigna una identidad de aplicación a un miembro de cadena de bloques, lo que permite a los usuarios y las aplicaciones llamar a las API de REST de Oracle Blockchain Platform.

En lugar de utilizar las API nativas de Hyperledger Fabric, Oracle Blockchain Platform puede utilizar el proxy REST para interactuar con la red de Hyperledger Fabric. Cuando utiliza las API nativas de Hyperledger Fabric, se conecta a los iguales y al solicitante directamente. Sin embargo, el proxy REST le permite consultar o invocar un código de cadena de Fabric mediante el protocolo RESTful.

Agregar inscripciones al proxy REST

Las inscripciones permiten a los usuarios llamar al proxy REST sin un certificado de inscripción. Las inscripciones requieren que se defina un nuevo grupo de usuarios en el servidor de autenticación.

Adición de inscripciones al utilizar Microsoft Active Directory como servidor de autenticación

Para agregar una inscripción al proxy REST, es necesario agregar un nuevo grupo de usuarios a Active Directory: <Rest Proxy Client Users group name>_<custom enrolment name>. A continuación, puede utilizar la consola de Blockchain Platform para asignar la inscripción a este grupo.

1. Cree un nuevo grupo de Active Directory denominado <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Agregue a este grupo los usuarios que necesiten utilizar la inscripción personalizada.
3. Vaya a la consola de Blockchain Platform y seleccione el separador Nodos.
4. En el separador Nodos, busque el nodo de proxy REST al que desea agregar una inscripción y abra el menú Más acciones.
5. Haga clic en Ver o crear inscripciones para ver una lista de las inscripciones actuales del nodo.
6. Haga clic en Crear nueva inscripción.
7. En el campo Nombre de usuario, introduzca <custom enrolment name> desde el primer paso. Tenga en cuenta que distingue entre mayúsculas y minúsculas y que debe coincidir con el grupo de usuarios que ha creado. Haga clic en Inscribirse.
   • La inscripción se crea y se muestra en la tabla de inscripciones.
   • La nueva inscripción se copia en cada nodo de proxy REST de la red.

Adición de inscripciones al utilizar OpenLDAP u Oracle Internet Directory como servidor de autenticación

Al agregar una inscripción al proxy REST, se crea un nuevo rol de usuario en el grupo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> del servidor LDAP.

Después de crear la inscripción en la consola, el administrador utiliza el servidor LDAP para asignar los usuarios necesarios a este rol.

Para obtener información sobre cómo los usuarios acceden a los recursos de REST, consulte API de REST para Oracle Blockchain Platform.

1. Vaya a la consola y seleccione el separador Nodos.
2. En el separador Nodos, busque el nodo de proxy de REST al que desea agregar una inscripción y abra el menú Más acciones.
3. Haga clic en Ver o crear inscripciones para ver una lista de las inscripciones actuales del nodo.
4. Haga clic en Crear nueva inscripción.
   Aparece el cuadro de diálogo Crear nueva inscripción.
5. En el campo Usuario, introduzca un nombre para la inscripción. Haga clic en Inscribirse.
   Después de hacer clic en Inscribirse:

   • La inscripción se crea y se muestra en la tabla de inscripciones.
   • La nueva inscripción se copia en cada nodo de proxy REST de la red.
   • Un nuevo rol de usuario en el grupo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> del servidor LDAP.

Visualización y edición de la configuración del nodo de proxy REST

La configuración de un nodo de proxy REST determina cómo funciona y se comporta el nodo en la red.

Solo los administradores pueden cambiar la configuración de un nodo. Si tiene permisos de usuario, puede ver los valores de configuración de un nodo. Consulte Atributos de nodo de proxy REST.

1. Vaya a la consola y seleccione el separador Nodos.
2. En el separador Nodos, vaya a la tabla Nodos, busque el nodo de proxy REST para el que desea información de configuración y haga clic en el botón Más acciones del nodo.
3. Los permisos determinan la opción de configuración. Si es administrador, localice y haga clic en Editar configuración. Si es un usuario, localice y haga clic en Ver.
   Se muestra el cuadro de diálogo Configurar.
4. Si es administrador, modifique los atributos Tiempo de espera de propuesta (ms), Tiempo de espera de transacción (ms), Nivel de log y Registro de eventos de transacción del nodo según sea necesario.
5. Haga clic en Enviar para guardar los cambios de configuración o haga clic en X para cerrar el cuadro de diálogo Configurar.