Gestionar nodos de proxy REST

¿Cómo se utiliza el proxy REST?

El proxy de REST asigna una identidad de aplicación a un miembro de blockchain, lo que permite a los usuarios y 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 directamente a los peers y al solicitante. Sin embargo, el proxy REST permite consultar o llamar a 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 REST, consulte API de REST para Oracle Blockchain Platform.

Vaya a la consola y seleccione el separador Nodos.
En el separador Nodos, busque el nodo de proxy REST al que desea agregar una inscripción y haga clic en el menú Acción de este nodo.
Haga clic en View or Manage Enrollments 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 desde esta página.
Amplíe Crear nueva inscripción.
En el campo Enrollment ID, 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 (_).
Si lo desea, 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 Enroll:
- La inscripción se crea y se muestra en la tabla Inscripciones.
- La nueva inscripción se copia en cada nodo de proxy REST de la red.
- Si ha especificado un ID de usuario, dicho ID está asociado a la inscripción y no se puede eliminar de la lista de usuarios de 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 de API de REST que utilizan autenticación básica. Puede utilizar la autenticación básica para pruebas y desarrollo interno. No utilice la autenticación básica en entornos de producción.
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.
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 Agregar.

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 del usuario por defecto original.

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

La configuración de un nodo proxy REST determina cómo funciona el nodo y cómo se comporta 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.

Vaya a la consola y seleccione el separador Nodos.
En el separador Nodos, vaya a la tabla Nodos, busque el nodo de proxy REST para el que desea obtener información de configuración y haga clic en el botón Más acciones del nodo.
La opción de configuración viene determinada por los permisos. Si es administrador, busque y haga clic en Editar configuración. Si es usuario, busque y haga clic en Ver.
Se muestra el cuadro de diálogo Configurar.
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.
Haga clic en Enviar para guardar los cambios de configuración o haga clic en la 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 cómo funciona el nodo en la red de blockchain. 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.

Vaya a la consola y seleccione el separador Nodos.
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.
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.