Ajouter des organisations Fabric au réseau

Flux de travail type 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 joindre une organisation Fabric au réseau Oracle Blockchain Platform.

Tâche	Qui fait ça?	Description	Informations supplémentaires
Créer le fichier de certificat pour l'organisation Fabric	Organisation de tissus	Recherchez les informations sur les certificats Admin, CA et TLS de l'organisation Fabric et utilisez-les pour composer un fichier de certificats JSON.	Créer un fichier de certificats d'organisation Fabric
Charger le fichier de certificat de l'organisation Fabric dans le réseau Oracle Blockchain Platform	Organisation fondatrice	Utilisez la console pour charger et importer le fichier de certificat de l'organisation Fabric afin d'ajouter l'organisation Fabric au réseau.	Importer des certificats pour ajouter des organisations au réseau
Créer un canal	Organisation fondatrice	Créez un nouveau canal et ajoutez-y l'organisation Fabric.	Créer un canal
Exporter les paramètres du service de commande du fondateur	Organisation fondatrice	Émettez les paramètres des services de commande du fondateur dans un fichier JSON et envoyez le fichier à l'organisation Fabric.	Rejoignez le participant ou les OSN évolués au service de commande du fondateur
Composer le fichier de certificat du ordonnateur	Organisation de tissus	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 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 fichier orderer.pem doit avoir le format suivant : `-----BEGIN CERTIFICATE----- ... ... ... -----END CERTIFICATE-----`	Créer un fichier de certificats d'organisation Fabric
Fournir des paramètres de 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. Par exemple : `"orderingServiceNodes": [ { "address": "grpcs://example_address:7777", ... }]`	S.O.
Ajouter l'organisation Fabric au réseau	Organisation de tissus	L'organisation Fabric copie les certificats dans son environnement, définit les variables d'environnement, extrait le bloc de genèse, joint le canal et installe le code de chaîne.	Préparer l'environnement Fabric pour utiliser le réseau Oracle Blockchain Platform

Créer un fichier de certificats d'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 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 se trouvent toutes sur une ligne sans espace, comme illustré dans l'exemple suivant.

mspid - Spécifie le nom de l'organisation Fabric.
type - Indique que l'organisation est un participant au réseau. Cette valeur doit être Participant.
admincert - Contient le contenu du fichier de certificats d'administration de l'organisation : Admin@example_org.com-cert.pem.
cacert - Contient le contenu du fichier de certificats AC 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 d'autorité de certification intermédiaire. Ne spécifiez pas cet élément sauf s'il existe un fichier de certificats AC intermédiaire.
nodeouidentifiercert - Cette section contient des 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é organisationnelle de noeud. Si vous n'avez pas besoin du rôle d'administrateur, 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 qui est utilisé pour identifier les rôles clients OU de noeud.
ordererouidentifiercert - Contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles de responsable de la commande de l'unité organisationnelle du noeud. Si vous n'avez pas besoin du rôle d'ordonnateur, vous pouvez utiliser le contenu du fichier cacert, ou le contenu du fichier de certificat intermédiaire, comme contenu de ordererouidentifier.
peerouidentifiercert - Contient le contenu du fichier de certificat de l'organisation utilisé pour identifier les rôles homologues d'unité organisationnelle de noeud.

Structurer 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éparer l'environnement Fabric pour utiliser le réseau Oracle Blockchain Platform

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

Vérifiez que les tâches préalables suivantes sont terminées. Pour plus d'informations, voir Flux de travail type pour joindre 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 responsable de la commande.
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 de chaîne.

Accédez au répertoire du réseau Fabric et lancez le conteneur pair.
Extrayez le bloc de genèse du canal avec cette commande :
```
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 l'instance fondatrice. Il s'agit du canal dans lequel l'organisation Fabric enverra et recevra des transactions sur le réseau Oracle Blockchain Platform.
- orderer.pem est le fichier de certificat du ordonnateur du fondateur.

Joignez le canal à l'aide de la commande suivante :

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

Installez le code de chaîne avec cette commande :
```
peer chaincode install -n mycc -v 1.0 -l "golang" -p ${CC_SRC_PATH}
```
Où CC_SRC_PATH est le dossier qui contient le code de chaîne.

Instancier le code de chaîne avec cette commande :

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

Appelez le code de chaîne avec cette commande :

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

Interrogez le code de chaîne avec cette commande :

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