Gestisci canali
Questo argomento contiene informazioni sulla gestione dei canali nella rete, ad esempio come creare e visualizzare i canali, come unirsi ai colleghi e designare e ancorare i pari livello, come utilizzare i criteri e le liste di controllo dell'accesso e come associare gli ordini a un canale.
Informazioni sui canali
Canali di partizione e isolare i peer e i dati dei libri contabili per fornire transazioni private e riservate sulla rete blockchain.
- Peer
- Un libro contabile condiviso
- Codici concatenati distribuiti sul canale
- Uno o più nodi del servizio di ordinazione
- Definizioni dei criteri di canale e ACL in cui vengono applicate le definizioni
Ogni peer che si unisce a un canale ha la sua identità che lo autentica ai peer e ai servizi del canale. Sebbene i pari livello possano appartenere a più canali, le informazioni sulle transazioni, lo stato del libro contabile e l'appartenenza al canale sono limitate ai pari livello all'interno di ciascun canale.
Puoi utilizzare la console di Oracle Blockchain Platform o l'SDK Hyperledger Fabric per creare canali sulla tua rete blockchain. Vedere Visualizza canali.
Visualizza canali
I membri della tua rete utilizzano i canali per comunicare privatamente le informazioni sulle transazioni blockchain.
Crea un canale
È possibile aggiungere canali alla rete e specificare quali membri possono utilizzare il canale e quali peer possono aderire al canale. Impossibile eliminare i canali.
Per completare questo task è necessario essere un amministratore.
-
Distribuire un codice concatenato sul canale. Vedere Distribuisci un codice concatenato.
-
Se la rete contiene partecipanti, tali partecipanti utilizzano le proprie console per unire i pari livello membri al canale. Vedere Unisciti a un peer a un canale.
Visualizza attività libro contabile di un canale
Utilizzare il libro contabile per trovare informazioni sintetiche e statistiche di runtime per le transazioni su un canale specifico.
Visualizzare o aggiornare l'elenco delle organizzazioni di un canale
È possibile visualizzare l'elenco delle organizzazioni che hanno accesso al canale. Se il canale è stato creato, è possibile modificare le autorizzazioni di un'organizzazione sul canale e aggiungere o rimuovere le organizzazioni dal canale.
Unisciti a un peer a un canale
È possibile aggiungere un nodo peer a un canale in modo che il nodo possa utilizzarlo per scambiare informazioni sulle transazioni private con altri nodi peer sul canale.
-
Quando crei un canale, specifichi quali nodi peer locali possono unirsi al canale.
-
Se si sta creando una rete contenente un partecipante, è possibile selezionare il partecipante come membro nel canale. Oppure è possibile aggiungere il partecipante dopo la creazione del canale.
-
L'istanza dispone di più domini di disponibilità o domini di errore e Oracle consiglia di unire un peer da ogni partizione al canale. Questo perché se un nodo lavoratore non è disponibile, il canale è ancora disponibile per le dichiarazioni a sostegno e i commit. Per determinare il dominio in cui si trova un peer, nel menu Altre azioni selezionare Mostra informazioni AD per visualizzare le informazioni sul dominio di disponibilità.
- Puoi iscriverti a un massimo di sette peer di ogni dominio.
Vedere Crea un canale.
Per eseguire questo task è necessario essere un amministratore.
Aggiungi un peer di ancoraggio
Ogni membro che utilizza un canale deve designare almeno un anchor peer. I peer di ancoraggio sono punti di contatto di rete principali e vengono utilizzati per scoprire e comunicare con altri peer di rete sul canale.
È possibile designare uno o più peer nell'organizzazione come anchor peer in un canale. Per una rete High Availability, è possibile specificare due o più peer di ancoraggio. Tutti i membri che utilizzano il canale di rete devono utilizzare la propria console per designare uno o più nodi peer come pari livello.
Per eseguire questo task è necessario essere un amministratore.
Modificare o rimuovere un peer di ancoraggio
È possibile modificare o rimuovere i peer di ancoraggio di un canale. I peer di ancoraggio sono punti di contatto di rete principali e vengono utilizzati per scoprire e comunicare con altri peer di rete sul canale.
Prima di modificare o rimuovere gli anchor peer del canale, tenere presenti le seguenti informazioni:
- Per comunicare sul canale, è necessario designare uno o più peer dell'organizzazione come anchor peer.
- Per una rete High Availability, è possibile specificare due o più peer di ancoraggio.
- Tutti i membri che utilizzano il canale di rete devono utilizzare la propria console per designare uno o più nodi peer come pari livello.
Per eseguire questo task è necessario essere un amministratore.
Visualizza informazioni sui codici concatenati distribuiti
È possibile visualizzare le informazioni sui codici concatenati distribuiti sui diversi canali della rete.
- Andare alla console e selezionare la scheda Canali.
- Nella tabella Canali fare clic sul nome del canale con il codice concatenato per il quale si desidera visualizzare le informazioni.
- Nella pagina Informazioni canale, confermare che il riquadro Codici concatenati distribuiti è selezionato
- Nella tabella codici concatenati è possibile effettuare le operazioni riportate di seguito.
- Fare clic sull'ID package del codice concatenato per accedere alla scheda Codici concatenati per ulteriori informazioni. Ad esempio, i peer su cui è installato il codice concatenato e i canali su cui è distribuito il codice concatenato.
- Nel menu Altre azioni di un codice concatenato, fare clic su Visualizza definizione codice concatenato per trovare i dettagli sulla definizione del codice concatenato, incluso il criterio di riconoscimento.
- (Facoltativo) Se viene visualizzato un elenco di canali senza un codice concatenato, è possibile passare alla scheda Codici concatenati e distribuire un codice concatenato al canale. Vedere Distribuisci un codice concatenato.
Gestione criteri e ACL canale
Questo argomento contiene informazioni sui criteri e sulle liste di controllo dell'accesso di un canale. Fornisce una panoramica sui criteri, sui tipi di criteri e su come modificarli, nonché su come utilizzare le ACL per gestire le organizzazioni e i ruoli che possono accedere alle risorse di un canale.
Descrizione dei criteri canale
Un criterio definisce un set di condizioni. Le parti richieste devono soddisfare le condizioni della politica prima che le loro firme siano considerate valide e la richiesta corrispondente avvenga sulla rete.
La rete blockchain è gestita da queste politiche. I criteri controllano l'identità associata a una richiesta rispetto al criterio associato alla risorsa necessaria per evadere la richiesta. I criteri si trovano nella configurazione del canale.
Dopo aver configurato i criteri del canale, assegnarli alle risorse ACL del canale per determinare quali membri devono firmare prima che una modifica o un'azione possa verificarsi sul canale. Si supponga, ad esempio, di aver modificato il criterio Scrittori per includere i membri dell'organizzazione A o dell'organizzazione B. Quindi è stato assegnato il criterio Writers alla risorsa ACL cscc/GetConfigBlock del canale. Ora solo un membro dell'Organizzazione A o dell'Organizzazione B può chiamare GetConfigBlock sul componente cscc.
Quali sono i tipi di criteri?
Esistono due tipi di criteri: Firma e ImplicitMeta.
- Firma: specifica una combinazione di regole di valutazione. Supporta combinazioni di AND, OR e NOutOf. Ad esempio, è possibile definire qualcosa come "Un amministratore dell'organizzazione A e altri 2 amministratori" o "11 di 20 amministratori dell'organizzazione".
Qualsiasi nuovo criterio creato sarà Criteri firma.
- ImplicitMeta: questo tipo di criterio è valido solo nel contesto della configurazione. Aggrega il risultato della valutazione dei criteri più in profondità nella gerarchia di configurazione, definiti dai criteri di firma. Supporta regole predefinite, ad esempio "La maggior parte dei criteri di amministrazione dell'organizzazione".
Quando vengono creati i criteri?
Quando si aggiunge un canale alla rete, Oracle Blockchain Platform crea criteri predefiniti. I criteri predefiniti sono: Amministratori, Scrittori, Lettori, Approvazione, LifecycleEndorsement (criteri ImplicitMeta) e Creatore (criteri di firma). È possibile modificare questi criteri in base alle esigenze o creare criteri.
Si noti il seguente importante problema relativo ai criteri di canale:
-
È possibile utilizzare la console per creare un canale e impostare l'ACL dell'organizzazione su ReaderOnly. Dopo aver salvato il nuovo canale, non è possibile aggiornare questa impostazione ACL dall'opzione Modifica organizzazione del canale.
Tuttavia, è possibile utilizzare la funzionalità Gestisci criteri canale della console per aggiungere l'organizzazione al criterio Writers, che sovrascrive l'impostazione ACL ReaderOnly del canale.
Aggiunta o modifica dei criteri di un canale
È possibile aggiungere o modificare il criterio di un canale per specificare i membri necessari per eseguire un'azione specifica sul canale. Dopo aver definito i criteri, assegnarli alle ACL del canale.
Prima di aggiungere o aggiornare i criteri, è necessario comprendere in che modo Oracle Blockchain Platform crea i criteri di canale predefiniti. Vedere Che cosa sono i criteri di canale?.
Per eseguire questo task è necessario essere un amministratore.
- Andare alla console e selezionare la scheda Canali.
Viene visualizzata la scheda Canali e la tabella dei canali contiene un elenco di tutti i canali della rete.
- Nella tabella Canali, fare clic sul nome del canale a cui si desidera aggiungere criteri o modificarne i criteri.
Viene visualizzata la pagina Informazioni canale.
- Nella pagina Informazioni canale, fare clic sul riquadro Criteri canale.
- Procedere in uno dei seguenti modi:
- Per aggiungere un nuovo criterio, fare clic sul pulsante Crea un nuovo criterio. Viene visualizzata la finestra di dialogo Crea criterio. Immettere un nome nel campo Nome del criterio e selezionare Firma nel campo Tipo di criterio. Espandere la sezione Criteri di firma.
- Per modificare un criterio esistente, fare clic sul nome di un criterio. Viene visualizzata la finestra di dialogo Criteri di aggiornamento.
- Fare clic sul pulsante Aggiungi identità per aggiungere un'organizzazione. In alternativa, modificare un criterio di firma esistente in base alle esigenze. Tenere presenti le informazioni riportate di seguito.
Campo Descrizione ID MSP Dal menu a discesa, selezionare l'organizzazione che deve firmare il criterio. Ruolo Selezionare il ruolo peer corrispondente richiesto dal criterio. Di solito questo sarà membro. È possibile trovare un ruolo del peer visualizzandone le informazioni di configurazione. Modalità espressione criterio Nella maggior parte dei casi, verrà utilizzato Basic. Selezionare Avanzate per scrivere una stringa di espressione utilizzando AND, OR e NOutOf. Per informazioni su come scrivere una stringa di espressione dei criteri valida, vedere Criteri di approvazione nella documentazione di Hyperledger Fabric. Autore firma Selezionare il numero di membri che devono firmare il criterio per soddisfare la richiesta. - Se si sta aggiungendo un nuovo criterio, fare clic su Crea. Se si sta modificando un criterio, fare clic su Aggiorna.
Elimina i criteri di un canale
È possibile eliminare i criteri canale creati.
Impossibile eliminare i criteri predefiniti: Amministratori, Creatore, Lettori, Scrittori, Approvazione e LifecycleEndorsement. Inoltre, non è possibile eliminare un criterio canale se è assegnato a una lista ACL. Prima di provare a eliminare un criterio canale, confermare che il criterio non è assegnato.
Per eseguire questo task è necessario essere un amministratore.
- Andare alla console e selezionare la scheda Canali.
Viene visualizzata la scheda Canali e la tabella dei canali contiene un elenco di tutti i canali della rete.
- Nella tabella Canali, fare clic sul canale da cui si desidera eliminare un criterio.
Viene visualizzata la pagina Informazioni canale.
- Nella pagina Informazioni canale, fare clic sul riquadro Criteri canale.
- Individuare il criterio che si desidera eliminare e fare clic sul relativo pulsante Altre opzioni.
- Fare clic su Rimuovi e confermare l'eliminazione.
Che cosa sono le ACL del canale?
Le liste di controllo dell'accesso (ACL, Access Control List) utilizzano i criteri per gestire quali organizzazioni e ruoli possono accedere alle risorse di un canale.
Gli utenti interagiscono con la rete blockchain indirizzando componenti come il codice concatenato del sistema di query (qscc), il codice concatenato del sistema del ciclo di vita (_lifecycle), il codice concatenato del sistema di configurazione (cscc), il peer e l'evento. Questi componenti sono associati a risorse specifiche (ad esempio, GetConfigBlock o GetChaincodeData) a cui è possibile assegnare criteri a livello di canale. Questi criteri fanno parte della configurazione del canale.
Un criterio definisce quali organizzazioni e ruoli possono richiedere una risorsa. Quando viene effettuata una richiesta, il criterio indica al sistema di controllare l'identità del richiedente e determinare se è autorizzato a effettuare la richiesta. Quando si crea un canale, Oracle Blockchain Platform include le ACL predefinite di Hyperledger Fabric con il canale. Oracle Blockchain Platform crea anche criteri predefiniti (Amministratore, Creatore, Scrittori, Lettori, Appoggio e LifecycleEndorsement) per il canale. È possibile modificare questi criteri o creare i criteri in base alle esigenze. Vedere Che cosa sono i criteri di canale?.
Aggiorna ACL canale
È possibile aggiornare le ACL del canale assegnando criteri alle risorse del canale. Un criterio definisce quali organizzazioni e ruoli possono richiedere una risorsa
È necessario comprendere quali criteri e ACL sono prima di aggiornare le ACL di un canale. Per ulteriori informazioni, vedere Che cosa sono gli ACL di canale?.
- Andare alla console e fare clic sulla scheda Canali.
Viene visualizzata la pagina Canali e la tabella dei canali contiene un elenco di tutti i canali della rete.
- Nella tabella Canali, fare clic sul nome del canale per il quale si desidera aggiornare le ACL.
Viene visualizzata la pagina Informazioni canale.
- Nella pagina Informazioni sul canale fare clic sul riquadro ACL.
- Nella tabella Risorse individuare la risorsa che si desidera aggiornare. Fare clic sul pulsante Espandi della risorsa e selezionare il criterio che si desidera assegnare alla risorsa.
- Modificare i criteri dell'altra risorsa in base alle esigenze.
- Fare clic su Update ACLs.
Aggiungi o rimuovi ordinatori a o da un canale
L'organizzazione di amministrazione degli ordini può aggiungere o rimuovere gli ordini da un canale.
- Nella console del fondatore, aprire la scheda Canali e selezionare il canale per visualizzarne la vista dei dettagli.
- Aprire la scheda secondaria Ordini. Vengono elencati tutti i nodi Orderer attualmente collegati al canale.
- Fare clic su Entra nel canale. Selezionare un OSN non ancora presente in questo canale e fare clic su Partecipa.
- Nella console del fondatore, aprire la scheda Canali e selezionare il canale per visualizzarne la vista dei dettagli.
- Aprire la scheda secondaria Ordini. Vengono elencati tutti i nodi Orderer attualmente collegati al canale.
- Selezionare l'ordinatore che si desidera rimuovere dal canale e dal relativo menu Altre azioni selezionare Rimuovi.
Impostazione dell'organizzazione dell'amministratore ordini
È possibile assegnare l'amministrazione di OSN in un canale a qualsiasi organizzazione. Normalmente viene assegnato il fondatore o il creatore del canale.
- Nella console fondatore, aprire la scheda Canali.
- Selezionare il canale per il quale si desidera impostare l'organizzazione dell'amministratore dell'ordinatore e dal menu Azione selezionare Gestisci amministratore OSN.
- Effettuare una selezione dall'elenco delle organizzazioni disponibili e fare clic su Sottometti.
Modifica impostazioni servizio ordinazione per un canale
È possibile aggiornare le impostazioni del servizio di ordinazione per un canale specifico.
- È possibile aggiornare le impostazioni del servizio di ordinazione per l'intera rete, come descritto in Modifica impostazioni del servizio di ordinazione per la rete.
- Se si modificano le impostazioni del servizio di gestione ordini e sono presenti applicazioni in esecuzione sulla rete, è necessario aggiornare manualmente tali applicazioni per utilizzare le impostazioni riviste del servizio di gestione ordini.
- Non è comune, ma in alcune situazioni, potresti esporre un servizio di ordinazione diverso ad alcuni dei partecipanti alla rete. In questo caso, si esporta il blocco di configurazione di rete aggiornato e i partecipanti richiesti importeranno le impostazioni riviste. Vedere Join the Participant or Scaled-Out OSNs to the Founder's Ordering Service.