Questa pagina è stata tradotta dall'API Cloud Translation.

Connettività di rete pubblica

Questa pagina descrive in che modo i connettori di integrazione possono connettersi alle tue applicazioni di backend accessibili pubblicamente.

Di seguito sono riportati i due modi per connettersi all'applicazione di backend pubblica:

Connettiti direttamente all'applicazione di backend pubblica.
Connettiti all'applicazione backend pubblica tramite un firewall.

Connettiti direttamente all'applicazione di backend pubblica

Se puoi connetterti pubblicamente all'applicazione di backend, puoi configurare la connessione in modo da utilizzare l'endpoint pubblico specificandolo nel campo Hostname. Le tue connessioni avranno accesso diretto all'applicazione di backend.

Collegarti all'applicazione backend pubblica tramite un firewall

Se vuoi limitare l'accesso ai tuoi endpoint pubblici con un firewall, puoi configurare Integration Connectors in modo che utilizzi un insieme di indirizzi IP statici per il traffico proveniente dalle connessioni. Dopo la configurazione, tutte le chiamate di una connessione provengono da un insieme di indirizzi IP statici, che puoi inserire nella lista consentita del firewall. Per consentire una connessione tramite un firewall, devi svolgere i seguenti passaggi di alto livello:

Crea un firewall e inoltra il traffico in uscita tramite il firewall.
Assegna un indirizzo IP statico alla connessione.
Inserisci l'indirizzo IP statico assegnato nella lista consentita del firewall.

I passaggi per creare e configurare un firewall non rientrano nell'ambito di questa pagina. Questa pagina descrive solo come assegnare indirizzi IP statici alle connessioni.

Per impostazione predefinita, Integration Connectors alloca automaticamente gli indirizzi IP. Tuttavia, puoi configurare i connettori di integrazione in modo da generare indirizzi IP statici anziché indirizzi IP automatici. Integration Connectors assegna gli indirizzi IP statici a livello di regione. Ad esempio, gli indirizzi IP statici per la regione us-east1 saranno diversi da quelli della regione us-west2.

Per assegnare indirizzi IP statici alla connessione:

Ottieni la regione della connessione per cui vuoi allocare l'indirizzo IP statico. Puoi visualizzare la regione di connessione nella colonna Location della pagina Connessioni.
Vai alla pagina Connessioni
In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Suggerimento: anche se in questo passaggio viene indicato di aprire Cloud Shell, puoi eseguire i comandi anche sul terminale normale, perché chiamerai le API pubbliche di Integration Connectors.

Configura Integration Connectors in modo da assegnare l'indirizzo IP statico per la regione ottenuta nel passaggio 1. Esegui il comando riportato di seguito in Cloud Shell.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"networkConfig": {"egressMode": "static_ip"}}' \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

Imposta LOCATION sulla regione ottenuta nel passaggio 1.

L'esecuzione di questo comando restituisce una risposta simile alla seguente:

{
"name": "projects/test-01/locations/us-central1/operations/operation-1696840994443-6074494b6d138-8215226d-516faaf8",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.OperationMetadata",
  "createTime": "2023-10-09T08:43:14.467058513Z",
  "target": "projects/test-01/locations/us-central1/regionalSettings",
  "verb": "update",
  "requestedCancellation": false,
  "apiVersion": "v1"
 },
"done": false
}

Questo comando restituisce un ID operazione e avvia un'operazione a lunga esecuzione (LRO) che potrebbe richiedere del tempo per essere completata. Attendi il completamento dell'operazione LRO. Puoi monitorare l'avanzamento dell'operazione utilizzando il seguente comando:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Se l'allocazione dell'indirizzo IP statico è andata a buon fine, riceverai una risposta simile alla seguente:

...
...
"response": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
  "name": "projects/test-01/locations/us-central1/regionalSettings",
  "networkConfig": {
   "egressMode": "STATIC_IP",
    "egressIps": [
      "35.193.227.203",
      "34.133.63.9",
      "35.223.253.58",
      "34.170.27.253"
    ]
  }
}

In questa risposta di esempio, vengono allocati quattro indirizzi IP statici per la regione us-central1 e il egressMode per la regione è impostato su STATIC_IP.

Inserisci gli indirizzi IP statici (ottenuti nel passaggio 4) nella lista consentita delle regole del firewall.

Ottenere gli indirizzi IP statici di una regione

Se in qualsiasi momento vuoi ottenere gli indirizzi IP statici allocati a una regione (posizione), esegui il seguente comando:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

L'esecuzione di questo comando restituisce una risposta simile alla seguente:

  "response": {
    "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
    "name": "projects/test-01/locations/us-central1/regionalSettings",
    "networkConfig": {
     "egressMode": "STATIC_IP",
      "egressIps": [
        "35.193.227.203",
        "34.133.63.9",
        "35.223.253.58",
        "34.170.27.253"
      ]
    }
  }

Assegnare indirizzi IP automatici a una regione

Se vuoi rimuovere la configurazione degli indirizzi IP statici per una regione e assegnare automaticamente gli indirizzi IP, devi eseguire il seguente comando nel terminale:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"networkConfig": {"egressMode": "auto_ip"}}' \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

Analogamente al comando precedente per la configurazione degli indirizzi IP statici, anche questo comando restituisce un ID operazione e avvia un'operazione a lunga esecuzione (LRO) che potrebbe richiedere del tempo per essere completata. Attendi il completamento dell'operazione LRO.

Considerazioni

Tieni presente i seguenti punti quando assegni indirizzi IP statici per una regione:

L'insieme di indirizzi IP statici riservati è diverso per le varie regioni all'interno di un progetto.
Quando modifichi la modalità di uscita per una regione da STATIC_IP a AUTO_IP, l'insieme originale di indirizzi IP statici non viene mantenuto e, di conseguenza, quando modifichi di nuovo la modalità di uscita da AUTO_IP a STATIC_IP, viene allocato un nuovo insieme di indirizzi IP statici.
Quando modifichi la modalità di uscita da AUTO_IP a STATIC_IP o viceversa, puoi prevedere un tempo di riposo nell'ordine di secondi.