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

Puede agregar inscripciones de Hyperledger Fabric al proxy de REST. Las inscripciones permiten a los usuarios llamar al proxy REST sin un certificado de inscripción.

Si desea agregar un usuario a una inscripción, ya debe existir en IDCS y estar asignado al rol REST_USER.

Utilice la consola de Blockchain Platform para agregar nuevas inscripciones y asociar usuarios de IDCS a estas inscripciones. Las inscripciones se gestionan por completo dentro de Blockchain Platform, no dentro de IDCS.

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 haga clic en el menú Acción de este nodo.
3. Haga clic en Ver o gestionar inscripciones para ver una lista de las inscripciones actuales del nodo.
   Se muestra una lista de las inscripciones actuales. Puede suprimir inscripciones existentes y agregar nuevas de esta página.
4. Amplíe Crear nueva inscripción.
5. En el campo ID de inscripción, introduzca el nombre de la inscripción que desea agregar.
   El ID de inscripción solo puede incluir caracteres alfanuméricos, guiones (-) y guiones bajos (_).
6. Opcionalmente, en el campo ID de usuario, introduzca el ID de un usuario con el rol REST_USER para asociarlo a 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.
   • Si ha especificado un ID de usuario, ese ID está asociado a la inscripción y no se puede eliminar de la lista de usuarios REST asociados. Si el ID de usuario no es un usuario REST válido, se devuelve un error.
   • Si ha especificado un ID de usuario, el certificado de inscripción generado incluye el ID como atributo username.
   • Los ID de usuario que contienen dos puntos (:) no están soportados para las llamadas a la API de REST que utilizan autenticación básica.
7. En el panel Usuarios de cliente REST asociados puede ver y gestionar los usuarios asociados a una inscripción actual, incluida la supresión de un usuario de una inscripción.
8. Agregue otro usuario a la inscripción ampliando Asociar nuevos usuarios. Introduzca el correo electrónico o el ID de un usuario que ya tiene asignado el rol REST_USER. Haga clic en Asociar.

Después de crear una inscripción y asociar un usuario a ella, cuando utilice REST para ejecutar transacciones en la cadena de bloques, el iniciador que se muestra en los detalles del bloque se mostrará como la nueva inscripción, en lugar de como el usuario por defecto original.

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.

Visualización de información de estado de un nodo de proxy REST

Puede comprobar las métricas de un nodo de proxy REST para ver el rendimiento del nodo en la red de cadenas de bloques. Esta información le ayuda a detectar y diagnosticar problemas de rendimiento.

El panel Estado muestra estas métricas de rendimiento: uso de CPU y uso de memoria.

1. Vaya a la consola y seleccione el separador Nodos.
2. En el separador Nodos, haga clic en el nodo de proxy REST para el que desea ver la información de estado.
   Se muestra la página Información de nodo.
3. Haga clic en el panel Estado para ver las métricas de rendimiento del nodo.
   Si los porcentajes de utilización son consistentemente altos, póngase en contacto con los Servicios de Soporte Oracle.