Regionen verwalten

Application Integration ist regional, was bedeutet, dass sich die Infrastruktur, in der Ihre Integrationen ausgeführt werden, in einer bestimmten Region befindet und Google sie so verwaltet, dass sie redundant in allen Zonen innerhalb dieser Region verfügbar ist. Neben der Auswahl der ersten Bereitstellungsregion für Application Integration während der Einrichtung können Sie auch neue Regionen aktivieren oder bereitstellen, um Ihre Integrationen im selben Google Cloud-Projekt zu erstellen und zu verwalten.

Auf dieser Seite werden die Schritte beschrieben, die erforderlich sind, um eine neue Application Integration-Region bereitzustellen und eine vorhandene Region in Ihrem Google Cloud -Projekt zu bearbeiten.

Hinweis

Aktivieren Sie folgende APIs:

• Application Integration API (integrations.googleapis.com)
• Connectors API (connectors.googleapis.com)

Neue Region bereitstellen

Wählen Sie eine der folgenden Optionen aus, um eine neue Region für Application Integration in Ihrem Google Cloud -Projekt bereitzustellen:

Console

1. Rufen Sie die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Regionen.

   Die Seite Regionen wird angezeigt. Dort sind alle in Ihrem Projekt bereitgestellten Regionen aufgeführt.

3. Klicken Sie auf Neue Region bereitstellen.
4. Konfigurieren Sie auf der Seite Neue Region bereitstellen die folgenden Felder:
   1. Region: Wählen Sie den neuen regionalen Standort aus, den Sie bereitstellen möchten.

      Informationen zu den unterstützten Application Integration-Regionen finden Sie unter Application Integration-Standorte.

   2. Erweiterte Einstellungen: Optional können Sie diesen Abschnitt maximieren, um den HTTP-Zugriff für Integrationen zu aktivieren oder zu deaktivieren und die Verschlüsselungsmethode für die ausgewählte Region zu konfigurieren.
      • HTTP: Klicken Sie auf den Schalter HTTP aktivieren, um den HTTP-Zugriff für Integrationen in der ausgewählten Region zu aktivieren. Wenn diese Option aktiviert ist, kann auf Integrationen in dieser Region über HTTP zugegriffen werden.
        Hinweis: Die HTTP-Option ist standardmäßig deaktiviert, damit alle Integrationen sicher über HTTPS aufgerufen werden.
      • KI-Funktionen: Klicken Sie auf den Schalter KI-Funktionen aktivieren, um KI-Funktionen in der ausgewählten Region zu aktivieren. Weitere Informationen zur Fehlerbehebung mit Gemini AI finden Sie unter Fehler in Logs fehlgeschlagener Ausführungen mithilfe von KI beheben.
      • Verschlüsselung: Wählen Sie die Verschlüsselungsmethode für die ausgewählte Region aus. Es gibt zwei Möglichkeiten:
        • Google-owned and Google-managed encryption key: Dies ist die Standardverschlüsselungsmethode. Verwenden Sie diese Methode, wenn Google die Verschlüsselungsschlüssel verwalten soll, die Ihre Daten in der ausgewählten Region schützen.
        • Kundenverwalteter Verschlüsselungsschlüssel (CMEK): Verwenden Sie diese Methode, wenn Sie die Verschlüsselungsschlüssel verwalten möchten, die Ihre Daten in der ausgewählten Region schützen.
          Achtung: Das Aktivieren der CMEK-Verschlüsselung für eine Application Integration-Region kann nicht rückgängig gemacht werden. Das bedeutet auch, dass Sie die Verschlüsselungsmethode für eine Region nicht mehr ändern oder wechseln können, nachdem CMEK aktiviert wurde.

          Beim Konfigurieren der Verschlüsselungseinstellungen haben Sie zwei Optionen zum Verwalten von CMEK: „Application Integration und Connectors (CMEK)“ und „Anderen CMEK für Integration Connectors verwenden“.

          • Application Integration und Connectors – CMEK: Dies ist die Standardoption und eignet sich, wenn Sie denselben Verschlüsselungsschlüssel für Application Integration und Integration Connectors verwenden möchten. Führen Sie die folgenden Schritte aus, um diese Option zu verwenden:
            1. Klicken Sie auf Cloud KMS-Schlüssel auswählen und wählen Sie einen vorhandenen CMEK-Schlüssel aus, der in der ausgewählten Region verfügbar ist. Sie können auch einen neuen Schlüssel erstellen oder die KMS-Ressourcen-ID Ihres vorhandenen Schlüssels verwenden.
            2. Klicken Sie auf Prüfen, um zu sehen, ob Ihr Standarddienstkonto CryptoKey-Zugriff auf den ausgewählten CMEK-Schlüssel hat.
            3. Wenn die Überprüfung fehlschlägt, klicken Sie auf Gewähren, um dem Standarddienstkonto die IAM-Rolle „CryptoKey Encrypter/Decrypter“ zuzuweisen.
            Tipp: Das Gewähren des CryptoKey-Zugriffs ist ein optionaler Schritt. Sie können also direkt auf „Fertig“ klicken, um die Einrichtung von Application Integration abzuschließen. Wenn Sie jedoch keinen CryptoKey-Zugriff gewähren, werden keine Authentifizierungsprofile für Application Integration konfiguriert und Sie müssen diesen Zugriff beim Erstellen eines neuen Authentifizierungsprofils manuell gewähren.
          • Anderen CMEK für Integration Connectors verwenden: Aktivieren Sie dieses Kästchen, wenn Sie separate Verschlüsselungsschlüssel für Application Integration und Integration Connectors verwenden möchten. Wenn Sie diese Option auswählen, werden die folgenden Optionen angezeigt:
            • Application Integration – CMEK
              1. Klicken Sie auf Cloud KMS-Schlüssel auswählen und wählen Sie einen vorhandenen CMEK-Schlüssel für Application Integration in der ausgewählten Region aus. Alternativ können Sie einen neuen Schlüssel erstellen oder die Schlüsselressourcen-ID eines vorhandenen Schlüssels verwenden.
              2. Klicken Sie auf Bestätigen, um die Einrichtung von CMEK für Application Integration abzuschließen.
            • Integration Connectors – CMEK
              1. Klicken Sie auf Cloud KMS-Schlüssel auswählen und wählen Sie einen vorhandenen CMEK-Schlüssel für Integration Connectors in der ausgewählten Region aus. Alternativ können Sie einen neuen Schlüssel erstellen oder die Schlüsselressourcen-ID eines vorhandenen Schlüssels verwenden.
              2. Klicken Sie auf Prüfen, um zu sehen, ob Ihr Standarddienstkonto CryptoKey-Zugriff auf den ausgewählten CMEK hat.
              3. Wenn die Überprüfung des ausgewählten CMEK-Schlüssels fehlschlägt, klicken Sie auf Gewähren, um dem Standarddienstkonto die IAM-Rolle „CryptoKey Encrypter/Decrypter“ zuzuweisen.
            Hinweis: Application Integration prüft automatisch, ob Ihr Standarddienstkonto CryptoKey-Zugriff auf den ausgewählten CMEK hat, wenn der CMEK für Integration Connectors aktiviert ist. Wenn die Bestätigung fehlschlägt, müssen Sie diesen Zugriff manuell gewähren.

          Weitere Informationen zu CMEK finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel.

5. Klicken Sie auf Fertig.

Terraform

Verwenden Sie die Ressource google_integrations_client: Im folgenden Beispiel wird die Region us-east1 bereitgestellt:

resource "random_id" "default" {
  byte_length = 8
}

resource "google_kms_key_ring" "default" {
  name     = "${random_id.default.hex}-example-keyring"
  location = "us-east1"
}

resource "google_kms_crypto_key" "default" {
  name            = "crypto-key-example"
  key_ring        = google_kms_key_ring.default.id
  rotation_period = "7776000s"
}

resource "google_kms_crypto_key_version" "default" {
  crypto_key = google_kms_crypto_key.default.id
}

resource "google_service_account" "default" {
  account_id   = "service-account-id"
  display_name = "Service Account"
}

resource "google_integrations_client" "example" {
  location                   = "us-east1"
  create_sample_integrations = true
  run_as_service_account     = google_service_account.default.email
  cloud_kms_config {
    kms_location   = "us-east1"
    kms_ring       = basename(google_kms_key_ring.default.id)
    key            = basename(google_kms_crypto_key.default.id)
    key_version    = basename(google_kms_crypto_key_version.default.id)
    kms_project_id = data.google_project.default.project_id
  }
}

Region bearbeiten

Sie können eine vorhandene Region bearbeiten, um die Integration Governance zu aktivieren oder zu deaktivieren und die Datenverschlüsselungsmethode für die Region zu aktualisieren.

Achtung: Das Aktivieren der CMEK-Verschlüsselung für eine Application Integration-Region kann nicht rückgängig gemacht werden. Das bedeutet auch, dass Sie die Verschlüsselungsmethode für eine Region nicht ändern können, wenn CMEK bereits aktiviert ist.

So bearbeiten Sie eine vorhandene Region in Application Integration:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Regionen.

Die Seite Regionen wird angezeigt. Dort sind die bereitgestellten Regionen in Application Integration aufgeführt.

3. Klicken Sie für die vorhandene Region, die Sie bearbeiten möchten, in der Spalte Aktionen auf Regionsaktionen und wählen Sie Bearbeiten aus.

   Der Bereich Region bearbeiten wird angezeigt.

4. Maximieren Sie Erweiterte Einstellungen.
5. Klicken Sie auf den Ein/Aus-Button Governance aktivieren, um die Integrations-Governance für die ausgewählte Region zu aktivieren oder zu deaktivieren.
   Hinweis:

   • Aktivieren Sie die Governance, um die Dienstkontoauthentifizierung für die Region obligatorisch zu machen. Nachdem „Governance“ aktiviert wurde, müssen Sie allen neuen Integrationen und Integrationsversionen, die in dieser Region erstellt werden, manuell ein Dienstkonto hinzufügen. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich Integrationseinstellungen in der Integrationssymbolleiste ändern oder aktualisieren.

     Wenn Governance aktiviert ist, können Sie eine Integration nur veröffentlichen oder testen, wenn ihr ein Dienstkonto zugeordnet ist.

   • Wenn Sie die Governance für die ausgewählte Region deaktivieren, verwenden alle vorhandenen veröffentlichten Integrationen weiterhin ihre jeweiligen angehängten Dienstkonten, bis eine neue Version der Integrationen erstellt wird.
6. Klicken Sie auf den Ein/Aus-Button HTTP aktivieren, um den HTTP-Zugriff für Integrationen in der ausgewählten Region zu aktivieren oder zu deaktivieren. Wenn diese Option aktiviert ist, kann auf Integrationen in dieser Region über HTTP zugegriffen werden.
7. Wenn Sie KI-Funktionen für Integrationen in der ausgewählten Region aktivieren oder deaktivieren möchten, klicken Sie auf den Schalter KI-Funktionen aktivieren. Wenn diese Option aktiviert ist, können Sie KI-Funktionen wie die Fehlerbehebung mit Gemini AI in der ausgewählten Region verwenden.
8. Wenn Sie die Maskierung für Variablen aktivieren möchten, klicken Sie im Abschnitt Variablenmaskierung auf den Ein/Aus-Button Variablenmaskierung in Logs aktivieren.

   Informationen zur Maskierung finden Sie unter Sensible Daten in Logs maskieren.

9. Wenn Sie die CMEK-Verschlüsselung für die ausgewählte Region aktivieren möchten, wählen Sie Kundenverwalteter Verschlüsselungsschlüssel (CMEK) aus und gehen Sie so vor:
   1. Wählen Sie in der Drop-down-Liste einen CMEK aus. Die im Drop-down-Menü aufgeführten CMEKs basieren auf der bereitgestellten Region. Informationen zum Erstellen eines neuen Schlüssels finden Sie unter Neuen CMEK erstellen.
   2. Klicken Sie auf Prüfen, um zu sehen, ob Ihr Standarddienstkonto CryptoKey-Zugriff auf den ausgewählten CMEK hat.
   3. Wenn die Überprüfung des ausgewählten CMEK fehlschlägt, klicken Sie auf Gewähren, um dem Standarddienstkonto die IAM-Rolle CryptoKey-Verschlüsseler/Entschlüsseler zuzuweisen.
10. Wenn Sie die CMEK-Verschlüsselung für Integration Connectors aktivieren möchten, wählen Sie Anderen CMEK für Integration Connectors verwenden aus und gehen Sie so vor:
    1. Wählen Sie in der Drop-down-Liste einen CMEK aus. Die im Drop-down-Menü aufgeführten CMEKs basieren auf der bereitgestellten Region. Informationen zum Erstellen eines neuen Schlüssels finden Sie unter Neuen CMEK erstellen.
    2. Klicken Sie auf Bestätigen, um die Einrichtung des CMEK für Integration Connectors abzuschließen.
11. Klicken Sie auf Fertig, um die Bearbeitung der Region abzuschließen.