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

Le iscrizioni consentono agli utenti di chiamare il proxy REST senza un certificato di iscrizione. Le iscrizioni richiedono la definizione di un nuovo gruppo di utenti nel server di autenticazione.

Aggiunta di iscrizioni quando si utilizza Microsoft Active Directory come server di autenticazione

L'aggiunta di un'iscrizione al proxy REST richiede l'aggiunta di un nuovo gruppo di utenti a Active Directory: <Rest Proxy Client Users group name>_<custom enrolment name>. È quindi possibile utilizzare la console Blockchain Platform per mappare la registrazione a questo gruppo.

1. Creare un nuovo gruppo di Active Directory denominato <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Aggiungere tutti gli utenti che devono utilizzare l'iscrizione personalizzata a questo gruppo.
3. Andare alla console della piattaforma Blockchain e selezionare la scheda Nodi.
4. Nella scheda Nodi, individuare il nodo proxy REST a cui si desidera aggiungere un'iscrizione e aprire il menu Altre azioni.
5. Fare clic su Visualizza o crea iscrizioni per visualizzare la lista delle iscrizioni correnti del nodo.
6. Fare clic su Crea nuova iscrizione.
7. Nel campo Nome utente, immettere <custom enrolment name> dal primo passo. Tenere presente che la distinzione tra maiuscole e minuscole deve corrispondere al gruppo di utenti creato. Fare clic su Registra.
   • L'iscrizione viene creata e visualizzata nella tabella Iscrizioni.
   • La nuova iscrizione viene copiata in ogni nodo proxy REST della rete.

Aggiunta di iscrizioni quando si utilizza OpenLDAP o Oracle Internet Directory come server di autenticazione

L'aggiunta di una registrazione al proxy REST crea un nuovo ruolo utente nel gruppo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sul server LDAP.

Dopo aver creato la registrazione nella console, l'amministratore utilizza il server LDAP per assegnare gli utenti richiesti a questo ruolo.

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 a cui si desidera aggiungere un'iscrizione e aprire il menu Altre azioni.
3. Fare clic su Visualizza o crea iscrizioni per visualizzare la lista delle iscrizioni correnti del nodo.
4. Fare clic su Crea nuova iscrizione.
   Viene visualizzata la finestra di dialogo Crea nuova iscrizione.
5. Immettere un nome per l'iscrizione nel campo Nome utente. 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 della rete.
   • Un nuovo ruolo utente nel gruppo OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> sul server LDAP.

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 Configure.
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.