Gestisci nodi proxy REST

Questo argomento contiene informazioni utili per comprendere l'utilizzo del proxy REST, aggiungere iscrizioni al proxy REST e visualizzare e modificare i nodi proxy REST.

Come viene utilizzato il proxy REST?

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

Invece di 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 colleghi 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 una registrazione 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 Active Directory denominato <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Aggiungere gli utenti che devono utilizzare l'iscrizione personalizzata a questo gruppo.
3. Andare alla console Blockchain Platform 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 un elenco 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 questa operazione fa distinzione tra maiuscole e minuscole e deve corrispondere al gruppo di utenti creato. Fare clic su Enroll.
   • L'iscrizione viene creata e visualizzata nella tabella Iscrizioni.
   • La nuova registrazione 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 la creazione della registrazione nella console, l'amministratore utilizza il server LDAP per assegnare gli utenti necessari a questo ruolo.

Per informazioni sulle modalità di accesso degli utenti 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 un elenco delle iscrizioni correnti del nodo.
4. Fare clic su Crea nuova iscrizione.
   Viene visualizzata la finestra di dialogo Crea nuova iscrizione.
5. Nel campo Nome utente, immettere un nome per l'iscrizione. Fare clic su Enroll.
   Dopo aver fatto clic su Iscriviti:

   • L'iscrizione viene creata e visualizzata nella tabella Iscrizioni.
   • La nuova registrazione 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 il funzionamento e le prestazioni 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 nodo 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. Se si è amministratori, 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.