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

Les inscriptions permettent aux utilisateurs d'appeler le mandataire REST sans certificat d'inscription. Pour les inscriptions, un nouveau groupe d'utilisateurs doit être défini sur votre 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 mandataire 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 nouveau groupe Active Directory nommé <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Ajoutez tous les utilisateurs qui doivent utiliser l'inscription personnalisée à ce groupe.
3. Allez à la console Blockchain Platform et sélectionnez l'onglet Noeuds.
4. Dans l'onglet Noeuds, recherchez le noeud mandataire REST auquel vous voulez ajouter une inscription et ouvrez le menu Actions supplémentaires.
5. Cliquez sur Voir ou créer des inscriptions pour voir la liste des inscriptions courantes du noeud.
6. Cliquez sur Créer une inscription.
7. Dans le champ Nom d'utilisateur, entrez <custom enrolment name> à partir de la première étape. Notez que cette opération 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 dans chaque noeud mandataire 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 mandataire REST crée un nouveau 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, 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 et ouvrez le menu Actions supplémentaires.
3. Cliquez sur Voir ou créer des inscriptions pour voir la liste des inscriptions courantes du noeud.
4. Cliquez sur Créer une inscription.
   La boîte de dialogue Créer une nouvelle inscription s'affiche.
5. Dans le champ Nom d'utilisateur, entrez un nom pour 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.
   • Nouveau rôle d'utilisateur dans le groupe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sur votre serveur LDAP.

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.