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

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

Wenn Sie einen Benutzer zu einer Registrierung hinzufügen möchten, muss er bereits in IDCS vorhanden und der Rolle REST_USER zugewiesen sein.

Mit der Blockchain Platform-Konsole können Sie neue Anmeldungen hinzufügen und IDCS-Benutzer mit diesen Anmeldungen verknüpfen. Die Anmeldungen werden vollständig in Blockchain Platform und nicht in IDCS verwaltet.

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 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. Sie können vorhandene Anmeldungen löschen und neue Anmeldungen von dieser Seite hinzufügen.
4. Erweitern Sie Neue Anmeldung erstellen.
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, der der Anmeldung zugeordnet werden soll. Klicken Sie auf Registrieren.
   Nachdem Sie auf Enroll geklickt haben:

   • Die Anmeldung wird erstellt und in der Tabelle "Anmeldungen" angezeigt.
   • Die neue Anmeldung wird in 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 zugehörigen 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 Registrierungszertifikat die ID als Attribut username.
   • Benutzer-IDs, die einen Doppelpunkt (:) enthalten, werden für REST-API-Aufrufe, die Basisauthentifizierung verwenden, nicht unterstützt.
7. Im Bereich Zugeordnete REST-Clientbenutzer können Sie alle Benutzer anzeigen und verwalten, die einer aktuellen Anmeldung zugeordnet sind. Dazu gehört auch das Löschen eines Benutzers aus einer Anmeldung.
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 bei der Ausführung von Transaktionen in der Blockchain mit REST der in den Blockdetails aufgeführte Initiator als neue Registrierung und nicht als ursprünglicher Standardbenutzer aufgeführt.

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.

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 zu ermitteln. Mit diesen Informationen können Sie Performanceprobleme erkennen und diagnostizieren.

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

1. Gehen 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.