API-Hub über die Benutzeroberfläche bereitstellen

Diese Seite gilt für Apigee und Apigee Hybrid.

In diesem Thema wird beschrieben, wie Sie den API-Hub mithilfe der Apigee-Benutzeroberfläche in der Google Cloud Console bereitstellen. Dies ist die empfohlene Methode zur Bereitstellung des API-Hubs.

Hinweise

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  5. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  6. Prüfen Sie, ob Sie die folgenden Rollen für das Projekt haben:

    • roles/serviceusage.serviceUsageAdmin
    • roles/cloudkms.admin
    • roles/apihub.provisioningAdmin
    • roles/resourcemanager.projectIamAdmin

    Auf Rollen prüfen

    1. Öffnen Sie in der Google Cloud Console die Seite IAM.

      IAM aufrufen
    2. Wählen Sie das Projekt aus.

    3. Suchen Sie in der Spalte Hauptkonto die Zeile mit Ihrer E-Mail-Adresse.

      Ist Ihre E-Mail-Adresse nicht in dieser Spalte enthalten, haben Sie keine Rollen.

    4. Prüfen Sie in der Spalte Rolle der Zeile mit Ihrer E-Mail-Adresse, ob die Liste der Rollen die erforderlichen Rollen enthält.

    Rollen zuweisen

    1. Öffnen Sie in der Google Cloud Console die Seite IAM.

      IAM aufrufen
    2. Wählen Sie das Projekt aus.
    3. Klicken Sie auf Zugriff erlauben.
    4. Geben Sie in das Feld Neue Hauptkonten Ihre E-Mail-Adresse ein.
    5. Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
    6. Wenn Sie weitere Rollen hinzufügen möchten, klicken Sie auf Weitere Rolle hinzufügen und fügen Sie weitere Rollen hinzu.
    7. Klicken Sie auf Speichern.

Zusammenfassung der Schritte

Dazu sind folgende Schritte erforderlich:

  1. Schritt 1: APIs aktivieren. Für Apigee müssen Sie einige Google Cloud APIs aktivieren.
  2. Schritt 2: Hostingstandort auswählen. Geben Sie den physischen Speicherort des API-Hubs an.
  3. Schritt 3: Hostprojekt registrieren Wählen Sie das Google Cloud-Nutzerprojekt für API-Hub-Ressourcen aus.
  4. Schritt 4: Verschlüsselung konfigurieren Wählen oder erstellen Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK), um Ihre inaktiven API-Daten zu verschlüsseln und zu entschlüsseln.
  5. Schritt 5: Dienstidentität erstellen. Weisen Sie einer Dienstidentität Zugriffsberechtigungen zu, um Ihren CMEK zu verwalten.
  6. Erstellen Sie die API-Hub-Instanz. Warten Sie 5 Minuten, bis die Bereitstellung abgeschlossen ist.

Bereitstellungsschritte

So starten Sie die Bereitstellung für den API-Hub:

  1. Prüfen Sie, ob die unter Vorbereitung beschriebenen Voraussetzungen erfüllt sind.

  2. Rufen Sie in der Google Cloud Console die Seite Mit dem Apigee API-Hub starten auf.

    Zum Apigee API-Hub
  3. Klicken Sie auf der Seite Mit Apigee API-Hub starten auf Jetzt starten.
    • Wird der API-Hub in Ihrer Organisation nicht bereitgestellt, wird in der Benutzeroberfläche Schritt 1 des Bereitstellungsworkflows angezeigt.
    • Wenn der API-Hub bereits bereitgestellt wurde, wird ein Dialogfeld mit Ihrem vorhandenen Hostprojekt für den API-Hub angezeigt. Klicken Sie auf Aufrufen, um die vorhandenen API-Hub-Ressourcen in Ihrem Hostprojekt anzuzeigen.

Schritt 1: APIs

Um den API-Hub bereitzustellen, müssen Sie die folgenden APIs für Ihr Google Cloud-Projekt aktivieren:

API-Name Ort Beschreibung
API Hub API apihub.googleapis.com API Hub API.
Cloud Key Management Service (KMS) cloudkms.googleapis.com

Verwaltet Schlüssel und führt kryptografische Vorgänge für die direkte Verwendung durch andere Cloud-Ressourcen aus.

Klicken Sie zum Aktivieren der erforderlichen APIs auf APIs aktivieren. Dieser Schritt dauert nur wenige Sekunden.

Schritt 2: Hostingstandort

So wählen Sie den physischen Standort (Region) aus, an dem Sie die Apigee API-Hub-Instanz hosten möchten:

  1. Wählen Sie in der Liste Region für Cloud-Instanz den Hosting-Standort aus den aufgeführten Regionen aus. Beispiel: US oder EU.
  2. Klicken Sie auf Standort festlegen.

Schritt 3: Hostprojekt registrieren

Ein Hostprojekt ist ein Google Cloud-Projekt in Ihrer Apigee-Organisation, das Sie als Nutzerprojekt für alle API-Hub-Ressourcen festlegen. Eine einzelne API-Hub-Instanz kann pro Hostprojekt bereitgestellt werden.

Klicken Sie auf Registrieren, um das Google Cloud-Projekt Ihrer Apigee-Organisation als Hostprojekt für den API-Hub zu verwenden.

Schritt 4: Verschlüsselung

In diesem Schritt wählen Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel (Customer Managed Encryption Key, CMEK) aus oder erstellen ihn, der im Cloud Key Management Service definiert ist, um die in Ihrer API-Hub-Instanz gespeicherten Daten zu verschlüsseln.

So verwenden Sie einen vorhandenen Schlüssel:

  1. Geben Sie im Feld Vom Kunden verwalteten Verschlüsselungsschlüssel auswählen einen Filter ein oder scrollen Sie zur Suche nach dem vorhandenen Schlüssel. Alternativ können Sie die Ressourcen-ID des Schlüssels eingeben, um einen vorhandenen Schlüssel zu finden.
  2. Wählen Sie Ihren Schlüssel aus und klicken Sie auf OK.
  3. Klicken Sie auf Bestätigen.

So erstellen Sie einen neuen Schlüssel:

  1. Klicken Sie auf Schlüssel erstellen. Das Dialogfeld Neuen Schlüssel erstellen wird angezeigt.
  2. Im Bereich Schlüsselbund können Sie einen vorhandenen Schlüsselbund angeben oder einen neuen erstellen.
    • So verwenden Sie einen vorhandenen Schlüsselbund:
      1. Wählen Sie einen vorhandenen Schlüsselbund aus der Liste Schlüsselbund aus.
      2. Klicken Sie auf Weiter.
    • So erstellen Sie einen neuen Schlüsselbund:
      1. Klicken Sie auf die Ein/Aus-Schaltfläche Schlüsselbund erstellen oder im Auswahlfeld auf Schlüsselbund erstellen.
      2. Geben Sie im Feld Schlüsselbundname einen Namen für den Schlüsselbund ein.

        Schlüsselbundnamen können Buchstaben, Ziffern, Unterstriche (_) und Bindestriche (-) enthalten. Schlüsselbunde können weder umbenannt noch gelöscht werden.

      3. Wählen Sie einen Standort aus der Liste Schlüsselbundort aus.

        Dieser Ort ist auf den Hosting-Standort beschränkt, den Sie im vorherigen Schritt ausgewählt haben, damit der Schlüssel und die Daten in derselben Region bleiben.

      4. Klicken Sie auf Weiter.
  3. Im Abschnitt Schlüssel:
    1. Geben Sie im Feld Schlüsselname einen Namen für den Schlüssel ein.

      Schlüsselnamen können Buchstaben, Ziffern, Unterstriche (_) und Bindestriche (-) enthalten. Schlüssel können weder umbenannt noch gelöscht werden.

    2. Wählen Sie ein Schutzniveau aus, z. B. Software.
    3. Klicken Sie auf Weiter.
  4. Bestätigen Sie im Abschnitt Prüfen die Details, die Sie für die Schlüsselerstellung angegeben haben.

    Wenn die Informationen korrekt sind, klicken Sie auf Erstellen.

  5. Wählen Sie den neu erstellten Schlüssel im Feld Vom Kunden verwalteten Verschlüsselungsschlüssel auswählen aus.
  6. Klicken Sie auf Verschlüsselungsschlüssel bestätigen.

Schritt 5: Dienstidentität

In diesem Schritt erstellen Sie eine neue Dienstidentität und gewähren ihr Zugriff auf den ausgewählten vom Kunden verwalteten Verschlüsselungsschlüssel. Mit diesem Schlüssel werden Ihre API-Hub-Daten ver- und entschlüsselt.

Klicken Sie zum Erstellen der neuen Dienstidentität auf Dienstidentität erstellen und Berechtigungen erteilen.

Apigee erstellt ein Dienstkonto und weist dem Dienstkonto die Rolle cloudkms.cryptoKeyEncrypterDecrypter zu.

API-Hub-Instanz erstellen

Klicken Sie auf Senden, um die API-Hub-Instanz zu erstellen.

Wenn die Bereitstellung beginnt, wird die Seite API-Hub-Instanz finalisieren angezeigt. Dieser Schritt dauert fünf Minuten.

Nach Abschluss der Bereitstellung wird die Seite APIs des API-Hubs angezeigt.

Nächste Schritte

Glückwunsch! Sie haben den API-Hub erfolgreich bereitgestellt.

Jetzt können Sie den API-Hub verwenden: