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 la procedura di configurazione, puoi anche attivare 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 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 della 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 Provision new region (Esegui provisioning nuova regione).
4. Configura i seguenti campi nella pagina Provision new region (Esegui il provisioning di una nuova regione):
   1. Regione:seleziona la nuova posizione regionale di cui vuoi eseguire il provisioning.

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

   2. Impostazioni avanzate: (facoltativo) 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 attivare l'accesso HTTP per le integrazioni all'interno della regione selezionata. Se abilitate, le integrazioni in questa regione sono accessibili tramite HTTP.
        Nota:l'opzione di attivazione/disattivazione HTTP è disattivata 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 Attiva funzionalità di AI per attivare le funzionalità di AI nella regione selezionata. Per saperne di più sulla risoluzione dei problemi utilizzando Gemini AI, consulta Risolvere i problemi relativi ai log di esecuzione non riuscita 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: è 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 una volta abilitata la chiave CMEK.

          Quando configuri le impostazioni di crittografia, hai due opzioni per gestire CMEK: Application Integration e connettori (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 account di servizio predefinito ha accesso CryptoKey alla chiave CMEK selezionata.
            3. Se la verifica non riesce, fai clic su Concedi per assegnare il ruolo IAM Autore crittografia/decriptazione 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 dell'Application Integration. Tuttavia, se non concedi l'accesso a CryptoKey, i profili di autenticazione per l'Application Integration non vengono configurati e devi concedere manualmente questo accesso quando crei un nuovo profilo di autenticazione.
          • Utilizza una chiave 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 chiave di una 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 chiave di una chiave esistente.
              2. Fai clic su Verifica per controllare se il account di servizio predefinito ha accesso a CryptoKey per la chiave 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/decrittografia CryptoKey al account di servizio predefinito.
            Nota:Application Integration verifica automaticamente se il account di servizio predefinito ha accesso a CryptoKey per la CMEK selezionata, se la CMEK di Integration Connectors è abilitata. Se la verifica non va a buon fine, devi concedere manualmente questo accesso.

          Per saperne di più sulle chiavi 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à abilitata.

Per modificare una regione esistente in Application Integration:

1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

   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 da modificare, fai clic su Azioni regione nella colonna Azioni e seleziona Modifica.

   Viene visualizzato il riquadro Modifica regione.

4. Espandi Impostazioni avanzate.
5. Per attivare o disattivare la governance dell'integrazione per la regione selezionata, fai clic sul pulsante di attivazione/disattivazione Attiva governance.
   Nota:

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

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

   • Se disattivi la governance per la regione selezionata, tutte le integrazioni pubblicate esistenti continuano a utilizzare i rispettivi account di servizio collegati finché non viene creata una nuova versione delle integrazioni.
6. Per attivare o disattivare l'accesso HTTP per le integrazioni nella regione selezionata, fai clic sul pulsante di attivazione/disattivazione Attiva 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 Attiva funzionalità di AI. Se abilitata, puoi utilizzare le funzionalità di AI come la risoluzione dei problemi utilizzando Gemini AI nella regione selezionata.
8. Per attivare la maschera per le variabili, fai clic sul pulsante di attivazione/disattivazione Attiva la maschera per le variabili nei log nella sezione Maschera per le variabili. Questa funzionalità è in anteprima.

   Per informazioni sul mascheramento, vedi Mascherare i dati sensibili nei log.

9. Per attivare la crittografia CMEK per la regione selezionata, seleziona Chiave di crittografia gestita dal cliente (CMEK) e procedi nel seguente modo:
   1. Seleziona una CMEK dall'elenco a discesa disponibile. Le chiavi 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 account di servizio predefinito ha accesso a CryptoKey per la chiave 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/decrittografia CryptoKey al account di servizio predefinito.
10. Per attivare la crittografia CMEK per Integration Connectors, seleziona Utilizza una chiave CMEK diversa per Integration Connectors e procedi nel seguente modo:
    1. Seleziona una CMEK dall'elenco a discesa disponibile. Le chiavi 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 di Integration Connectors CMEK.
11. Fai clic su Fine per completare la modifica della regione.