Gérer les noeuds de proxy REST

Cette rubrique contient des informations permettant de comprendre comment le proxy REST est utilisé, d'ajouter des inscriptions au proxy REST, et d'afficher et de modifier les noeuds de proxy REST.

Comment le proxy REST est-il utilisé ?

Le proxy REST met en correspondance une identité d'application avec un membre de 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.

Pour 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 dans Blockchain Platform, et non dans IDCS.

Pour plus d'informations sur l'accès des utilisateurs 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 Afficher 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 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 tirets (-) et des traits de soulignement (_).
6. Vous pouvez éventuellement saisir l'ID d'un utilisateur doté du rôle REST_USER à associer à l'inscription dans le champ ID utilisateur. Cliquez sur S'inscrire.
   Une fois que vous avez cliqué sur Inscrire :

   • L'inscription est créée et s'affiche dans la table Inscriptions.
   • La nouvelle inscription est copiée dans 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 supprimé 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 comme 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. Vous pouvez utiliser l'authentification de base à des fins de test et de développement interne. N'utilisez pas l'authentification de base dans les environnements de production.
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 chaîne de blocs, l'initiateur répertorié dans les détails du groupement est répertorié comme nouvelle inscription et non comme utilisateur par défaut d'origine.

Afficher et modifier la configuration du noeud de proxy REST

La configuration d'un noeud de 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 d'autorisations 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 droits d'accès. Si vous êtes administrateur, localisez et cliquez sur Modifier la configuration. Si vous êtes un utilisateur, localisez et cliquez sur Visualiser.
   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 d'événement de transaction du noeud, le cas échéant.
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 de 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 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 toujours élevés, contactez le support technique Oracle.