Gestisci regioni

Application Integration è regionale, il che significa che l'infrastruttura che esegue le tue integrazioni si trova in una regione specifica e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di quella regione. Oltre a selezionare la regione di provisioning iniziale per Application Integration durante il processo di configurazione, puoi anche abilitare o eseguire il provisioning di nuove regioni per creare e gestire le integrazioni all'interno dello stesso progetto Google Cloud.

Questa pagina descrive i passaggi necessari per eseguire correttamente il provisioning di una nuova regione di Application Integration e modificare una regione esistente nel tuo progetto Google Cloud .

Prima di iniziare

Abilita le seguenti API:

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

Esegui il provisioning di una nuova regione

Per eseguire il provisioning di una nuova regione per Application Integration nel tuo progetto Google Cloud , seleziona una delle seguenti opzioni:

Console

1. Vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Regioni.

   Viene visualizzata la pagina Regioni, che elenca tutte le regioni di cui è stato eseguito il provisioning nel progetto.

3. Fai clic su Esegui il provisioning di una nuova regione.
4. Configura i seguenti campi nella pagina Esegui il provisioning di una nuova regione:
   1. Regione: seleziona la nuova località regionale di cui vuoi eseguire il provisioning.

      Per informazioni sulle regioni di Application Integration supportate, consulta Località di Application Integration.

   2. Impostazioni avanzate: se vuoi, espandi questa sezione per attivare o disattivare l'accesso HTTP per le integrazioni e configurare il metodo di crittografia per la regione selezionata.
      • HTTP: fai clic sul pulsante di attivazione/disattivazione Abilita HTTP per abilitare l'accesso HTTP per le integrazioni all'interno della regione selezionata. Se abilitate, le integrazioni in questa regione sono accessibili tramite HTTP.
        Nota: il pulsante di attivazione/disattivazione HTTP è disattivato per impostazione predefinita per garantire che tutte le integrazioni vengano richiamate in modo sicuro tramite HTTPS.
      • Funzionalità di AI: fai clic sul pulsante di attivazione/disattivazione Abilita le funzionalità di AI per abilitare le funzionalità di AI nella regione selezionata. Per saperne di più sulla risoluzione dei problemi utilizzando Gemini AI, consulta Risolvi i problemi relativi ai log di esecuzione non riusciti utilizzando l'AI.
      • Crittografia: seleziona il metodo di crittografia per la regione selezionata. Le opzioni disponibili sono due:
        • Google-owned and Google-managed encryption key: questo è il metodo di crittografia predefinito. Utilizza questo metodo se vuoi che Google gestisca le chiavi di crittografia che proteggono i tuoi dati nella regione selezionata.
        • Chiave di crittografia gestita dal cliente (CMEK): utilizza questo metodo se vuoi gestire le chiavi di crittografia che proteggono i tuoi dati nella regione selezionata.
          Attenzione: l'attivazione della crittografia CMEK per una regione di Application Integration non può essere annullata. Ciò significa anche che non puoi modificare/cambiare il metodo di crittografia per una regione dopo aver attivato CMEK.

          Quando configuri le impostazioni di crittografia, hai due opzioni per gestire le CMEK: Application Integration e Connectors (CMEK) e Utilizza una CMEK diversa per Integration Connectors, come segue:

          • Application Integration e connettori - CMEK: questa è l'opzione predefinita ed è adatta se vuoi utilizzare la stessa chiave di crittografia sia per Application Integration che per Integration Connectors. Per utilizzare questa opzione, segui questi passaggi:
            1. Fai clic su Seleziona una chiave Cloud KMS e scegli una chiave CMEK esistente disponibile nella regione selezionata. Puoi anche creare una nuova chiave o utilizzare l'ID risorsa KMS della chiave esistente.
            2. Fai clic su Verifica per controllare se il tuo account di servizio predefinito dispone dell'accesso CryptoKey alla chiave CMEK selezionata.
            3. Se la verifica non va a buon fine, fai clic su Concedi per assegnare il ruolo IAM Autore crittografia/decrittografia CryptoKey al account di servizio predefinito.
            Suggerimento: la concessione dell'accesso a CryptoKey è un passaggio facoltativo, il che significa che puoi fare clic direttamente su Fine per completare la procedura di configurazione di Application Integration. Tuttavia, se non concedi l'accesso a CryptoKey, i profili di autenticazione per Application Integration non vengono configurati e devi concedere manualmente questo accesso quando crei un nuovo profilo di autenticazione.
          • Utilizza una CMEK diversa per Integration Connectors: seleziona questa casella di controllo se preferisci utilizzare chiavi di crittografia separate per Application Integration e Integration Connectors. Se selezionata, vengono visualizzate le seguenti opzioni:
            • Application Integration - CMEK
              1. Fai clic su Seleziona una chiave Cloud KMS e scegli una chiave CMEK esistente per Application Integration nella regione selezionata. In alternativa, puoi creare una nuova chiave o utilizzare l'ID risorsa della chiave di una chiave esistente.
              2. Fai clic su Verifica per completare la configurazione di CMEK per Application Integration.
            • Integration Connectors - CMEK
              1. Fai clic su Seleziona una chiave Cloud KMS e scegli una chiave CMEK esistente per Integration Connectors nella regione selezionata. In alternativa, puoi creare una nuova chiave o utilizzare l'ID risorsa di una chiave esistente.
              2. Fai clic su Verifica per controllare se il tuo account di servizio predefinito dispone dell'accesso CryptoKey alla CMEK selezionata.
              3. Se la verifica della chiave CMEK selezionata non va a buon fine, fai clic su Concedi per assegnare il ruolo IAM Autore crittografia/decriptazione CryptoKey all'account di servizio predefinito.
            Nota: Application Integration verifica automaticamente se il tuo account di servizio predefinito dispone dell'accesso CryptoKey alla CMEK selezionata, se la CMEK di Integration Connectors è abilitata. Se la verifica non va a buon fine, devi concedere l'accesso manualmente.

          Per saperne di più sulle CMEK, consulta Chiavi di crittografia gestite dal cliente.

5. Fai clic su Fine.

Terraform

Utilizza la risorsa google_integrations_client. L'esempio seguente esegue il provisioning della regione us-east1:

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
  }
}

Modifica regione

Puoi modificare una regione esistente per abilitare o disabilitare la governance dell'integrazione e per aggiornare il metodo di crittografia dei dati per la regione.

Attenzione: l'attivazione della crittografia CMEK per una regione di Application Integration non può essere annullata. Ciò significa anche che non puoi modificare il metodo di crittografia per una regione se CMEK è già abilitato.

Per modificare una regione esistente in Application Integration, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Regioni.

Viene visualizzata la pagina Regioni, che elenca le regioni di cui è stato eseguito il provisioning in Application Integration.

3. Per la regione esistente che vuoi modificare, nella colonna Azioni, fai clic su Azioni regione e seleziona Modifica.

   Viene visualizzato il riquadro Modifica regione.

4. Espandi Impostazioni avanzate.
5. Per abilitare o disabilitare la governance delle integrazioni per la regione selezionata, fai clic sul pulsante di attivazione/disattivazione Abilita governance.
   Nota:

   • Abilita la governance per rendere obbligatoria l'autenticazione del account di servizio per la regione. Una volta abilitata la governance, devi aggiungere manualmente un account di servizio a tutte le nuove integrazioni e versioni delle integrazioni create in questa regione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal riquadro Impostazioni di integrazione nella barra degli strumenti di integrazione.

     Se la governance è abilitata, puoi pubblicare o testare un'integrazione solo se è collegato un account di servizio.

   • Se disattivi la governance per la regione selezionata, tutte le integrazioni pubblicate esistenti continuano a utilizzare i rispettivi service account collegati finché non viene creata una nuova versione delle integrazioni.
6. Per abilitare o disabilitare l'accesso HTTP per le integrazioni nella regione selezionata, fai clic sul pulsante di attivazione/disattivazione Abilita HTTP. Se abilitate, le integrazioni in questa regione sono accessibili tramite HTTP.
7. Per attivare o disattivare le funzionalità di AI per le integrazioni nella regione selezionata, fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità di AI. Se abilitata, puoi utilizzare funzionalità di AI come la risoluzione dei problemi utilizzando Gemini AI nella regione selezionata.
8. Per attivare il mascheramento delle variabili, nella sezione Mascheramento delle variabili, fai clic sul pulsante di attivazione/disattivazione Attiva il mascheramento delle variabili nei log.

   Per informazioni sul mascheramento, consulta Maschera i dati sensibili nei log.

9. Per abilitare la crittografia CMEK per la regione selezionata, seleziona Chiave di crittografia gestita dal cliente (CMEK) e segui questi passaggi:
   1. Seleziona una CMEK dall'elenco a discesa disponibile. Le CMEK elencate nel menu a discesa si basano sulla regione di provisioning. Per creare una nuova chiave, consulta Crea una nuova CMEK.
   2. Fai clic su Verifica per controllare se il tuo account di servizio predefinito dispone dell'accesso CryptoKey alla CMEK selezionata.
   3. Se la verifica della CMEK selezionata non va a buon fine, fai clic su Concedi per assegnare il ruolo IAM CryptoKey Encrypter/Decrypter al account di servizio predefinito.
10. Per abilitare la crittografia CMEK per Integration Connectors, seleziona Utilizza una CMEK diversa per Integration Connectors e segui questi passaggi:
    1. Seleziona una CMEK dall'elenco a discesa disponibile. Le CMEK elencate nel menu a discesa si basano sulla regione di provisioning. Per creare una nuova chiave, consulta Crea una nuova CMEK.
    2. Fai clic su Verifica per completare la configurazione della chiave CMEK di Integration Connectors.
11. Fai clic su Fine per completare la modifica della regione.