Gérer les noeuds mandataires REST

Cette rubrique contient des informations pour vous aider à comprendre comment le mandataire REST est utilisé, à ajouter des inscriptions au mandataire REST et à voir et modifier les noeuds mandataires REST.

Comment le mandataire REST est-il utilisé?

Le mandataire REST mappe une identité d'application à un membre de la chaîne de blocs, ce qui permet aux utilisateurs et aux applications d'appeler les API REST d'Oracle Blockchain Platform.

Au lieu d'utiliser les API Hyperledger Fabric natives, Oracle Blockchain Platform peut utiliser le mandataire REST pour interagir avec le réseau Hyperledger Fabric. Lorsque vous utilisez les API Hyperledger Fabric natives, vous vous connectez directement aux pairs et au responsable des commandes. En revanche, le mandataire REST vous permet d'interroger ou d'appeler un code de chaîne Fabric au moyen du protocole RESTful.

Ajouter des inscriptions au mandataire REST

Vous pouvez ajouter des inscriptions Hyperledger Fabric au mandataire REST. Les inscriptions permettent aux utilisateurs d'appeler le mandataire 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 dans Blockchain Platform, et non dans IDCS.

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

1. Allez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, recherchez le noeud mandataire REST auquel vous voulez ajouter une inscription, puis cliquez sur le menu Action pour ce noeud.
3. Cliquez sur Voir ou gérer les inscriptions pour voir la liste des inscriptions courantes du noeud.
   Une liste des inscriptions courantes 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 inscription, entrez le nom de l'inscription à ajouter.
   Le code d'inscription ne peut contenir que des caractères alphanumériques, des tirets (-) et des traits de soulignement (_).
6. Facultativement, 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 :

   • L'inscription est créée et s'affiche dans la table Inscriptions.
   • La nouvelle inscription est copiée dans chaque noeud mandataire 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 retourné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 un deux-points ( :) ne sont pas pris en charge pour les appels d'API REST qui utilisent l'authentification de base.
7. Dans le volet Utilisateurs clients REST associés, vous pouvez voir et gérer tous les utilisateurs associés à une inscription courante, 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 de courriel ou l'ID d'un utilisateur auquel le rôle REST_USER est déjà affecté. Cliquez sur Associer.

Après avoir 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 indiqué dans les détails du bloc sera répertorié comme nouvelle inscription plutôt que comme utilisateur par défaut initial.

Voir et modifier la configuration du noeud mandataire REST

La configuration d'un noeud mandataire REST détermine le fonctionnement et le comportement du noeud sur le réseau.

Seuls les administrateurs peuvent modifier la configuration d'un noeud. Si vous disposez des autorisations d'utilisateur, vous pouvez voir les paramètres de configuration d'un noeud. Voir Attributs de noeud mandataire REST.

1. Allez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, allez à la table Noeuds, localisez le noeud mandataire REST pour lequel vous voulez 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 Voir.
   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 journal et Journalisation des événements de transaction du noeud, au besoin.
5. Cliquez sur Soumettre pour enregistrer les modifications de configuration, ou cliquez sur X pour fermer la boîte de dialogue Configurer.

Voir les informations sur l'état d'un noeud mandataire REST

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

Le volet État affiche les mesures de performance suivantes : utilisation de l'UC et utilisation de la mémoire.

1. Allez à la console et sélectionnez l'onglet Noeuds.
2. Dans l'onglet Noeuds, cliquez sur le noeud mandataire REST pour lequel vous voulez voir les informations d'état.
   La page Informations sur le noeud s'affiche.
3. Cliquez sur le volet État pour voir les mesures de performance du noeud.
   Si les pourcentages d'utilisation sont toujours élevés, communiquez avec Oracle Support.