REST-Proxyknoten verwalten

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

Wie wird der REST-Proxy verwendet?

Der REST-Proxy ordnet eine Anwendungsidentität einem Blockchain-Mitglied zu, mit dem 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 verwenden, um mit dem Hyperledger Fabric-Netzwerk zu interagieren. Wenn Sie die nativen Hyperledger Fabric-APIs verwenden, stellen Sie eine direkte Verbindung zu den Peers und dem Auftragnehmer her. Mit dem REST-Proxy können Sie jedoch einen Fabric-Kettencode über das RESTful-Protokoll abfragen oder aufrufen.

Anmeldungen zum REST-Proxy hinzufügen

Sie können Hyperledger Fabric-Anmeldungen zum REST-Proxy hinzufügen. Mit Anmeldungen können Benutzer den REST-Proxy ohne Registrierungszertifikat aufrufen.

Wenn Sie einer Anmeldung einen Benutzer hinzufügen möchten, müssen diese bereits in IDCS vorhanden und der Rolle REST_USER zugewiesen sein.

Verwenden Sie die Blockchain Platform-Konsole, um neue Anmeldungen hinzuzufügen und IDCS-Benutzer mit diesen Anmeldungen zu verknüpfen. Die Anmeldungen werden vollständig in Blockchain Platform und nicht in IDCS verwaltet.

Informationen dazu, wie Benutzer auf die REST-Ressourcen zugreifen, finden Sie unter REST-API für Oracle Blockchain Platform.

1. Navigieren Sie zur Konsole, und wählen Sie die Registerkarte Knoten aus.
2. Suchen Sie auf der Registerkarte Knoten den REST-Proxyknoten, dem Sie eine Registrierung hinzufügen möchten, und klicken Sie auf das Menü Aktion für diesen Knoten.
3. Klicken Sie auf Anmeldungen anzeigen oder verwalten, um eine Liste der aktuellen Anmeldungen des Knotens anzuzeigen.
   Eine Liste der aktuellen Anmeldungen wird angezeigt. Auf dieser Seite können Sie vorhandene Anmeldungen löschen und neue hinzufügen.
4. Blenden Sie Neue Anmeldung erstellen ein.
5. Geben Sie im Feld Anmeldungs-ID den Namen der hinzuzufügenden Anmeldung ein.
   Die Anmeldungs-ID darf nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) enthalten.
6. Geben Sie optional im Feld Benutzer-ID die ID eines Benutzers mit der Rolle REST_USER ein, die der Anmeldung zugeordnet werden soll. Klicken Sie auf Registrieren.
   Nachdem Sie auf Registrieren geklickt haben:

   • Die Anmeldung wird erstellt und in der Tabelle "Anmeldungen" angezeigt.
   • Die neue Registrierung wird auf jeden REST-Proxyknoten im Netzwerk kopiert.
   • Wenn Sie eine Benutzer-ID angegeben haben, ist diese ID der Anmeldung zugeordnet und kann nicht aus der Liste der zugeordneten REST-Benutzer entfernt werden. Wenn die Benutzer-ID kein gültiger REST-Benutzer ist, wird ein Fehler zurückgegeben.
   • Wenn Sie eine Benutzer-ID angegeben haben, enthält das generierte Anmeldungszertifikat die ID als Attribut username.
   • Benutzer-IDs, die einen Doppelpunkt (:) enthalten, werden für REST-API-Aufrufe mit Basisauthentifizierung nicht unterstützt. Sie können die Basisauthentifizierung zu Test- und internen Entwicklungszwecken verwenden. Verwenden Sie keine Basisauthentifizierung in Produktionsumgebungen.
7. Im Bereich Zugeordnete REST-Clientbenutzer können Sie alle Benutzer anzeigen und verwalten, die einer aktuellen Registrierung zugeordnet sind, einschließlich des Löschens eines Benutzers aus einer Registrierung.
8. Fügen Sie der Anmeldung einen weiteren Benutzer hinzu, indem Sie die Option Neue Benutzer zuordnen erweitern. Geben Sie die E-Mail-Adresse oder ID eines Benutzers ein, dem bereits die Rolle REST_USER zugewiesen ist. Klicken Sie auf Verknüpfen.

Nachdem Sie eine Registrierung erstellt und einen Benutzer damit verknüpft haben, wird der in den Blockdetails aufgeführte Initiator als neue Registrierung und nicht als ursprünglicher Standardbenutzer aufgeführt, wenn Sie Transaktionen in der Blockchain mit REST ausführen.

Konfiguration des REST-Proxyknotens 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. Navigieren 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 können Sie nach Konfiguration bearbeiten suchen und darauf klicken. Wenn Sie ein Benutzer sind, suchen Sie ihn, und klicken Sie auf Anzeigen.
   Das Dialogfeld Konfigurieren wird angezeigt.
4. Wenn Sie Administrator sind, ändern Sie die Attribute Vorschlagswartezeit (ms), Transaktionswartezeit (ms), Logebene und Transaktionsereignislogging des Knotens 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.

Zustandsinformationen für einen REST-Proxyknoten anzeigen

Sie können die Metriken eines REST-Proxyknotens prüfen, um die Performance des Knotens im Blockchain-Netzwerk anzuzeigen. Mit diesen Informationen können Sie Performanceprobleme erkennen und diagnostizieren.

Im Bereich Zustand werden die folgenden Performancemetriken angezeigt: CPU-Auslastung und Speicherauslastung.

1. Navigieren Sie zur Konsole, und wählen Sie die Registerkarte Knoten aus.
2. Klicken Sie auf der Registerkarte Knoten auf den REST-Proxyknoten, für den Sie Zustandsinformationen anzeigen möchten.
   Die Seite Knoteninformationen wird angezeigt.
3. Klicken Sie auf den Bereich Zustand, um die Performancemetriken des Knotens anzuzeigen.
   Wenn die Auslastungsprozentsätze konstant hoch sind, wenden Sie sich an Oracle Support.