Gérer les noeuds de proxy REST

Cette rubrique contient des informations qui vous aident à comprendre comment le proxy REST est utilisé, à ajouter des inscriptions au proxy REST et à visualiser et modifier les noeuds de proxy REST.

Comment est utilisé le proxy REST ?

Le proxy REST met en correspondance une identité d'application avec un membre de chaîne de blocs. Les utilisateurs et les applications peuvent ainsi 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 Hyperledger 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 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 inscription, entrez le nom de l'inscription à ajouter.
   Le code inscription ne peut comporter que des caractères alphanumériques, des traits d'union (-) et des traits de soulignement (_).
6. Vous pouvez éventuellement, dans le champ ID utilisateur, entrer l'ID d'un utilisateur doté du rôle REST_USER à associer à l'inscription. 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 sur chaque noeud de proxy REST du réseau.
   • Si vous avez indiqué un ID utilisateur, cet ID 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 indiqué 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. 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 afficher 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 indiqué dans les détails du bloc est répertorié en tant que nouvelle inscription et non en tant qu'utilisateur par défaut initial.

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 des 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 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 apparaît.
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, 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.