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 Version v1 des Apigee API-Hub.

Hinweis

  • 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 „Rollen/Connectors-Administrator“ (`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 Dienstkonto-Authentifizierung anstelle der OAuth 2.0-Authentifizierung verwenden, prüfen Sie , ob dem Dienstkonto die entsprechenden Berechtigungen gewährt wurden. 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 Abschnitt Standort einen Standort aus der Liste Region aus und klicken Sie dann auf Weiter.

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

  4. Gehen Sie im Abschnitt Verbindungsdetails so vor:
    1. Wählen Sie in der Liste Connector die Option Apigee API-Hub aus.
    2. Wählen Sie in der Liste Connector-Version eine 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 Zahl 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. Standardmäßig ist die Logebene auf Error gesetzt.
    6. Dienstkonto: Wählen Sie ein Dienstkonto aus, 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. Wenn Sie weitere Ziele eingeben möchten, klicken Sie optional 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 die 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 sich mit einem webbasierten Nutzeranmeldefluss zu authentifizieren. Geben Sie die folgenden Details 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. Eine Liste aller unterstützten OAuth 2.0-Bereiche für den gewünschten 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 die Verbindung nach dem Erstellen autorisieren.

  • Dienstkonto-Authentifizierung: Wählen Sie diese Option aus, um sich mit dem Dienstkonto zu authentifizieren, das Sie in den vorherigen Schritten beim Konfigurieren dieser Verbindung angegeben haben. Prüfen Sie, ob 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 nach dem Erstellen der Verbindung die folgenden Aufgaben aus.

  1. Suchen Sie auf der Seite „Verbindungen“ die neu erstellte Verbindung.

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

  2. Klicken Sie auf Autorisierung erforderlich.

    Daraufhin wird der Bereich Autorisierung bearbeiten angezeigt.

  3. Kopieren Sie den Wert Weiterleitungs-URI in Ihre externe Anwendung.
  4. Prü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 noch einmal:

  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 gelangen nun zur Seite mit den Verbindungsdetails.
  5. Klicken Sie im Abschnitt Authentifizierung auf Autorisierung bearbeiten. Daraufhin 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, pro Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten. Standardmäßig weist Integration Connectors einer Verbindung 2 Knoten zu (für eine bessere Verfügbarkeit).

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

Der Apigee API-Hub-Connector hat 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