Gérer les canaux
Cette rubrique contient des informations sur la gestion des canaux de votre réseau, telles que la création et la consultation de canaux, la jointure de pairs et la désignation et l'ancrage d'un pair, l'utilisation de politiques et de listes de contrôle d'accès, et l'association de responsables des commandes à un canal.
À quoi servent les canaux?
Les canaux partitionnent et isolent les pairs et les données du livre pour fournir des transactions privées et confidentielles sur le réseau de la chaîne de blocs.
- pairs;
- Un livre partagé
- Codes de chaîne déployés sur le canal
- Un ou plusieurs noeuds de service de commande
- Définitions de stratégie de canal et listes de contrôle d'accès où les définitions sont appliquées
Chaque pair qui rejoint un canal possède sa propre identité qui l'authentifie auprès des pairs et des services du canal. Bien que les pairs puissent appartenir à plusieurs canaux, les informations sur les transactions, l'état du livre et l'appartenance au canal sont limitées aux pairs de chaque canal.
Vous pouvez utiliser la console Oracle Blockchain Platform ou la trousse SDK Hyperledger Fabric pour créer des canaux sur votre réseau de chaîne de blocs. Voir Voir les canaux.
Voir les canaux
Les membres de votre réseau utilisent des canaux pour communiquer en privé les informations sur les transactions de la chaîne de blocs.
Créer un canal
Vous pouvez ajouter des canaux au réseau et spécifier les membres qui peuvent utiliser le canal, ainsi que les pairs qui peuvent se joindre au canal. Vous ne pouvez pas supprimer des canaux.
Vous devez être un administrateur pour terminer cette tâche.
-
Déployer un code de chaîne sur le canal. Voir Déployer un code de chaîne.
-
Si le réseau contient des participants, ceux-ci utilisent leurs consoles pour rejoindre leurs pairs membres au canal. Voir Joindre un pair à un canal.
Voir l'activité de livre d'un canal
Utilisez le grand livre pour rechercher des informations sommaires et des statistiques d'exécution pour les transactions sur un canal spécifique.
Voir ou mettre à jour la liste des organisations d'un canal
Vous pouvez voir la liste des organisations qui ont accès au canal. Si vous avez créé le canal, vous pouvez modifier les autorisations d'une organisation sur le canal et vous pouvez y ajouter des organisations ou les supprimer du canal.
Rejoindre un pair à un canal
Vous pouvez ajouter un noeud pair à un canal afin qu'il puisse l'utiliser pour échanger des informations de transaction privées avec d'autres noeuds pairs sur le canal.
-
Lorsque vous créez un canal, vous spécifiez les noeuds pairs locaux qui peuvent le joindre.
-
Si vous créez un réseau contenant un participant, vous pouvez le sélectionner en tant que membre sur le canal. Vous pouvez également ajouter le participant après la création du canal.
-
Votre instance comporte plusieurs domaines de disponibilité ou domaines d'erreur, et Oracle recommande de joindre un pair de chaque partition au canal. En effet, si un noeud de travail n'est pas disponible, le canal reste disponible pour les endossements et les validations. Pour déterminer dans quel domaine se trouve un pair, dans le menu Actions supplémentaires, sélectionnez Afficher les informations sur le domaine de disponibilité pour voir les informations sur le domaine de disponibilité.
- Vous pouvez joindre un maximum de sept pairs à partir de chaque domaine.
Voir Créer un canal.
Vous devez être un administrateur pour effectuer cette tâche.
Ajouter un pair d'ancrage
Chaque membre utilisant un canal doit désigner au moins un pair d'ancrage. Les pairs ancres sont les principaux points de contact du réseau et sont utilisés pour détecter et communiquer avec d'autres pairs du réseau sur le canal.
Vous pouvez désigner un ou plusieurs pairs de votre organisation en tant que pair d'ancrage sur un canal. Pour un réseau à haute disponibilité, vous pouvez spécifier au moins deux homologues d'ancrage. Tous les membres qui utilisent le canal réseau doivent utiliser leur console pour désigner un ou plusieurs de leurs noeuds pairs comme pairs d'ancrage.
Vous devez être un administrateur pour effectuer cette tâche.
Modifier ou supprimer un pair d'ancrage
Vous pouvez modifier ou supprimer les pairs d'ancrage d'un canal. Les pairs ancres sont les principaux points de contact du réseau et sont utilisés pour détecter et communiquer avec d'autres pairs du réseau sur le canal.
Avant de modifier ou de supprimer les pairs d'ancrage du canal, notez les informations suivantes :
- Pour communiquer sur le canal, vous devez désigner un ou plusieurs pairs de votre organisation en tant que pair d'ancrage.
- Pour un réseau à haute disponibilité, vous pouvez spécifier au moins deux homologues d'ancrage.
- Tous les membres qui utilisent le canal réseau doivent utiliser leur console pour désigner un ou plusieurs de leurs noeuds pairs comme pairs d'ancrage.
Vous devez être un administrateur pour effectuer cette tâche.
Voir les informations sur les codes de chaîne déployés
Vous pouvez voir les informations sur les codes de chaîne déployés sur les différents canaux de votre réseau.
- Allez à la console et sélectionnez l'onglet Canaux.
- Dans le tableau des canaux, cliquez sur le nom du canal avec le code de chaîne pour lequel vous voulez voir les informations.
- Dans la page Informations sur le canal, vérifiez que le volet Codes de chaîne déployés est sélectionné
- Dans le tableau de code de chaîne, vous pouvez :
- Cliquez sur l'ID de l'ensemble de code de chaîne pour aller à l'onglet Codes de chaîne pour en savoir plus. Par exemple, les pairs sur lesquels le code de chaîne est installé et les canaux sur lesquels le code de chaîne est déployé.
- Dans le menu Plus d'actions d'un code de chaîne, cliquez sur Voir la définition de code de chaîne pour trouver des détails sur la définition du code de chaîne, y compris la politique d'endossement.
- (Facultatif) Si vous voyez une liste de canaux sans code de chaîne, vous pouvez aller à l'onglet Codes de chaîne et déployer un code de chaîne sur le canal. Voir Déployer un code de chaîne.
Utiliser les politiques de canal et les listes de contrôle d'accès
Cette rubrique contient des informations sur les politiques et les listes de contrôle d'accès d'un canal. Il fournit un aperçu des politiques, des types de politique et de la façon de les modifier, ainsi que de l'utilisation des listes de contrôle d'accès pour gérer les organisations et les rôles qui peuvent accéder aux ressources d'un canal.
À quoi servent les politiques de canal?
Une stratégie définit un ensemble de conditions. Les parties requises doivent respecter les conditions de la politique avant que leurs signatures ne soient considérées comme valides et que la demande correspondante ait lieu sur le réseau.
Le réseau de chaîne de blocs est géré par ces politiques. Les politiques vérifient l'identité associée à une demande par rapport à la politique associée à la ressource nécessaire pour exécuter la demande. Les politiques se trouvent dans la configuration du canal.
Après avoir configuré les politiques du canal, vous les affectez aux ressources des listes de contrôle d'accès du canal afin de déterminer les membres à signer avant qu'une modification ou une action ne se produise sur le canal. Par exemple, supposons que vous ayez modifié la politique Writers pour inclure des membres de l'organisation A ou de l'organisation B. Vous avez ensuite affecté la politique Writers à la ressource de liste de contrôle d'accès cscc/GetConfigBlock du canal. Désormais, seul un membre de l'organisation A ou de l'organisation B peut appeler GetConfigBlock sur le composant cscc.
Quels sont les types de politique?
Il existe deux types de politique : Signature et ImplicitMeta.
- Signature — Spécifie une combinaison de règles d'évaluation. Il prend en charge les combinaisons de ET, OU et NOutOf. Par exemple, vous pouvez définir quelque chose comme "un administrateur de l'organisation A et 2 autres administrateurs" ou "11 de 20 administrateurs d'organisations".
Toutes les nouvelles politiques que vous créez seront des politiques de signature.
- ImplicitMeta — Ce type de politique n'est valide que dans le contexte de la configuration. Il agrège le résultat de l'évaluation des stratégies plus en profondeur dans la hiérarchie de configuration, qui sont définies par des stratégies Signature. Il prend en charge les règles par défaut, par exemple "Une majorité des politiques d'administration de l'organisation".
Quand les politiques sont-elles créées?
Lorsque vous ajoutez un canal au réseau, Oracle Blockchain Platform crée des politiques par défaut. Les politiques par défaut sont les suivantes : Admins, Writers, Readers, Endorsement, LifecycleEndorsement (politiques ImplicitMeta) et Creator (politique de signature). Vous pouvez modifier ces politiques au besoin ou créer des politiques.
Notez le problème important suivant concernant les politiques de canal :
-
Vous pouvez utiliser la console pour créer un canal et régler la liste de contrôle d'accès de votre organisation à ReaderOnly. Après avoir enregistré le nouveau canal, vous ne pouvez pas mettre à jour ce paramètre de liste de contrôle d'accès à partir de l'option Modifier l'organisation du canal.
Toutefois, vous pouvez utiliser la fonctionnalité Gérer les politiques de canal de la console pour ajouter votre organisation à la politique Writers, qui remplace le paramètre de liste de contrôle d'accès ReaderOnly du canal.
Ajouter ou modifier les politiques d'un canal
Vous pouvez ajouter ou modifier la politique d'un canal pour spécifier les membres requis pour effectuer une action spécifique sur le canal. Après avoir défini des politiques, vous les affectez aux listes de contrôle d'accès du canal.
Avant d'ajouter ou de mettre à jour des politiques, vous devez comprendre comment Oracle Blockchain Platform crée des politiques de canal par défaut. Voir À quoi servent les politiques de canal?.
Vous devez être un administrateur pour effectuer cette tâche.
- Allez à la console et sélectionnez l'onglet Canaux.
L'onglet Canaux s'affiche et la table des canaux contient une liste de tous les canaux de votre réseau.
- Dans le tableau des canaux, cliquez sur le nom du canal pour lequel vous souhaitez ajouter ou modifier des politiques.
La page Informations sur le canal s'affiche.
- Dans la page Informations sur le canal, cliquez sur le volet Politiques de canal.
- Effectuez l'une des actions suivantes :
- Pour ajouter une nouvelle politique, cliquez sur le bouton Créer une politique. La boîte de dialogue Créer une politique s'affiche. Entrez un nom dans le champ Nom de la politique et sélectionnez Signature dans le champ Type de politique. Développez la section Politique de signature.
- Pour modifier une politique existante, cliquez sur son nom. La boîte de dialogue Mettre à jour la politique s'affiche.
- Cliquez sur le bouton Ajouter une identité pour ajouter une organisation. Ou modifiez une politique de signature existante selon les besoins. Notez les informations suivantes :
Champ Description ID PBM Dans le menu déroulant, sélectionnez l'organisation qui doit signer la politique. Rôle Sélectionnez le rôle de pair correspondant requis par la politique. Habituellement, il sera membre. Vous pouvez trouver le rôle d'un pair en consultant ses informations de configuration. Mode d'expression de politique Dans la plupart des cas, vous utiliserez De base. Sélectionnez Avancé pour écrire une chaîne d'expression à l'aide de AND, OR et NOutOf. Pour plus d'informations sur l'écriture d'une chaîne d'expression de politique valide, voir Politiques d'endossement dans la documentation sur Hyperledger Fabric. Signé par Sélectionnez le nombre de membres qui doivent signer la politique pour exécuter la demande. - Si vous ajoutez une nouvelle politique, cliquez sur Créer. Si vous modifiez une politique, cliquez sur Mettre à jour.
Supprimer les politiques d'un canal
Vous pouvez supprimer les politiques de canal que vous avez créées.
Vous ne pouvez pas supprimer les politiques par défaut : Admins, Creator, Readers, Writers, Endorsement et LifecycleEndorsement. De plus, vous ne pouvez pas supprimer une politique de canal si elle est affectée à une liste de contrôle d'accès. Avant de tenter de supprimer une politique de canal, vérifiez que celle-ci n'est pas affectée.
Vous devez être un administrateur pour effectuer cette tâche.
- Allez à la console et sélectionnez l'onglet Canaux.
L'onglet Canaux s'affiche et la table des canaux contient une liste de tous les canaux de votre réseau.
- Dans la table des canaux, cliquez sur le canal à partir duquel vous voulez supprimer une politique.
La page Informations sur le canal s'affiche.
- Dans la page Informations sur le canal, cliquez sur le volet Politiques de canal.
- Localisez la politique à supprimer et cliquez sur son bouton Options supplémentaires.
- Cliquez sur Supprimer et confirmez la suppression.
Que sont les listes de contrôle d'accès de canal?
Les listes de contrôle d'accès (LCA) utilisent des politiques pour gérer les organisations et les rôles qui peuvent accéder aux ressources d'un canal.
Les utilisateurs interagissent avec le réseau de chaîne de blocs en ciblant des composants tels que le code de chaîne de système d'interrogation (qscc), le code de chaîne de cycle de vie (_lifecycle), le code de chaîne de système de configuration (cscc), les pairs et l'événement. Ces composants sont associés à des ressources spécifiques (par exemple, GetConfigBlock ou GetChaincodeData) auxquelles vous pouvez affecter des politiques au niveau du canal. Ces politiques font partie de la configuration du canal.
Une politique définit les organisations et les rôles qui peuvent demander une ressource. Lorsqu'une demande est faite, la politique indique au système de vérifier l'identité du demandeur et de déterminer s'il est autorisé à faire la demande. Lorsque vous créez un canal, Oracle Blockchain Platform inclut les listes de contrôle d'accès Hyperledger Fabric par défaut avec le canal. Oracle Blockchain Platform crée également des politiques par défaut (administrateur, créateur, rédacteurs, lecteurs, endossement et LifecycleEndorsement) pour le canal. Vous pouvez modifier ces politiques ou créer des politiques au besoin. Voir À quoi servent les politiques de canal?.
Mettre à jour les listes de contrôle d'accès de canal
Vous pouvez mettre à jour les listes de contrôle d'accès du canal en affectant des politiques aux ressources du canal. Une politique définit les organisations et les rôles pouvant demander une ressource
Vous devez comprendre les politiques et les listes de contrôle d'accès avant de mettre à jour les listes de contrôle d'accès d'un canal. Pour plus d'informations, voir À quoi servent les listes de contrôle d'accès de canal?.
- Allez à la console et cliquez sur l'onglet Canaux.
La page Canaux s'affiche et la table des canaux contient une liste de tous les canaux de votre réseau.
- Dans le tableau des canaux, cliquez sur le nom du canal pour lequel vous voulez mettre à jour les listes de contrôle d'accès.
La page Informations sur le canal s'affiche.
- Dans la page Informations sur le canal, cliquez sur le volet LCA.
- Dans le tableau Ressources, localisez la ressource à mettre à jour. Cliquez sur le bouton Développer de la ressource et sélectionnez la politique à affecter à la ressource.
- Modifiez les politiques de l'autre ressource si nécessaire.
- Cliquez sur Mettre à jour les listes de contrôle d'accès.
Ajouter ou supprimer des responsables de commande vers ou depuis un canal
L'organisation d'administration du donneur d'ordre peut ajouter ou supprimer des donneurs d'ordre d'un canal.
- Dans la console du fondateur, ouvrez l'onglet Canaux et sélectionnez le canal pour voir sa vue détaillée.
- Ouvrez le sous-onglet Commandeurs. Tous les noeuds de tri actuellement joints au canal sont répertoriés.
- Cliquez sur Join Channel (Se joindre au canal). Sélectionnez un OSN qui ne figure pas encore dans ce canal et cliquez sur Joindre.
- Dans la console du fondateur, ouvrez l'onglet Canaux et sélectionnez le canal pour voir sa vue détaillée.
- Ouvrez le sous-onglet Commandeurs. Tous les noeuds de tri actuellement joints au canal sont répertoriés.
- Sélectionnez le responsable de la commande à supprimer du canal et, dans le menu Plus d'actions du canal, sélectionnez Supprimer.
Définir l'organisation de l'administrateur des commandes
Vous pouvez affecter l'administration des OSN dans un canal à n'importe quelle organisation. Normalement, le fondateur ou le créateur du canal serait affecté.
- Dans la console du fondateur, ouvrez l'onglet Canaux.
- Sélectionnez le canal pour lequel vous souhaitez définir l'organisation de l'administrateur du responsable des commandes et, dans le menu Action, sélectionnez Gérer l'administrateur OSN.
- Sélectionnez une organisation dans la liste des organisations disponibles, puis cliquez sur Soumettre.
Modifier les paramètres du service de commande pour un canal
Vous pouvez mettre à jour les paramètres de service de commande pour un canal particulier.
- Vous pouvez mettre à jour les paramètres du service de commande pour l'ensemble du réseau, comme décrit sous Modifier les paramètres du service de commande pour le réseau.
- Si vous modifiez les paramètres du service de commande et que des applications s'exécutent sur le réseau, ces applications doivent être mises à jour manuellement pour utiliser les paramètres du service de commande révisés.
- Ce n'est pas courant, mais dans certaines situations, vous pouvez exposer un service de commande différent à certains des participants au réseau. Dans ce cas, vous allez exporter le bloc de configuration réseau mis à jour et les participants requis vont importer les paramètres révisés. Voir Se joindre aux OSN du participant ou évolués au service de commande du fondateur.