Gestionar nodos de proxy REST

En este tema, se incluye información para ayudarle a comprender cómo se usa 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 blockchain, 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 directamente a los iguales y al ordenante. Sin embargo, el proxy REST le permite consultar o llamar a un código de cadena de Hyperledger Fabric mediante el protocolo RESTful.

Agregar inscripciones al proxy REST

Puede agregar inscripciones de Hyperledger Fabric al proxy 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 asignarse 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 acceden los usuarios a los recursos 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 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 desde 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 que se va a asociar 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 especificó un ID de usuario, ese ID está asociado con 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 se admiten para llamadas de API de REST que utilizan autenticación básica. Puede utilizar la autenticación básica para fines de prueba y desarrollo interno. No utilice la autenticación básica en entornos de producción.
  7. En el panel Usuarios cliente REST asociados, puede ver y gestionar cualquier usuario asociado 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 a un usuario con 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 predeterminado 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. La opción de configuración está determinada por los permisos. Si es administrador, busque y haga clic en Editar configuración. Si es un usuario, busque 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.