Aggiungere organizzazioni Fabric alla rete

In questo argomento vengono fornite informazioni sull'adesione delle organizzazioni Hyperledger Fabric a una rete Oracle Blockchain Platform.

Workflow standard per entrare a far parte di un'organizzazione Fabric in una rete Oracle Blockchain Platform

Un'organizzazione Fabric e l'organizzazione fondatrice di Oracle Blockchain Platform devono completare le seguenti attività per entrare a far parte dell'organizzazione Fabric nella rete Oracle Blockchain Platform.

Task Chi lo fa? Descrizione Ulteriori informazioni
Creare il file di certificato per l'organizzazione Fabric Organizzazione Fabric Trovare le informazioni sul certificato Admin, CA e TLS dell'organizzazione Fabric e utilizzarle per comporre un file di certificati JSON. Creare un file di certificati dell'organizzazione Fabric
Caricare il file di certificato dell'organizzazione Fabric nella rete Oracle Blockchain Platform Organizzazione fondatrice Utilizzare la console per caricare e importare il file di certificato dell'organizzazione Fabric per aggiungere l'organizzazione Fabric alla rete. Importa certificati per aggiungere organizzazioni alla rete
Crea un canale Organizzazione fondatrice Creare un canale e aggiungervi l'organizzazione Fabric. Crea un canale
Esporta le impostazioni del servizio di ordinazione dal fondatore Organizzazione fondatrice Ha scritto le impostazioni dei servizi di ordinazione del fondatore in un file JSON e inviato il file all'organizzazione Fabric. Unisciti alle OSN partecipanti o ridimensionate al servizio di ordinazione del fondatore
Comporre un file di certificato dell'ordinatore Organizzazione Fabric Creare un file denominato orderer.pem che includa le informazioni tlscacert.

Andare al file delle impostazioni del servizio di ordinazione esportato e copiare le informazioni tlscacert. Dopo aver incollato le informazioni di tlscacert nel file orderer.pem, è necessario sostituire tutte le istanze di \n con il carattere di nuova riga.

Il file orderer.pem deve avere il formato seguente: 

-----BEGIN CERTIFICATE-----
... 
...
... 
-----END CERTIFICATE-----
 Creare un file di certificati dell'organizzazione Fabric
Fornire le impostazioni del servizio di ordinazione Organizzazione fondatrice Aprire il file delle impostazioni del servizio di ordinazione e trovare l'indirizzo e la porta del servizio di ordinazione e consegnarli all'organizzazione Fabric, come mostrato nell'esempio riportato di seguito.
"orderingServiceNodes": [
{
"address": "grpcs://example_address:7443",
...
}]
 ND
Aggiungere l'organizzazione Fabric alla rete Organizzazione Fabric L'organizzazione Fabric copia i certificati nel proprio ambiente, imposta le variabili di ambiente, recupera il blocco di genesi, entra nel canale e installa il codice concatenato. Preparare l'ambiente Fabric per utilizzare la rete Oracle Blockchain Platform

Creare un file di certificati dell'organizzazione Fabric

Affinché un'organizzazione Fabric possa entrare a far parte di una rete Oracle Blockchain Platform, deve scrivere un file di certificati contenente le informazioni su amministratori, cacerts e tlscacerts. L'organizzazione fondatrice di Oracle Blockchain Platform importa questo file per aggiungere l'organizzazione Fabric alla rete.

Le informazioni sui certificati Fabric vengono memorizzate nei file PEM presenti nella cartella MSP dell'organizzazione Fabric. Ad esempio, network_name_example/crypto-config/peerOrganizations/example_org.com/msp/.

Il file dei certificati deve essere scritto in formato JSON e deve contenere i seguenti campi. Per tutti i certificati, quando si copiano le informazioni sul certificato nel file JSON, è necessario sostituire ogni nuova riga con \n, in modo che le informazioni siano tutte su una riga senza spazi, come mostrato nell'esempio seguente.

  • mspid: specifica il nome dell'organizzazione Fabric.

  • tipo: indica che l'organizzazione è un partecipante alla rete. Questo valore deve essere Partecipante.

  • admincert: contiene il contenuto del file dei certificati di amministrazione dell'organizzazione: Admin@example_org.com-cert.pem.

  • cacert: contiene il contenuto del file dei certificati CA dell'organizzazione: ca.example_org-cert.pem.

  • tlscacert: contiene il contenuto del file di certificato TLS dell'organizzazione: tlsca.example_org-cert.pem.

  • intermediatecerts: questo elemento facoltativo contiene il contenuto di un file di certificati CA intermedi. Non specificare questo elemento a meno che non sia presente un file di certificati CA intermedio.
  • nodeouidentifiercert: questa sezione contiene certificati che identificano i ruoli OU del nodo.

  • adminouidentifiercert: contiene il contenuto del file di certificato dell'organizzazione utilizzato per identificare i ruoli di amministratore OU del nodo. Se non è necessario il ruolo di amministratore, è possibile utilizzare il contenuto del file cacert o il contenuto del file di certificato intermedio, come contenuto di adminouidentifier.

  • clientouidentifiercert: contiene il contenuto del file di certificato dell'organizzazione utilizzato per identificare i ruoli client OU del nodo.

  • ordererouidentifiercert: contiene il contenuto del file di certificato dell'organizzazione utilizzato per identificare i ruoli dell'ordinatore OU del nodo. Se non è necessario il ruolo di Orderer, è possibile utilizzare il contenuto del file cacert o il contenuto del file certificato intermedio, come contenuto di Ordererouidentifier.

  • peerouidentifiercert: contiene il contenuto del file di certificato dell'organizzazione utilizzato per identificare i ruoli peer OU del nodo.

Strutturare il file in modo simile al seguente esempio: 
{
  "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"
    }
  }
}

Preparare l'ambiente Fabric per utilizzare la rete Oracle Blockchain Platform

È necessario modificare l'ambiente dell'organizzazione Fabric prima che possa utilizzare la rete Oracle Blockchain Platform.

Confermare che i seguenti task prerequisiti sono stati completati. Per ulteriori informazioni, vedere Workflow tipico per l'iscrizione di un'organizzazione Fabric a una rete Oracle Blockchain Platform.

  • Il file di certificato dell'organizzazione Fabric è stato creato e inviato al fondatore della rete Oracle Blockchain Platform.

  • Il fondatore della rete ha caricato il file dei certificati per aggiungere l'organizzazione Fabric alla rete.

  • Il fondatore della rete ha creato un nuovo canale e gli ha aggiunto l'organizzazione Fabric.

  • Il fondatore della rete ha scaricato le impostazioni del servizio di ordinazione e le ha inviate all'organizzazione Fabric.

  • L'organizzazione Fabric ha creato il file del certificato dell'ordinatore.

  • Il fondatore della rete ha fornito l'indirizzo e la porta del servizio di ordinazione all'organizzazione Fabric.

È necessario aggiungere l'organizzazione Fabric e installare ed eseguire il test del codice concatenato.

  1. Passare alla directory di rete Fabric e avviare il contenitore peer.

  2. Recupera il blocco di genesi del canale con questo comando: 

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

    dove:

    • {orderer_addr} è l'indirizzo dell'ordinatore del fondatore.

    • {orderer_port} è il numero di porta del fondatore.

    • -c mychannel è il nome del canale creato dal fondatore. Questo è il canale in cui l'organizzazione Fabric invierà e riceverà le transazioni sulla rete Oracle Blockchain Platform.

    • orderer.pem è il file di certificato dell'ordinatore del fondatore.

  3. Entra nel canale con questo comando:

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

  4. Installare il codice concatenato con questo comando:

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

    Dove CC_SRC_PATH è la cartella che contiene il codice concatenato.

  5. Creare un'istanza del codice concatenato con questo comando:

    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. Richiamare il codice concatenato con questo comando:

    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. Eseguire una query sul codice concatenato con questo comando:

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