REST-Proxyknoten verwalten

Dieses Thema enthält Informationen, mit denen Sie verstehen, wie der REST-Proxy verwendet wird, Anmeldungen zum REST-Proxy hinzufügen und die REST-Proxyknoten anzeigen und bearbeiten können.

Wie wird der REST-Proxy verwendet?

Der REST-Proxy ordnet einem Blockchain-Mitglied eine Anwendungsidentität 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 Peers und Orderer her. Mit dem REST-Proxy können Sie jedoch einen Hyperledger Fabric-Chaincode über das Protokoll RESTful abfragen oder aufrufen.

Anmeldungen zum REST-Proxy hinzufügen

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

Wenn Sie einen Benutzer zu einer Anmeldung hinzufügen möchten, muss dieser 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 innerhalb der Blockchain-Plattform und nicht innerhalb von IDCS verwaltet.

Informationen dazu, wie Benutzer auf die REST-Ressourcen zugreifen, 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. Auf dieser Seite können Sie vorhandene Anmeldungen löschen und neue Anmeldungen hinzufügen.
  4. Blenden Sie Neue Anmeldung erstellen ein.
  5. Geben Sie im Feld Anmelde-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 mit der Anmeldung verknüpft werden soll. Klicken Sie auf Registrieren.
    Nachdem Sie auf Registrieren geklickt haben:
    • Die Anmeldung wird erstellt und in der Tabelle für Anmeldungen angezeigt.
    • Die neue Anmeldung wird in jeden REST-Proxyknoten im Netzwerk kopiert.
    • Wenn Sie eine Benutzer-ID angegeben haben, wird 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 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 mit einer aktuellen Anmeldung verknüpft sind, einschließlich des Löschens eines Benutzers aus einer Anmeldung.
  8. Fügen Sie der Anmeldung einen anderen 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 wurde. Klicken Sie auf Verknüpfen.
Nachdem Sie eine Anmeldung erstellt und einem Benutzer zugeordnet haben, wird der in den Blockdetails aufgeführte Initiator bei der Ausführung von Transaktionen mit REST als neue Anmeldung anstelle des ursprünglichen Standardbenutzers aufgeführt, wenn Sie Transaktionen in der Blockchain ausführen.

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 durch Ihre Berechtigungen bestimmt. Wenn Sie ein Administrator sind, suchen und klicken Sie auf Konfiguration bearbeiten. Wenn Sie ein Benutzer sind, suchen und klicken Sie auf Anzeigen.
    Das Dialogfeld Konfigurieren wird angezeigt.
  4. Wenn Sie Administrator sind, ändern Sie die Attribute Proposal Wait Time (ms), Transaction Wait Time (ms), Log Level und Transaction Event Logging 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.