Apigee API-Hub

Mit dem Apigee API-Hub-Connector können Sie APIs im Portfolio Ihrer Organisation verwalten, finden und steuern.

Unterstützte Versionen

Dieser Connector unterstützt die Apigee API Hub-Version v1.

Hinweise

  • Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

    • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkverbindung.
    • Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
    • Aktivieren Sie die folgenden Dienste:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren. Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

  • Wenn Sie die Dienstkontoauthentifizierung anstelle der OAuth 2.0-Authentifizierung verwenden, müssen Sie dem Dienstkonto die entsprechenden Berechtigungen erteilen. Weitere Informationen finden Sie unter Vordefinierte IAM-Rollen.

Apigee API Hub-Verbindung erstellen

Eine Verbindung ist für eine Datenquelle spezifisch. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

  1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Seite „Verbindungen“

  2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
  3. Wählen Sie im Bereich Standort einen Standort aus der Liste Region aus und klicken Sie auf Weiter.

    Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

  4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
    1. Wählen Sie Apigee API-Hub aus der Liste Connector aus.
    2. Wählen Sie eine Connector-Version aus der Liste Connector-Version aus.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein. Der Verbindungsname darf Kleinbuchstaben, Zahlen oder Bindestriche enthalten. Der Name muss mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden und darf nicht länger als 49 Zeichen sein.
    4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
    5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
    6. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
    7. Optional: Konfigurieren Sie die Verbindungsknoteneinstellungen.
      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.
    8. Klicken Sie auf Weiter.
  5. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
    1. Wählen Sie im Feld Zieltyp ein Ziel aus.
    2. Geben Sie im Feld Hostadresse den Hostnamen oder die IP-Adresse des Ziels an.

    3. Optional: Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + ZIEL HINZUFÜGEN.

    4. Klicken Sie auf Weiter.
  6. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
    1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

      Die folgenden Authentifizierungstypen werden von der Apigee API Hub-Verbindung unterstützt:

      • OAuth 2.0-Autorisierungscode
      • Dienstkonto-Authentifizierung

      2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

    2. Klicken Sie auf Weiter.
  7. Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails und klicken Sie dann auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

  • OAuth 2.0 – Autorisierungscode: Wählen Sie diese Option aus, um die Authentifizierung über einen webbasierten Nutzeranmeldevorgang durchzuführen. Geben Sie die folgenden Informationen an:
    • Client-ID : Die Client-ID, die für die Verbindung zu Ihrem Apigee API Hub-Backend-Dienst erforderlich ist.
    • Bereiche : Eine durch Kommas getrennte Liste der gewünschten Bereiche. Alle unterstützten OAuth 2.0-Bereiche für den erforderlichen Google-Dienst finden Sie im entsprechenden Abschnitt auf der Seite OAuth 2.0-Bereiche für Google APIs.
    • Client-Secret: Wählen Sie das Secret Manager-Secret aus. Sie müssen das Secret Manager-Secret erstellt haben, bevor Sie diese Autorisierung konfigurieren.
    • Secret-Version: Secret Manager-Secret-Version für den Clientschlüssel.

    Für den Authentifizierungstyp Authorization code müssen Sie nach dem Erstellen der Verbindung die Verbindung autorisieren.

  • Dienstkonto-Authentifizierung: Wählen Sie diese Option aus, um sich mit dem Dienstkonto zu authentifizieren, das Sie in den vorherigen Schritten bei der Konfiguration dieser Verbindung angegeben haben. Achten Sie darauf, dass Sie dem Dienstkonto die relevanten IAM-Rollen und -Berechtigungen für die Authentifizierung zugewiesen haben.
    • Bereiche : Wählen Sie die erforderlichen OAuth 2.0-Bereiche aus dem Drop-down-Menü aus. Weitere Informationen finden Sie unter Zugriffsbereiche.

Verbindung autorisieren

Wenn Sie OAuth 2.0 – Autorisierungscode verwenden, um die Verbindung zu authentifizieren, führen Sie die folgenden Aufgaben aus, nachdem Sie die Verbindung erstellt haben.

  1. Suchen Sie auf der Seite Verbindungen nach der neu erstellten Verbindung.

    Der Status für den neuen Connector ist Autorisierung erforderlich.

  2. Klicken Sie auf Autorisierung erforderlich.

    Der Bereich Autorisierung bearbeiten wird angezeigt.

  3. Kopieren Sie den Wert unter Weiterleitungs-URI in Ihre externe Anwendung.
  4. Überprüfen Sie die Autorisierungsdetails.
  5. Klicken Sie auf Autorisieren.

    Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Erneute Autorisierung für Autorisierungscode

Wenn Sie den Authentifizierungstyp Authorization code verwenden und Änderungen an der Konfiguration im Apigee API Hub vorgenommen haben, müssen Sie Ihre Apigee API Hub-Verbindung noch einmal autorisieren. So autorisieren Sie eine Verbindung neu:

  1. Klicken Sie auf der Seite Verbindungen auf die gewünschte Verbindung.

    Dadurch wird die Seite mit den Verbindungsdetails geöffnet.

  2. Klicken Sie auf Bearbeiten, um die Verbindungsdetails zu bearbeiten.
  3. Prüfen Sie im Abschnitt Authentifizierung die Details zu OAuth 2.0-Autorisierungscode.

    Nehmen Sie bei Bedarf die erforderlichen Änderungen vor.

  4. Klicken Sie auf Speichern. Sie werden zur Seite mit den Verbindungsdetails weitergeleitet.
  5. Klicken Sie im Abschnitt Authentifizierung auf Autorisierung bearbeiten. Dadurch wird der Bereich Autorisieren angezeigt.
  6. Klicken Sie auf Autorisieren.

    Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Systembeschränkungen

Der Apigee API Hub-Connector kann maximal 20 Transaktionen pro Sekunde und Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Apigee API Hub-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Connectors-Aufgabe verwenden.

Aktionen

Dieser Connector bietet eine Abstraktionsebene für die Objekte des verbundenen Backend-Dienstes. Sie können nur über diese Abstraktion auf die Objekte des Backends zugreifen. Die Abstraktion wird Ihnen in Form von Aktionen zur Verfügung gestellt. Eine Action ist eine Funktion erster Klasse, die über die Connector-Schnittstelle für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen. Aktionen sind je nach Connector unterschiedlich. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Bekannte Probleme

Für den Apigee API-Hub-Connector gelten Konfigurationslimits. Durchsuchbare Ressourcen sind auf 2, 5 MB und API-Spezifikationsdateien auf 10 MB begrenzt. Weitere Informationen finden Sie unter Limits für den Apigee API-Hub.

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte