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 blockchain, 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 qu'un nouveau groupe d'utilisateurs soit défini sur votre serveur d'authentification.

Ajout d'inscriptions lors de l'utilisation de Microsoft Active Directory comme serveur d'authentification

Pour ajouter une inscription au proxy REST, un nouveau groupe d'utilisateurs doit être ajouté à Active Directory : <Rest Proxy Client Users group name>_<custom enrolment name>. Vous pouvez ensuite utiliser la console Blockchain Platform pour mettre en correspondance l'inscription avec 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 qui ont 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> à partir de la première étape. Notez qu'il est sensible à la casse et doit correspondre au groupe d'utilisateurs que vous avez créé. Cliquez sur Enroll (S'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.

Ajout d'inscriptions lors de l'utilisation de OpenLDAP ou d'Oracle Internet Directory comme serveur d'authentification

L'ajout d'une inscription au proxy REST crée un rôle utilisateur dans le groupe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sur le 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 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 et ouvrez le menu Actions supplémentaires.
3. Cliquez sur Afficher 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 apparaît.
5. Dans le champ Nom utilisateur, entrez le nom de 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.
   • Un nouveau rôle 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 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.