1. Utilisation d'Oracle Blockchain Platform
  2. Extension du réseau
  3. Ajouter des organisations Fabric au réseau

Ajouter des organisations Fabric au réseau

Cette rubrique contient des informations sur la jointure d'organisations Hyperledger Fabric à un réseau Oracle Blockchain Platform.

Workflow standard pour joindre une organisation Fabric à un réseau Oracle Blockchain Platform

Voici les tâches qu'une organisation Fabric et l'organisation fondatrice d'Oracle Blockchain Platform doivent effectuer pour rejoindre une organisation Fabric au réseau Oracle Blockchain Platform.

Tâche Qui fait ça ? Description En savoir plus
Créer le fichier de certificat pour l'organisation Fabric Organisation Fabric Recherchez les informations de certificat Admin, CA et TLS de l'organisation Fabric et utilisez-les pour composer un fichier de certificats JSON. Création du fichier de certificats d'une organisation Fabric
Téléchargement du fichier de certificat de l'organisation Fabric vers le réseau Oracle Blockchain Platform Organisation fondatrice Utilisez la console pour télécharger et importer le fichier de certificat de l'organisation Fabric afin d'ajouter l'organisation Fabric au réseau. Import de certificats pour ajouter des organisations au réseau
Créer un canal Organisation fondatrice Créez un canal et ajoutez-y l'organisation Fabric. Créer un canal
Exporter les paramètres du service de commande du fondateur Organisation fondatrice Affichez les paramètres des services de commande du fondateur dans un fichier JSON et envoyez le fichier à l'organisation Fabric. Rejoindre le participant ou les OSN évolutifs au service de commande du fondateur
Composer le fichier de certificat du donneur d'ordre Organisation Fabric Créez un fichier nommé orderer.pem qui inclut les informations tlscacert.

Accédez au fichier de paramètres du service de commande exporté et copiez les informations de tlscacert. Après avoir collé les informations tlscacert dans le fichier orderer.pem, vous devez remplacer toutes les instances de \n par le caractère de nouvelle ligne.

Le format du fichier orderer.pem doit être le suivant :

-----BEGIN CERTIFICATE-----
... 
...
... 
-----END CERTIFICATE-----
 Création du fichier de certificats d'une organisation Fabric
Fournir les paramètres du service de commande Organisation fondatrice Ouvrez le fichier de paramètres du service de commande et recherchez l'adresse et le port du service de commande et donnez-les à l'organisation Fabric. Exemple :
"orderingServiceNodes": [
{
"address": "grpcs://example_address:7777",
...
}]
 S/O
Ajouter l'organisation Fabric au réseau Organisation Fabric L'organisation Fabric copie les certificats dans son environnement, définit les variables d'environnement, extrait le bloc de genesis, rejoint le canal et installe le code chaîne. Préparation de l'environnement Fabric à l'utilisation du réseau Oracle Blockchain Platform

Création du fichier de certificats d'une organisation Fabric

Pour qu'une organisation Fabric rejoigne un réseau Oracle Blockchain Platform, elle doit écrire un fichier de certificats contenant ses informations sur les administrateurs, les cacerts et les tlscacerts. L'organisation fondatrice d'Oracle Blockchain Platform importe ce fichier pour ajouter l'organisation Fabric au réseau.

Les informations sur les certificats Fabric sont stockées dans des fichiers PEM situés dans le dossier MSP de l'organisation Fabric. Par exemple, network_name_example/crypto-config/peerOrganizations/example_org.com/msp/.

Le fichier de certificats doit être écrit au format JSON et doit contenir les champs suivants. Pour tous les certificats, lorsque vous copiez les informations de certificat dans le fichier JSON, vous devez remplacer chaque nouvelle ligne par \n, de sorte que les informations soient toutes sur une seule ligne sans espace, comme indiqué dans l'exemple suivant.

  • mspid - Spécifie le nom de l'organisation Fabric.

  • type - Indique que l'organisation est un participant réseau. Cette valeur doit être Participant.

  • admincert - Contient le contenu du fichier de certificats Admin de l'organisation : Admin@example_org.com-cert.pem.

  • cacert - Contient le contenu du fichier de certificats d'autorité de certification de l'organisation : CA.example_org-cert.pem.

  • tlscacert - Contient le contenu du fichier de certificat TLS de l'organisation : tlsca.example_org-cert.pem.

  • intermediatecerts : cet élément facultatif contient le contenu d'un fichier de certificats CA intermédiaires. Ne spécifiez cet élément que s'il existe un fichier de certificats CA intermédiaire.
  • nodeouidentifiercert- Cette section contient les certificats qui identifient les rôles OU de noeud.

  • adminouidentifiercert - Contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles d'administrateur d'unité opérationnelle de noeud. Si vous n'avez pas besoin du rôle admin, vous pouvez utiliser le contenu du fichier cacert ou le contenu du fichier de certificat intermédiaire comme contenu adminouidentifier.

  • clientouidentifiercert - Contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles client d'unité opérationnelle de noeud.

  • ordererouidentifiercert : contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles de donneur d'ordres d'unité opérationnelle de noeud. Si vous n'avez pas besoin du rôle de donneur d'ordre, vous pouvez utiliser le contenu du fichier cacert ou le contenu du fichier de certificat intermédiaire comme contenu de l'identifiant de donneur d'ordre.

  • peerouidentifiercert - Contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles homologues de l'unité opérationnelle de noeud.

Structurez le fichier comme dans l'exemple suivant : 
{
  "mspID": "examplemspID",
  "type":  "Participant",
  "certs": { 
   "admincert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n",
   "cacert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n",
   "tlscacert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n"
   "nodeouidentifiercert": {
      "adminouidentifiercert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n",
      "clientouidentifiercert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n",
      "ordererouidentifiercert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n",
      "peerouidentifiercert": "-----BEGIN CERTIFICATE-----\nexample_certificate\nexample_certificate==\n-----END CERTIFICATE-----\n"
    }
  }
}

Préparation de l'environnement Fabric pour l'utilisation du réseau Oracle Blockchain Platform

Vous devez modifier l'environnement de l'organisation Fabric avant de pouvoir utiliser le réseau Oracle Blockchain Platform.

Vérifiez que les tâches prérequises suivantes sont terminées. Pour plus d'informations, reportez-vous à Workflow standard pour rejoindre une organisation Fabric à un réseau Oracle Blockchain Platform.

  • Le fichier de certificat de l'organisation Fabric a été créé et envoyé au fondateur du réseau Oracle Blockchain Platform.

  • Le fondateur du réseau a téléchargé le fichier de certificats pour ajouter l'organisation Fabric au réseau.

  • Le fondateur du réseau a créé un nouveau canal et y a ajouté l'organisation Fabric.

  • Le fondateur du réseau a téléchargé ses paramètres de service de commande et les a envoyés à l'organisation Fabric.

  • L'organisation Fabric a créé le fichier de certificat du donneur d'ordre.

  • Le fondateur du réseau a donné l'adresse et le port du service de commande à l'organisation Fabric.

Vous devez ajouter l'organisation Fabric et installer et tester le code chaîne.

  1. Accédez au répertoire réseau Fabric et lancez le conteneur homologue.

  2. Récupérez le bloc genesis du canal à l'aide de la commande suivante : 

    peer channel fetch 0 mychannel.block -o ${orderer_addr}:${orderer_port} -c mychannel --tls --cafile orderer.pem --logging-level debug

    Où :

    • {orderer_addr} est l'adresse du donneur d'ordre du fondateur.

    • {orderer_port} est le numéro de port du fondateur.

    • -c mychannel est le nom du canal créé par le fondateur. Canal où l'organisation Fabric envoie et reçoit des transactions sur le réseau Oracle Blockchain Platform.

    • orderer.pem est le fichier de certificat du donneur d'ordre du fondateur.

  3. Rejoignez le canal avec cette commande :

    peer channel join -b mychannel.block -o ${orderer_addr}:${orderer_port} --tls --cafile orderer.pem --logging-level debug

  4. Installez le code de chaîne à l'aide de la commande suivante :

    peer chaincode install -n mycc -v 1.0 -l "golang" -p ${CC_SRC_PATH}

    Où CC_SRC_PATH est le dossier contenant le code chaîne.

  5. Instanciez le code de chaîne à l'aide de la commande suivante :

    peer chaincode instantiate -o  ${orderer_addr}:${orderer_port} --tls --cafile orderer.pem -C mychannel -n mycc -l golang -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P <policy_string> --logging-level debug

  6. Appelez le code chaîne à l'aide de la commande suivante :

    peer chaincode invoke -o ${orderer_addr}:${orderer_port}  --tls true --cafile orderer.pem -C mychannel -n mycc -c '{"Args":["invoke","a","b","10"]}' --logging-level debug

  7. Interrogez le code chaîne à l'aide de la commande suivante :

    peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'  --logging-level debug