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 Fabric-Chaincode über das Protokoll RESTful abfragen oder aufrufen.

Anmeldungen zum REST-Proxy hinzufügen

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

Anmeldungen hinzufügen, wenn Microsoft Active Directory als Authentifizierungsserver verwendet wird

Wenn Sie eine Anmeldung zum REST-Proxy hinzufügen, muss eine neue Benutzergruppe zu Active Directory hinzugefügt werden: <Rest Proxy Client Users group name>_<custom enrolment name>. Anschließend können Sie die Registrierung über die Blockchain Platform-Konsole dieser Gruppe zuordnen.

  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 diese 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 für Anmeldungen angezeigt.
    • Die neue Registrierung wird in jeden REST-Proxyknoten im Netzwerk kopiert.

Registrierungen hinzufügen, wenn OpenLDAP oder Oracle Internet Directory als Authentifizierungsserver verwendet werden

Wenn Sie dem REST-Proxy eine Registrierung 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 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 ö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 Registrieren geklickt haben:
    • Die Anmeldung wird erstellt und in der Tabelle für Anmeldungen angezeigt.
    • Die neue Registrierung wird in jeden REST-Proxyknoten im Netzwerk kopiert.
    • Eine neue Benutzerrolle in der Gruppe OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> auf Ihrem 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 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.