Protezione delle macchine virtuali con IAP

Questa pagina spiega come utilizzare l'inoltro TCP di Identity-Aware Proxy (IAP) per abilitare l'accesso amministrativo alle istanze VM che non hanno indirizzi IP esterni o non consentono l'accesso diretto su internet.

L'inoltro TCP IAP consente di stabilire un tunnel criptato da cui puoi inoltrare SSH, RDP e altro traffico alle istanze VM. L'inoltro TCP IAP offre inoltre un controllo granulare sugli utenti autorizzati a stabilire i tunnel e sulle istanze VM a cui gli utenti sono autorizzati a connettersi.

Per saperne di più su come funziona l'inoltro TCP IAP, consulta la panoramica sull'inoltro TCP.

Preparazione del progetto per l'inoltro TCP IAP

Questa sezione illustra i passaggi necessari per abilitare l'inoltro TCP IAP nel tuo progetto Google Cloud.

Nota: se utilizzi un proxy aziendale e non utilizzi Cloud VPN tra la rete on-premise e la rete VPC, devi inserire nella lista consentita il dominio IAP per TCP sulla rete aziendale.

Crea una regola firewall

Per consentire a IAP di connettersi alle tue istanze VM, crea una regola firewall che:

• Si applichi a tutte le istanze VM a cui vuoi accedere tramite IAP.
• consente il traffico in entrata dall'intervallo IP 35.235.240.0/20. Questo intervallo contiene tutti gli indirizzi IP che IAP utilizza per l'inoltro TCP.
• Consenta le connessioni a tutte le porte che vuoi rendere accessibili utilizzando l'inoltro TCP di IAP, ad esempio la porta 22 per SSH e la porta 3389 per RDP.

Console

Per consentire l'accesso RDP e SSH a tutte le istanze VM della tua rete, procedi nel seguente modo:

1. Apri la pagina Regole firewall.

   Apri la pagina Regole firewall

   I passaggi rimanenti verranno visualizzati automaticamente nella console Google Cloud.

2. Seleziona un progetto Google Cloud. Procedura.
3. Nella pagina Regole firewall, fai clic su Crea regola firewall.
4. Configura le seguenti impostazioni:
   • Nome: allow-ingress-from-iap
   • Direzione del traffico: in entrata
   • Target: tutte le istanze nella rete
   • Filtro di origine: intervalli IP
   • Intervalli IP di origine: 35.235.240.0/20
   • Protocolli e porte: seleziona TCP e inserisci 22,3389 per consentire sia RDP che SSH.
5. Fai clic su Crea.

gcloud

Per consentire l'accesso RDP a tutte le istanze VM della tua rete, esegui:

gcloud compute firewall-rules create allow-rdp-ingress-from-iap \
  --direction=INGRESS \
  --action=allow \
  --rules=tcp:3389 \
  --source-ranges=35.235.240.0/20

Per l'accesso SSH, esegui:

gcloud compute firewall-rules create allow-ssh-ingress-from-iap \
  --direction=INGRESS \
  --action=allow \
  --rules=tcp:22 \
  --source-ranges=35.235.240.0/20

Per altri protocolli, esegui

gcloud compute firewall-rules create allow-ingress-from-iap \
  --direction=INGRESS \
  --action=allow \
  --rules=tcp:PORT \
  --source-ranges=35.235.240.0/20

dove PORT è la porta utilizzata dal protocollo.

Nota: le regole predefinite default-allow-ssh e default-allow-rdp consentono le connessioni SSH e RDP da tutti gli indirizzi IP, non solo da IAP. Valuta la possibilità di disabilitare o eliminare queste regole se vuoi impedire l'accesso diretto tramite SSH o RDP alle istanze VM.

Concedi ruoli per l'inoltro TCP IAP

Per controllare a quali utenti e gruppi è consentito utilizzare l'inoltro TCP IAP e a quali istanze VM possono connettersi, concedi i ruoli Identity and Access Management (IAM) appropriati per il progetto.

La seguente tabella mostra i ruoli predefiniti che è necessario concedere agli amministratori attendibili per l'inoltro TCP e le attività correlate:

Attività	Ruoli	Ulteriori informazioni
Inoltro TCP	Utente del tunnel con protezione IAP (roles/iap.tunnelResourceAccessor)	Vedi Concedere l'accesso a tutte le istanze VM in un progetto o Concedere l'accesso a una VM specifica.
Accesso SSH	Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)
OS Login (consigliato)	Vari	Consulta la pagina Configurazione dei ruoli di OS Login negli account utente.
Utilizza un account di servizio	Utente account di servizio (roles/iam.serviceAccountUser)	Vedi Il ruolo serviceAccountUser.

Nota: se stai lavorando in un progetto creato da te, hai le autorizzazioni necessarie per eseguire queste attività.

Se vuoi creare ruoli personalizzati solo con le autorizzazioni specifiche necessarie per questa attività, consulta Dettagli autorizzazioni.

Puoi concedere a un utente o a un gruppo l'accesso a tutte le istanze VM di un progetto o a una VM specifica, a seconda di come concedi i ruoli richiesti.

Concedi l'accesso a tutte le istanze VM in un progetto

Puoi concedere a un utente o a un gruppo l'accesso a tutte le istanze VM in un progetto concedendo i ruoli IAM richiesti a livello di progetto:

Console

1. Apri la pagina IAM e amministrazione nella console Google Cloud.

   Apri la pagina IAM e amministrazione

   I passaggi rimanenti verranno visualizzati automaticamente nella console Google Cloud.

2. Nella pagina IAM e amministrazione, fai clic su Aggiungi e configura quanto segue:
   • Nuove entità: specifica l'utente o il gruppo a cui concedere l'accesso.
   • Seleziona un ruolo: seleziona Cloud IAP > Utente del tunnel con protezione IAP.
3. Facoltativamente, fai clic su Aggiungi condizione e configura una condizione:
   • Titolo: inserisci un nome per la condizione.
   • Espressione: inserisci una condizione che un utente deve soddisfare per ottenere le autorizzazioni nel ruolo Utente del tunnel con protezione IAP.

   Ad esempio, la seguente espressione CEL concede l'accesso solo alla porta 22:

   destination.port == 22

   Puoi anche concedere l'accesso in base al livello di accesso:

   destination.port == 22 &&
   "FULL_ACCESS_LEVEL_NAME" in request.auth.access_levels

   Dove FULL_ACCESS_LEVEL_NAME è un livello di accesso esistente e utilizza il seguente formato:

   accessPolicies/POLICY_NAME/accessLevels/ACCESS_LEVEL_NAME

4. Fai clic su Aggiungi un altro ruolo e configura quanto segue:
   • Seleziona un ruolo Seleziona Compute Engine > Amministratore istanze Compute (v1).
5. Fai clic su Salva.

gcloud

Concedi i due ruoli all'utente eseguendo questi comandi:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=user:EMAIL \
    --role=roles/iap.tunnelResourceAccessor
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=user:EMAIL \
    --role=roles/compute.instanceAdmin.v1

Sostituisci quanto segue:

• PROJECT_ID: ID del progetto
• EMAIL: indirizzo email dell'utente a cui vuoi concedere l'accesso, ad esempio [e-mail].

Concedi l'accesso a una VM specifica

Per concedere a un utente o un gruppo l'accesso a una VM specifica, concedi il ruolo roles/iap.tunnelResourceAccessor su quella VM. Gli altri ruoli devono essere concessi nel progetto.

Console

1. Apri la pagina di amministrazione di IAP e seleziona la scheda Risorse SSH e TCP.

   Apri la pagina Amministrazione di BeyondCorp Enterprise

   I passaggi rimanenti verranno visualizzati automaticamente nella console Google Cloud.

2. Nella scheda Risorse SSH e TCP della pagina di amministrazione di IAP, seleziona le istanze VM da configurare.
3. Se il riquadro informazioni non è visibile, fai clic su Mostra riquadro informazioni.

4. Fai clic su Aggiungi entità e configura quanto segue:

   • Nuove entità: specifica l'utente o il gruppo a cui concedere l'accesso.
   • Seleziona un ruolo: seleziona Cloud IAP > Utente del tunnel con protezione IAP.

5. Facoltativamente, fai clic su Aggiungi condizione e configura una condizione:

   • Titolo: inserisci un nome per la condizione.
   • Espressione: inserisci una condizione che un utente deve soddisfare per ottenere le autorizzazioni nel ruolo Utente del tunnel con protezione IAP.

   Ad esempio, la seguente espressione CEL concede l'accesso solo alla porta 22:

         destination.port == 22

   Puoi anche concedere l'accesso in base al livello di accesso:

       destination.port == 22 &&
       "FULL_ACCESS_LEVEL_NAME" in request.auth.access_levels

   Dove FULL_ACCESS_LEVEL_NAME è un livello di accesso esistente e utilizza il seguente formato: accessPolicies/POLICY_NAME/accessLevels/ACCESS_LEVEL_NAME.

6. Fai clic su Salva.

API

Per modificare il file policy.json della tua applicazione, procedi nel seguente modo. Consulta Gestione dell'accesso alle risorse protette da BeyondCorp Enterprise per ulteriori informazioni sull'utilizzo dell'API IAM per gestire i criteri di accesso.

1. Esporta le seguenti variabili.

   export IAP_BASE_URL=https://iap.googleapis.com/v1/projects/PROJECT_NUMBER/iap_tunnel
   # Replace POLICY_FILE.JSON with the name of JSON file to use for setIamPolicy
   export JSON_NEW_POLICY=POLICY_FILE.JSON
   

2. Ottieni il criterio IAM per l'istanza Compute Engine utilizzando il metodo getIamPolicy. Il bit di dati vuoto alla fine trasforma la richiesta curl in POST anziché in GET.

   curl -i -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        ${IAP_BASE_URL}/zones/ZONE_NAME/instances/INSTANCE_ID or INSTANCE_NAME:getIamPolicy \
        -d ''

3. Concedi il ruolo iap.tunnelResourceAccessor alle entità modificando il file JSON dei criteri IAM.
   

4. (Facoltativo) Concedi il ruolo solo alle entità che soddisfano criteri specifici, in base alle condizioni IAM e ai livelli di accesso.

   Di seguito è riportato un esempio di file policy.json modificato che concede il ruolo iap.tunnelResourceAccessor a un gruppo di amministratori di istanze VM, concedendo loro l'accesso alle risorse del tunnel protette da BeyondCorp Enterprise. È stata aggiunta una condizione IAM per rendere le risorse accessibili solo alle entità nel gruppo di amministratori delle istanze VM con un indirizzo IP privato 10.0.0.1 sulla porta 22 utilizzando le condizioni IAM destination.ip e destination.port. Devono inoltre soddisfare i requisiti del livello di accesso ACCESS_LEVEL_NAME.

   Tieni presente che se un'entità ha il ruolo Proprietario, ha l'autorizzazione a utilizzare IAP per l'inoltro TCP.

   
   File policy.json di esempio

   {
     "policy": {
       "bindings": [
         {
           "role": "roles/iap.tunnelResourceAccessor",
           "members": ["group:[e-mail]"],
           "condition": {
             "expression": "\"accessPolicies/POLICY_NAME/accessLevels/ACCESS_LEVEL_NAME\" in request.auth.access_levels && destination.ip == \"10.0.0.1\" && destination.port == 22",
             "title": "CONDITION_NAME"
           }
         }
       ]
     }
   }

   Per trovare il nome di una norma, chiama accessPolicies.list:

   GET https://accesscontextmanager.googleapis.com/v1/accessPolicies
   

5. Imposta il nuovo file policy.json con il metodo setIamPolicy.

   curl -i -H "Content-Type:application/json" \
             -H "Authorization: Bearer $(gcloud auth print-access-token)" \
             ${IAP_BASE_URL}/zones/ZONE_NAME/instances/INSTANCE_ID or INSTANCE_NAME:setIamPolicy \
             -d @${JSON_NEW_POLICY}
   

Dettagli autorizzazioni

Le autorizzazioni richieste variano a seconda di come un utente utilizzerà l'inoltro TCP IAP:

Scenari		Autorizzazioni obbligatorie
Tutti		iap.tunnelInstances.accessViaIAP
Uso: gcloud compute [start-iap-tunnel, ssh, scp]		compute.instances.get compute.instances.list
Uso: gcloud compute [ssh, scp]		compute.projects.get
	VM che utilizza OS Login	Consulta queste istruzioni.
	OS Login non viene utilizzato	compute.instances.setMetadata compute.projects.setCommonInstanceMetadata compute.globalOperations.get
SSH alla VM mediante un account di servizio		iam.serviceAccounts.actAs
SSH dal browser		Consulta queste istruzioni.

Ad esempio, se un utente vuole connettersi utilizzando gcloud compute ssh a una VM che non utilizza OS Login, ma che utilizza un account di servizio, deve avere le seguenti autorizzazioni:

• iap.tunnelInstances.accessViaIAP
• compute.instances.get
• compute.instances.list
• compute.projects.get
• compute.instances.setMetadata
• compute.projects.setCommonInstanceMetadata
• compute.globalOperations.get
• iam.serviceAccounts.actAs

Collegamento SSH a tunnel

Puoi connetterti alle istanze Linux prive di un indirizzo IP esterno eseguendo il tunneling del traffico SSH tramite IAP.

Quando utilizzi il tunneling IAP, i proxy IAP si connettono all'indirizzo IPv4 interno principale di nic0 sulla VM.

Console

Per connetterti all'istanza, utilizza il pulsante SSH nella console Google Cloud. La configurazione dell'accesso dell'istanza (definita tramite le autorizzazioni IAM) deve consentire il tunneling TCP tramite IAP.

gcloud

Per connetterti all'istanza, utilizza il comando gcloud compute ssh. La configurazione dell'accesso dell'istanza (definita tramite le autorizzazioni IAM) deve consentire il tunneling TCP tramite IAP.

gcloud compute ssh INSTANCE_NAME

Sostituisci INSTANCE_NAME con il nome dell'istanza a cui accedere tramite SSH.

Se l'istanza non ha un indirizzo IP esterno, la connessione utilizza automaticamente il tunneling TCP IAP. Se l'istanza ha un indirizzo IP esterno, la connessione utilizza l'indirizzo IP esterno anziché il tunneling TCP IAP.

Puoi utilizzare il flag --tunnel-through-iap in modo che gcloud compute ssh utilizzi sempre il tunneling TCP IAP.

Utilizza il flag --internal-ip in modo che gcloud compute ssh non utilizzi mai il tunneling TCP IAP e si connetta direttamente all'IP interno della VM. Questa operazione è utile per i client connessi alla stessa rete VPC della VM di destinazione.

Nota: lo strumento gcloud richiede di specificare l'istanza a cui vuoi connetterti. Per eseguire il tunneling utilizzando gcloud, devi fornire il nome dell'istanza.

Computer IAP

Puoi utilizzare IAP Desktop per connetterti a un'istanza VM tramite l'inoltro SSH e TCP di IAP.

1. Nell'applicazione, seleziona File > Aggiungi progetto Google Cloud.

2. Inserisci l'ID o il nome del progetto e fai clic su OK.

3. Nella finestra Esplora progetto, fai clic con il tasto destro del mouse sull'istanza VM a cui vuoi connetterti e seleziona Connetti.

Per maggiori informazioni su IAP per desktop, consulta la pagina del progetto GitHub.

Nota: IAP Desktop è un progetto open source e non è un prodotto Google supportato ufficialmente.

App PuTTY

Puoi configurare l'app emulatore di terminale Windows PuTTY in modo che utilizzi l'inoltro TCP IAP per connettersi a un'istanza VM. La configurazione dell'accesso dell'istanza (definita tramite le autorizzazioni IAM) deve consentire il tunneling TCP tramite IAP.

Prima di configurare l'app PuTTY, utilizza una volta il comando gcloud compute ssh per assicurarti di disporre di una chiave SSH privata sul computer locale e che la chiave SSH pubblica sia pubblicata su Compute Engine:

1. Apri un prompt dei comandi ed esegui questo comando per connetterti all'istanza VM:

   gcloud compute ssh INSTANCE_NAME `
     --tunnel-through-iap `
     --project PROJECT_ID `
     --zone ZONE
   

   Sostituisci quanto segue:

   • INSTANCE_NAME: nome dell'istanza a cui connettersi
   • PROJECT_ID: ID del progetto in cui si trova l'istanza VM
   • ZONE: zona in cui si trova l'istanza VM

   Se necessario, conferma di voler generare chiavi SSH premendo Y.

2. Sulla VM, determina il tuo nome utente eseguendo questo comando:

   whoami
   

   Questo nome utente ti servirà in un secondo momento.

Ora puoi configurare l'app PuTTY in modo che utilizzi l'inoltro TCP IAP:

1. Apri l'app PuTTY e seleziona la categoria Connessione > Proxy.

2. Configura le seguenti impostazioni del proxy:

   • In Tipo di proxy, seleziona Locale.

   • Nel campo Comando Telnet o comando proxy locale, inserisci quanto segue:

     gcloud.cmd compute start-iap-tunnel %host %port --listen-on-stdin --project PROJECT_ID --zone ZONE
     

     Sostituisci quanto segue:

     • PROJECT_ID: ID del progetto in cui si trova l'istanza VM
     • ZONE: zona in cui si trova l'istanza VM

   • In Diagnostica del proxy di stampa nella finestra del terminale, seleziona Solo fino all'avvio della sessione.

3. Seleziona la categoria Connessione > SSH > Autorizzazione.

4. Fai clic su Sfoglia e incolla il seguente nome file, poi fai clic su Apri:

   %USERPROFILE%\.ssh\google_compute_engine.ppk
   

5. Seleziona la categoria Sessione.

6. Configura le seguenti impostazioni del proxy:

   • Inserisci quanto segue nel campo Nome host (o indirizzo IP):

     USERNAME@INSTANCE_NAME
     

     Sostituisci quanto segue:

     • USERNAME: il nome utente Linux che hai stabilito in precedenza
     • INSTANCE_NAME: il nome dell'istanza VM a cui vuoi connetterti

   • Sessioni salvate: inserisci un nome per la sessione.

7. Fai clic su Salva.

8. Fai clic su Apri per avviare la sessione SSH.

Nota: se l'app PuTTY mostra il messaggio proxy: - Invalid Credentials, le credenziali di gcloud CLI potrebbero essere scadute. Per aggiornare queste credenziali, apri un prompt dei comandi, esegui un comando come gcloud auth print-identity-token e inserisci di nuovo le credenziali.

ssh

Puoi usare direttamente il comando ssh con un'opzione ProxyCommand che utilizza gcloud per avviare il tunnel. Utilizza questo codice per generare il comando ssh completo:

gcloud compute ssh INSTANCE_NAME --dry-run

Connessioni RDP con tunneling

Puoi connetterti alle istanze Windows che non hanno un indirizzo IP esterno eseguendo il tunneling del traffico RDP tramite IAP:

Computer IAP

Puoi utilizzare IAP Desktop per connetterti al desktop remoto di una o più istanze VM utilizzando l'inoltro TCP di IAP.

1. Nell'applicazione, seleziona File > Aggiungi progetto Google Cloud.

2. Inserisci l'ID o il nome del progetto e fai clic su OK.

3. Nella finestra Esplora progetto, fai clic con il tasto destro del mouse sull'istanza VM a cui vuoi connetterti e seleziona Connetti.

Per maggiori informazioni su IAP per desktop, consulta la pagina del progetto GitHub.

Nota: IAP Desktop è un progetto open source e non è un prodotto Google supportato ufficialmente.

gcloud

Per connetterti al desktop remoto di un'istanza VM, devi prima creare un tunnel.

1. Utilizza il comando gcloud compute start-iap-tunnel per creare un tunnel criptato sulla porta RDP dell'istanza VM.

   gcloud compute start-iap-tunnel INSTANCE_NAME 3389 \
       --local-host-port=localhost:LOCAL_PORT \
       --zone=ZONE
   

   Sostituisci INSTANCE_NAME con il nome dell'istanza VM a cui vuoi connetterti. Sostituisci LOCAL_PORT con la porta localhost a cui vuoi associare il proxy oppure utilizza 0 per selezionarne automaticamente una non utilizzata. Sostituisci ZONE con la zona in cui si trova l'istanza VM.

2. gcloud esegue un test di connettività con l'istanza VM, quindi apre un tunnel e mostra il numero di porta.

   Listening on port [LOCAL_PORT].
   

   Tutto il traffico inviato a localhost:LOCAL_PORT viene inoltrato all'istanza VM. La porta è accessibile solo dalle applicazioni in esecuzione sul computer locale.

3. Lascia gcloud in esecuzione e apri l'app Connessione desktop remoto di Microsoft Windows.

4. Inserisci l'endpoint del tunnel come nome computer:

   localhost:LOCAL_PORT
   

   Sostituisci LOCAL_PORT con il numero di porta mostrato quando il tunnel è stato aperto da gcloud.

5. Fai clic su Connetti.

Nota: poiché stai indicando al client di connettersi a localhost anziché al nome dell'istanza VM, potresti visualizzare un avviso che indica che non è possibile verificare l'identità del computer remoto.

Tunnel di altre connessioni TCP

Puoi utilizzare l'inoltro TCP IAP per altri protocolli basati su TCP utilizzando il comando gcloud compute start-iap-tunnel per allocare una porta locale. La porta locale esegue il tunneling del traffico di dati dalla macchina locale alla macchina remota in un flusso HTTPS. IAP riceve i dati, applica i controlli dell'accesso e inoltra i dati di cui è stato eseguito il wrapping alla porta remota. Al contrario, viene eseguito il wrapping di tutti i dati della porta remota prima di essere inviati alla porta locale.

gcloud

Crea un tunnel criptato su una porta dell'istanza VM:

gcloud compute start-iap-tunnel INSTANCE_NAME INSTANCE_PORT \
    --local-host-port=localhost:LOCAL_PORT \
    --zone=ZONE

Sostituisci INSTANCE_NAME e INSTANCE_PORT con il nome e la porta dell'istanza VM a cui vuoi connetterti. Sostituisci LOCAL_PORT con la porta localhost a cui vuoi associare il proxy. Sostituisci ZONE con la zona in cui si trova l'istanza VM.

gcloud esegue un test di connettività con l'istanza VM, quindi apre un tunnel e mostra il numero di porta.

Listening on port [LOCAL_PORT].

Tutto il traffico inviato a localhost:LOCAL_PORT viene inoltrato all'istanza VM. La porta è accessibile solo dalle applicazioni in esecuzione sul computer locale.

Aumento della larghezza di banda di caricamento TCP IAP

Per aumentare la larghezza di banda in caricamento TCP IAP, valuta la possibilità di installare NumPy sulla stessa macchina in cui è installato gcloud CLI.

Linux

Nota: anche il simbolo $ iniziale nel primo comando fa parte del comando e non è il simbolo del prompt del terminale.

Per installare NumPy utilizzando pip nelle piattaforme Unix, esegui questo comando in una nuova istanza di terminale:

$(gcloud info --format="value(basic.python_location)") -m pip install numpy

Per ulteriori informazioni, consulta: NumPy.org

Se il messaggio di errore persiste dopo l'installazione di NumPy, completa il seguente passaggio: Esegui il comando seguente per consentire a gcloud di accedere a pacchetti esterni:

export CLOUDSDK_PYTHON_SITEPACKAGES=1

Nota: il comando export esporta soltanto per il terminale aperto corrente. Per rendere permanente questa modifica e in tutte le istanze del terminale, ti consigliamo di aggiungere il comando export al tuo file .bashrc.

Windows

Per installare NumPy utilizzando pip nelle piattaforme Windows, esegui questo comando in una nuova istanza di PowerShell:

start (gcloud info --format="value(basic.python_location)") "-m pip install numpy"

Per ulteriori informazioni, consulta: NumPy.org

Se il messaggio persiste dopo l'installazione di NumPy, è necessario eseguire un altro passaggio. Esegui questo comando per consentire a gcloud di accedere ai pacchetti esterni:

$env:CLOUDSDK_PYTHON_SITEPACKAGES="1"

Limitazioni note

Larghezza di banda: la funzionalità di inoltro TCP di IAP non è destinata al trasferimento collettivo di dati. IAP si riserva il diritto di limitare la frequenza degli utenti che abusano di questo servizio.

Durata della connessione: IAP disconnette automaticamente le sessioni dopo un'ora di inattività. Al momento gcloud compute start-iap-tunnel tenta di ristabilire il tunnel se viene disconnesso.

Passaggi successivi

• Imposta regole di contesto più complete applicando i livelli di accesso.
• Visualizza le richieste di accesso abilitando Cloud Audit Logs.
• Scopri di più su IAP.