REST-Proxyknoten verwalten

Dieses Thema enthält Informationen zur Verwendung des REST-Proxys, zum Hinzufügen von Anmeldungen zum REST-Proxy sowie zum Anzeigen und Bearbeiten der REST-Proxyknoten.

Wie wird der REST-Proxy verwendet?

Der REST-Proxy ordnet eine Anwendungsidentität einem Blockchain-Mitglied zu, sodass Benutzer und Anwendungen die Oracle Blockchain Platform-REST-APIs aufrufen können.

Anstatt die nativen Hyperledger Fabric-APIs zu verwenden, kann Oracle Blockchain Platform den REST-Proxy für die Interaktion mit dem Hyperledger Fabric-Netzwerk verwenden. Wenn Sie die nativen Hyperledger Fabric-APIs verwenden, stellen Sie eine direkte Verbindung zu den Peers und Orderern her. Mit dem REST-Proxy können Sie jedoch einen Fabric-Chaincode über das RESTful-Protokoll abfragen oder aufrufen.

Anmeldungen zum REST-Proxy hinzufügen

Mit Anmeldungen können Benutzer den REST-Proxy ohne Anmeldungszertifikat aufrufen. Für Anmeldungen muss eine neue Benutzergruppe auf dem Authentifizierungsserver definiert werden.

Anmeldungen bei Verwendung von Microsoft Active Directory als Authentifizierungsserver hinzufügen

Zum Hinzufügen einer Anmeldung zum REST-Proxy muss eine neue Benutzergruppe zu Active Directory hinzugefügt werden: <Rest Proxy Client Users group name>_<custom enrolment name>. Sie können dann die Blockchain Platform-Konsole verwenden, um die Anmeldung dieser Gruppe zuzuordnen.

1. Erstellen Sie eine neue Active Directory-Gruppe mit dem Namen <Rest Proxy Client Users group name>_<custom enrolment name>.
2. Fügen Sie alle Benutzer hinzu, die die benutzerdefinierte Anmeldung für diese Gruppe verwenden müssen.
3. Gehen Sie zur Blockchain Platform-Konsole, und wählen Sie die Registerkarte Knoten aus.
4. Suchen Sie auf der Registerkarte Knoten den REST-Proxyknoten, dem Sie eine Anmeldung hinzufügen möchten, und öffnen Sie das Menü Weitere Aktionen.
5. Klicken Sie auf Anmeldungen anzeigen oder erstellen, um eine Liste der aktuellen Anmeldungen des Knotens anzuzeigen.
6. Klicken Sie auf Neue Anmeldung erstellen.
7. Geben Sie im Feld Benutzername im ersten Schritt <custom enrolment name> ein. Beachten Sie, dass die Groß-/Kleinschreibung beachtet wird und mit der von Ihnen erstellten Benutzergruppe übereinstimmen muss. Klicken Sie auf Registrieren.
   • Die Anmeldung wird erstellt und in der Tabelle "Anmeldungen" angezeigt.
   • Die neue Anmeldung wird auf jeden REST-Proxyknoten im Netzwerk kopiert.

Registrierungen hinzufügen, wenn Sie OpenLDAP oder Oracle Internet Directory als Authentifizierungsserver verwenden

Wenn Sie eine Registrierung zum REST-Proxy hinzufügen, wird eine neue Benutzerrolle in der Gruppe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> auf Ihrem LDAP-Server erstellt.

Nachdem die Registrierung in der Konsole erstellt wurde, verwendet der Administrator den LDAP-Server, um dieser Rolle die erforderlichen Benutzer zuzuweisen.

Informationen zum Zugriff von Benutzern auf die REST-Ressourcen finden Sie unter REST-API für Oracle Blockchain Platform.

1. Gehen Sie zur Konsole, und wählen Sie die Registerkarte Knoten aus.
2. Suchen Sie auf der Registerkarte Knoten den REST-Proxyknoten, dem Sie eine Anmeldung hinzufügen möchten, und öffnen Sie das Menü Weitere Aktionen.
3. Klicken Sie auf Anmeldungen anzeigen oder erstellen, um eine Liste der aktuellen Anmeldungen des Knotens anzuzeigen.
4. Klicken Sie auf Neue Anmeldung erstellen.
   Das Dialogfeld Neue Anmeldung erstellen wird angezeigt.
5. Geben Sie in das Feld Benutzername einen Namen für die Anmeldung ein. Klicken Sie auf Registrieren.
   Nachdem Sie auf Enroll geklickt haben:

   • Die Anmeldung wird erstellt und in der Tabelle "Anmeldungen" angezeigt.
   • Die neue Anmeldung wird auf jeden REST-Proxyknoten im Netzwerk kopiert.
   • Eine neue Benutzerrolle in der Gruppe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> auf dem LDAP-Server.

REST-Proxyknotenkonfiguration anzeigen und bearbeiten

Die Konfiguration eines REST-Proxyknotens bestimmt, wie der Knoten im Netzwerk ausgeführt wird und sich verhält.

Nur Administratoren können die Konfiguration eines Knotens ändern. Wenn Sie über Benutzerberechtigungen verfügen, können Sie die Konfigurationseinstellungen eines Knotens anzeigen. Siehe REST-Proxyknotenattribute.

1. Gehen Sie zur Konsole, und wählen Sie die Registerkarte Knoten aus.
2. Gehen Sie auf der Registerkarte Knoten zur Tabelle "Knoten", suchen Sie den REST-Proxyknoten, für den Sie Konfigurationsinformationen benötigen, und klicken Sie auf die Schaltfläche Weitere Aktionen des Knotens.
3. Die Konfigurationsoption wird von Ihren Berechtigungen bestimmt. Als Administrator suchen Sie nach Konfiguration bearbeiten, und klicken Sie auf diese Option. Als Benutzer suchen Sie nach Anzeigen, und klicken Sie darauf.
   Das Dialogfeld Konfigurieren wird angezeigt.
4. Wenn Sie Administrator sind, ändern Sie die Attribute Vorschlagswartezeit (ms), Transaktionswartezeit (ms), Logebene und Protokollierung von Transaktionsereignissen nach Bedarf.
5. Klicken Sie auf Weiterleiten, um die Konfigurationsänderungen zu speichern, oder klicken Sie auf X, um das Dialogfeld Konfigurieren zu schließen.