Gestisci nodi proxy REST

Questo argomento contiene informazioni utili per comprendere come viene utilizzato il proxy REST, aggiungere iscrizioni al proxy REST e visualizzare e modificare i nodi proxy REST.

Come viene utilizzato il proxy REST?

Il proxy REST mappa un'identità dell'applicazione a un membro della blockchain che consente agli utenti e alle applicazioni di chiamare le API REST di Oracle Blockchain Platform.

Anziché utilizzare le API Hyperledger Fabric native, Oracle Blockchain Platform può utilizzare il proxy REST per interagire con la rete Hyperledger Fabric. Quando utilizzi le API native di Hyperledger Fabric, ti connetti direttamente ai pari livello e all'ordinatore. Tuttavia, il proxy REST consente di eseguire query o richiamare un codice concatenato Fabric tramite il protocollo RESTful.

Aggiungi iscrizioni al proxy REST

È possibile aggiungere iscrizioni a Hyperledger Fabric al proxy REST. Le iscrizioni consentono agli utenti di chiamare il proxy REST senza un certificato di iscrizione.

Se si desidera aggiungere un utente a un'iscrizione, deve esistere già in IDCS ed essere assegnato al ruolo REST_USER.

Utilizzare la console Blockchain Platform per aggiungere nuove iscrizioni e associare gli utenti IDCS a queste iscrizioni. Le iscrizioni vengono gestite interamente all'interno della Blockchain Platform e non all'interno di IDCS.

Per informazioni su come gli utenti accedono alle risorse REST, vedere API REST per Oracle Blockchain Platform.

1. Andare alla console e selezionare la scheda Nodi.
2. Nella scheda Nodi, individuare il nodo proxy REST al quale si desidera aggiungere un'iscrizione e fare clic sul menu Azione per questo nodo.
3. Fare clic su Visualizza o gestisci iscrizioni per visualizzare una lista delle iscrizioni correnti del nodo.
   Viene visualizzato un elenco delle iscrizioni correnti. È possibile eliminare le iscrizioni esistenti e aggiungerne di nuove da questa pagina.
4. Espandere Crea nuova iscrizione.
5. Nel campo ID iscrizione, immettere il nome dell'iscrizione da aggiungere.
   L'ID iscrizione può includere solo caratteri alfanumerici, trattini (-) e caratteri di sottolineatura (_).
6. Se lo si desidera, nel campo ID utente immettere l'ID di un utente con il ruolo REST_USER da associare all'iscrizione. Fare clic su Registra.
   Dopo aver fatto clic su Iscriviti:

   • L'iscrizione viene creata e visualizzata nella tabella Iscrizioni.
   • La nuova iscrizione viene copiata in ogni nodo proxy REST nella rete.
   • Se è stato specificato un ID utente, tale ID è associato all'iscrizione e non può essere rimosso dall'elenco di utenti REST associati. Se l'ID utente non è un utente REST valido, viene restituito un errore.
   • Se è stato specificato un ID utente, il certificato di iscrizione generato include l'ID come attributo username.
   • Gli ID utente contenenti i due punti (:) non sono supportati per le chiamate API REST che utilizzano l'autenticazione di base.
7. Nel riquadro Utenti client REST associati è possibile visualizzare e gestire tutti gli utenti associati a un'iscrizione corrente, inclusa l'eliminazione di un utente da un'iscrizione.
8. Aggiungere un altro utente all'iscrizione espandendo Associa nuovi utenti. Immettere l'indirizzo e-mail o l'ID di un utente già assegnato al ruolo REST_USER. Fare clic su Associazione.

Dopo aver creato un'iscrizione e associato un utente ad essa, quando si utilizza REST per eseguire transazioni sulla blockchain, il responsabile avvio elencato nei dettagli del blocco verrà elencato come nuova iscrizione anziché come utente predefinito originale.

Visualizza e modifica la configurazione del nodo proxy REST

La configurazione di un nodo proxy REST determina le prestazioni e il funzionamento del nodo nella rete.

Solo gli amministratori possono modificare la configurazione di un nodo. Se si dispone delle autorizzazioni utente, è possibile visualizzare le impostazioni di configurazione di un nodo. Vedere Attributi dei nodi proxy REST.

1. Andare alla console e selezionare la scheda Nodi.
2. Nella scheda Nodi, andare alla tabella Nodi, individuare il nodo proxy REST per il quale si desidera ottenere le informazioni di configurazione e fare clic sul pulsante Altre azioni del nodo.
3. L'opzione di configurazione è determinata dalle autorizzazioni dell'utente. Gli amministratori possono individuare e fare clic su Modifica configurazione. Se si è utenti, individuare e fare clic su Visualizza.
   Viene visualizzata la finestra di dialogo Configura.
4. Se si è amministratori, modificare gli attributi Tempo di attesa proposta (ms), Tempo di attesa transazione (ms), Livello di log e Log eventi transazione in base alle esigenze.
5. Fare clic su Sottometti per salvare le modifiche alla configurazione oppure fare clic su X per chiudere la finestra di dialogo Configura.

Visualizza informazioni sullo stato per un nodo proxy REST

Puoi controllare le metriche di un nodo proxy REST per vedere le prestazioni del nodo sulla rete blockchain. Queste informazioni consentono di individuare e diagnosticare i problemi di prestazioni.

Nel riquadro Stato vengono visualizzate le seguenti metriche delle prestazioni: utilizzo della CPU e utilizzo della memoria.

1. Andare alla console e selezionare la scheda Nodi.
2. Nella scheda Nodi fare clic sul nodo proxy REST per il quale si desidera visualizzare le informazioni sullo stato.
   Viene visualizzata la pagina Informazioni sul nodo.
3. Fare clic sul riquadro Stato per visualizzare le metriche delle prestazioni del nodo.
   Se le percentuali di utilizzo sono costantemente elevate, contattare il Supporto Oracle.