Gérer les noeuds de proxy REST

Cette rubrique contient des informations qui vous aideront à comprendre comment le proxy REST est utilisé, à ajouter des inscriptions au proxy REST, ainsi qu'à afficher et modifier les noeuds de proxy REST.

Utilisation du proxy REST

Le proxy REST met en correspondance une identité d'application avec un membre de la chaîne de blocs, ce qui permet aux utilisateurs et aux applications d'appeler les API REST Oracle Blockchain Platform.

Au lieu d'utiliser les API Hyperledger Fabric natives, Oracle Blockchain Platform peut utiliser le proxy REST pour interagir avec le réseau Hyperledger Fabric. Lorsque vous utilisez les API Hyperledger Fabric natives, vous vous connectez directement aux homologues et au donneur d'ordre. Cependant, le proxy REST vous permet d'interroger ou d'appeler un code chaîne Fabric via le protocole RESTful.

Ajouter des inscriptions au proxy REST

Vous pouvez ajouter des inscriptions Hyperledger Fabric au proxy REST. Les inscriptions permettent aux utilisateurs d'appeler le proxy REST sans certificat d'inscription.

Si vous voulez ajouter un utilisateur à une inscription, il doit déjà exister dans IDCS et être affecté au rôle REST_USER.

Utilisez la console Blockchain Platform pour ajouter de nouvelles inscriptions et associer des utilisateurs IDCS à ces inscriptions. Les inscriptions sont entièrement gérées au sein de Blockchain Platform, et non au sein d'IDCS.

Pour plus d'informations sur la façon dont les utilisateurs accèdent aux ressources REST, reportez-vous à API REST pour Oracle Blockchain Platform.

1. Accédez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, recherchez le noeud de proxy REST auquel ajouter une inscription, puis cliquez sur le menu Action de ce noeud.
3. Cliquez sur Visualiser ou gérer les inscriptions pour afficher la liste des inscriptions en cours du noeud.
   La liste des inscriptions en cours s'affiche. Vous pouvez supprimer des inscriptions existantes et en ajouter de nouvelles à partir de cette page.
4. Développez Créer une nouvelle inscription.
5. Dans le champ ID d'inscription, entrez le nom de l'inscription à ajouter.
   L'ID d'inscription ne peut inclure que des caractères alphanumériques, des traits d'union (-) et des traits de soulignement (_).
6. Si vous le souhaitez, dans le champ ID utilisateur, entrez l'ID d'un utilisateur doté du rôle REST_USER à associer à l'inscription. Cliquez sur S'inscrire.
   Après avoir cliqué sur S'inscrire, procédez comme suit :

   • L'inscription est créée et s'affiche dans la table Inscriptions.
   • La nouvelle inscription est copiée sur chaque noeud de proxy REST du réseau.
   • Si vous avez spécifié un ID utilisateur, celui-ci est associé à l'inscription et ne peut pas être retiré de la liste des utilisateurs REST associés. Si l'ID utilisateur n'est pas un utilisateur REST valide, une erreur est renvoyée.
   • Si vous avez spécifié un ID utilisateur, le certificat d'inscription généré inclut l'ID en tant qu'attribut username.
   • Les ID utilisateur contenant le signe deux-points ( :) ne sont pas pris en charge pour les appels d'API REST qui utilisent l'authentification de base.
7. Dans le panneau Utilisateurs client REST associés, vous pouvez visualiser et gérer tous les utilisateurs associés à une inscription en cours, y compris la suppression d'un utilisateur d'une inscription.
8. Ajoutez un autre utilisateur à l'inscription en développant Associer de nouveaux utilisateurs. Entrez l'adresse électronique ou l'ID d'un utilisateur auquel le rôle REST_USER est déjà affecté. Cliquez sur Associer.

Une fois que vous avez créé une inscription et associé un utilisateur à celle-ci, lorsque vous utilisez REST pour exécuter des transactions sur la blockchain, l'initiateur répertorié dans les détails du bloc sera répertorié en tant que nouvelle inscription plutôt que l'utilisateur par défaut d'origine.

Afficher et modifier la configuration du noeud de proxy REST

La configuration d'un noeud proxy REST détermine les performances et le comportement du noeud sur le réseau.

Seuls les administrateurs peuvent modifier la configuration d'un noeud. Si vous disposez de droits d'accès utilisateur, vous pouvez afficher les paramètres de configuration d'un noeud. Reportez-vous à Attributs de noeud de proxy REST.

1. Accédez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, accédez à la table Noeuds, localisez le noeud de proxy REST pour lequel vous souhaitez obtenir des informations de configuration, puis cliquez sur le bouton Actions supplémentaires du noeud.
3. L'option de configuration est déterminée par vos autorisations. Si vous êtes administrateur, localisez et cliquez sur Modifier la configuration. Si vous êtes un utilisateur, localisez et cliquez sur Afficher.
   La boîte de dialogue Configurer s'affiche.
4. Si vous êtes administrateur, modifiez les attributs Temps d'attente de proposition (ms), Temps d'attente de transaction (ms), Niveau de journalisation et Journalisation des événements de transaction du noeud selon vos besoins.
5. Cliquez sur Soumettre pour enregistrer les modifications de configuration ou sur X pour fermer la boîte de dialogue Configurer.

Affichage des informations d'intégrité d'un noeud proxy REST

Vous pouvez vérifier les mesures d'un noeud de proxy REST pour voir les performances du noeud sur le réseau de chaîne de blocs. Ces informations vous aident à détecter et à diagnostiquer les problèmes de performances.

Le panneau Etat affiche les mesures de performances suivantes : utilisation de l'UC et utilisation de la mémoire.

1. Accédez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, cliquez sur le noeud de proxy REST pour lequel vous voulez afficher les informations d'état.
   La page Informations sur le noeud apparaît.
3. Cliquez sur le panneau Etat pour visualiser les mesures de performances du noeud.
   Si les pourcentages d'utilisation sont constamment élevés, contactez le support technique Oracle.