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

Les inscriptions permettent aux utilisateurs d'appeler le proxy REST sans certificat d'inscription. Les inscriptions nécessitent la définition d'un nouveau groupe d'utilisateurs sur le serveur d'authentification.

Ajout d'inscriptions lors de l'utilisation de Microsoft Active Directory en tant que serveur d'authentification

L'ajout d'une inscription au proxy REST nécessite l'ajout d'un nouveau groupe d'utilisateurs à Active Directory : <Rest Proxy Client Users group name>_<custom enrolment name>. Vous pouvez ensuite utiliser la console Blockchain Platform pour mapper l'inscription à ce groupe.

1. Créez un groupe Active Directory nommé <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Ajoutez à ce groupe tous les utilisateurs ayant besoin d'utiliser l'inscription personnalisée.
3. Accédez à la console Blockchain Platform et sélectionnez l'onglet Noeuds.
4. Dans l'onglet Noeuds, recherchez le noeud de proxy REST auquel ajouter une inscription et ouvrez le menu Actions supplémentaires.
5. Cliquez sur Afficher ou créer des inscriptions pour afficher la liste des inscriptions en cours du noeud.
6. Cliquez sur Créer une inscription.
7. Dans le champ Nom utilisateur, entrez <custom enrolment name> à la première étape. Notez qu'il est sensible à la casse et doit correspondre au groupe d'utilisateurs que vous avez créé. Cliquez sur S'inscrire.
   • L'inscription est créée et s'affiche dans la table Inscriptions.
   • La nouvelle inscription est copiée sur chaque noeud proxy REST du réseau.

Ajout d'inscriptions lors de l'utilisation de OpenLDAP ou d'Oracle Internet Directory en tant que serveur d'authentification

L'ajout d'une inscription au proxy REST crée un rôle d'utilisateur dans le groupe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sur votre serveur LDAP.

Une fois l'inscription créée dans la console, l'administrateur utilise le serveur LDAP pour affecter les utilisateurs requis à ce rôle.

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 et ouvrez le menu Actions supplémentaires.
3. Cliquez sur Visualiser ou créer des inscriptions pour afficher la liste des inscriptions en cours du noeud.
4. Cliquez sur Créer une inscription.
   La boîte de dialogue Créer une inscription s'affiche.
5. Dans le champ Nom utilisateur, entrez le nom de 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 proxy REST du réseau.
   • Un nouveau rôle d'utilisateur dans le groupe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sur votre serveur LDAP.

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.