Utilizzo di Controlli di servizio VPC con Apigee e Apigee hybrid

Questa pagina si applica ad Apigee e ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee si integra con i Controlli di servizio VPC, che ti consentono di isolare le risorse dei tuoi progetti Google Cloud. In questo modo, si evitano fughe/esfiltrazioni di dati.

Questa sezione descrive come utilizzare i Controlli di servizio VPC con Apigee.

Panoramica

I Controlli di servizio VPC definiscono un perimetro di servizio che funge da confine tra un progetto e altri servizi. I perimetri di servizio sono un metodo a livello di organizzazione per proteggere i servizi Google Cloud nei progetti, al fine di mitigare il rischio di esfiltrazione di dati.

I Controlli di servizio VPC possono anche garantire che i client all'interno di un perimetro che hanno accesso privato alle risorse non abbiano accesso a risorse non autorizzate all'esterno del perimetro.

Per un'analisi dettagliata dei vantaggi dei perimetri di servizio, consulta la panoramica dei Controlli di servizio VPC.

Quando utilizzi i Controlli di servizio VPC, tieni presente che:

  • Sia il progetto Google Cloud sia il runtime associato sono inclusi nel perimetro dei Controlli di servizio VPC del progetto.
  • L'interazione tra i servizi all'interno di un perimetro può essere limitata utilizzando la funzionalità Servizi accessibili dalla rete VPC.

Sia Apigee che Apigee hybrid si integrano con i Controlli di servizio VPC. Per un elenco completo dei prodotti che si integrano con i Controlli di servizio VPC, consulta Prodotti supportati.

Impatto sulla connettività a internet

Quando i Controlli di servizio VPC sono abilitati, l'accesso a internet è disabilitato: il runtime Apigee non comunicherà più con alcun target internet pubblico. Devi instradare il traffico al tuo VPC stabilendo route personalizzate. Consulta Importazione ed esportazione di route personalizzate.

Configurazione dei Controlli di servizio VPC con Apigee

La procedura generale per configurare i Controlli di servizio VPC con Apigee è la seguente:

  1. Abilita i Controlli di servizio VPC.
  2. Crea un nuovo perimetro di servizio.
  3. Configura il perimetro di servizio.

Questi passaggi sono descritti in dettaglio di seguito.

Per configurare i Controlli di servizio VPC con Apigee:

  1. Abilita i Controlli di servizio VPC per la connessione in peering dalla tua rete ad Apigee eseguendo il seguente comando:

    gcloud services vpc-peerings enable-vpc-service-controls \
      --network=SHARED_VPC_NETWORK --project=PROJECT_ID

    Dove:

    • SHARED_VPC_NETWORK è il nome della tua rete VPC condivisa.
    • PROJECT_ID è il nome del progetto che ospita la rete VPC condivisa; non è il progetto utilizzato per creare l'organizzazione Apigee.

    Questo comando attiva i Controlli di servizio VPC per il tuo progetto. Puoi eseguire questo comando più volte per abilitare i Controlli di servizio VPC per più progetti.

  2. Crea un nuovo perimetro come descritto nella guida rapida sui Controlli di servizio VPC. Quando crei un perimetro, scegli i progetti da aggiungere al suo interno e i servizi da proteggere.

    Per Apigee e Apigee hybrid, Google consiglia di proteggere tutti i servizi quando crei un perimetro, inclusa l'API Apigee.

    Per saperne di più, consulta Crea un perimetro di servizio.

  3. Configura il perimetro di servizio, come descritto in Dettagli e configurazione dei perimetri di servizio.

Per aggiungere un portale integrato all'interno del perimetro, consulta Aggiungi un portale integrato al perimetro.

Configurazione dei Controlli di servizio VPC con Apigee Hybrid

Apigee Hybrid supporta i Controlli di servizio VPC, ma devi eseguire alcuni passaggi aggiuntivi. La procedura generale per l'integrazione di Apigee Hybrid con i Controlli di servizio VPC è la seguente:

  1. Configura la connettività privata.
  2. Proteggi i servizi aggiuntivi all'interno del perimetro.
  3. Configura un repository privato. (Un repository privato è un repository che si trova all'interno del perimetro; non deve necessariamente essere un repository locale, purché si trovi all'interno del perimetro.)
  4. Esegui il push delle immagini Apigee nel tuo repository privato.
  5. Aggiorna gli override per utilizzare il repository privato durante il processo di installazione e configurazione di Hybrid.

Ciascuno di questi passaggi è descritto in dettaglio nella procedura seguente.

Per configurare i Controlli di servizio VPC con Apigee Hybrid:

  1. Configura gli indirizzi IP privati per gli host della tua rete ibrida, come descritto in Configura la connettività privata ad API e servizi Google. Ciò comporta la configurazione di route, regole firewall e voci DNS per consentire alle API di Google di accedere a questi IP privati.
  2. Segui i passaggi descritti in Configurazione dei Controlli di servizio VPC con Apigee.

    Durante questo processo, devi assicurarti di proteggere i seguenti servizi, oltre a quelli specificati per Apigee, all'interno del perimetro:

    • Anthos Service Mesh
    • Cloud Monitoring (Stackdriver)
    • Google Kubernetes Engine (se utilizzi GKE)
    • Google Container Registry (se lo utilizzi come repository locale)

    Per aggiungere questi servizi al perimetro, segui le istruzioni riportate in Dettagli e configurazione del perimetro di servizio.

  3. Copia le immagini Apigee nel tuo repository privato:
    1. Scarica le immagini Apigee firmate da Docker Hub come descritto qui. Assicurati di specificare i numeri di ultima versione.

      Ad esempio:

      docker pull google/apigee-installer:1.3.3
      docker pull google/apigee-authn-authz:1.3.3
      docker pull google/apigee-mart-server:1.3.3
      docker pull google/apigee-synchronizer:1.3.3
      docker pull google/apigee-runtime:1.3.3
      docker pull google/apigee-hybrid-cassandra-client:1.3.3
      docker pull google/apigee-hybrid-cassandra:1.3.3
      docker pull google/apigee-cassandra-backup-utility:1.3.3
      docker pull google/apigee-udca:1.3.3
      docker pull google/apigee-stackdriver-logging-agent:1.6.8
      docker pull google/apigee-prom-prometheus:v2.9.2
      docker pull google/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker pull google/apigee-connect-agent:1.3.3
      docker pull google/apigee-watcher:1.3.3
      docker pull google/apigee-operators:1.3.3
      docker pull google/apigee-kube-rbac-proxy:v0.4.1
    2. Tagga le immagini.

      L'esempio seguente aggiunge tag alle immagini in un repository GCR con sede negli Stati Uniti:

      docker tag google/apigee-installer:1.3.3 us.gcr.io/project_ID/apigee-installer:1.3.3
      docker tag google/apigee-authn-authz:1.3.3 us.gcr.io/project_ID/apigee-authn-authz:1.3.3
      docker tag google/apigee-mart-server:1.3.3 us.gcr.io/project_ID/apigee-mart-server:1.3.3
      docker tag google/apigee-synchronizer:1.3.3 us.gcr.io/project_ID/apigee-synchronizer:1.3.3
      docker tag google/apigee-runtime:1.3.3 us.gcr.io/project_ID/apigee-runtime:1.3.3
      docker tag google/apigee-hybrid-cassandra-client:1.3.3 us.gcr.io/project_ID/apigee-hybrid-cassandra-client:1.3.3
      docker tag google/apigee-hybrid-cassandra:1.3.3 us.gcr.io/project_ID/apigee-hybrid-cassandra:1.3.3
      docker tag google/apigee-cassandra-backup-utility:1.3.3 us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker tag google/apigee-udca:1.3.3 us.gcr.io/project_ID/apigee-udca:1.3.3
      docker tag google/apigee-stackdriver-logging-agent:1.6.8 us.gcr.io/project_ID/apigee-stackdriver-logging-agent:1.6.8
      docker tag google/apigee-prom-prometheus:v2.9.2 us.gcr.io/project_ID/apigee-prom-prometheus:v2.9.2
      docker tag google/apigee-stackdriver-prometheus-sidecar:0.7.5 us.gcr.io/project_ID/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker tag google/apigee-connect-agent:1.3.3 us.gcr.io/project_ID/apigee-connect-agent:1.3.3
      docker tag google/apigee-watcher:1.3.3 us.gcr.io/project_ID/apigee-watcher:1.3.3
      docker tag google/apigee-operators:1.3.3 us.gcr.io/project_ID/apigee-operators:1.3.3
      docker tag google/apigee-kube-rbac-proxy:v0.4.1 us.gcr.io/project_ID/apigee-kube-rbac-proxy:v0.4.1

      Anche se non è obbligatorio, Google consiglia di includere l'ID progetto o un altro valore identificativo nel percorso del repository per ogni immagine.

    3. Esegui il push delle immagini nel tuo repository privato.

      L'esempio seguente esegue il push delle immagini in un repository GCR con sede negli Stati Uniti:

      docker push us.gcr.io/project_ID/apigee-installer:1.3.3
      docker push us.gcr.io/project_ID/apigee-authn-authz:1.3.3
      docker push us.gcr.io/project_ID/apigee-mart-server:1.3.3
      docker push us.gcr.io/project_ID/apigee-synchronizer:1.3.3
      docker push us.gcr.io/project_ID/apigee-runtime:1.3.3
      docker push us.gcr.io/project_ID/apigee-hybrid-cassandra-client:1.3.3
      docker push us.gcr.io/project_ID/apigee-hybrid-cassandra:1.3.3
      docker push us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker push us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker push us.gcr.io/project_ID/apigee-udca:1.3.3
      docker push us.gcr.io/project_ID/apigee-stackdriver-logging-agent:1.6.8
      docker push us.gcr.io/project_ID/apigee-prom-prometheus:v2.9.2
      docker push us.gcr.io/project_ID/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker push us.gcr.io/project_ID/apigee-connect-agent1.3.3
      docker push us.gcr.io/project_ID/apigee-watcher1.3.3
      docker push us.gcr.io/project_ID/apigee-operators1.3.3
      docker push us.gcr.io/project_ID/apigee-kube-rbac-proxy:v0.4.1

      Anche se non è obbligatorio, Google consiglia di includere l'ID progetto o un altro valore identificativo nel percorso del repository per ogni immagine.

  4. Aggiorna il file degli override in modo che gli URL delle immagini puntino al tuo repository privato, come descritto in Specifica gli override della configurazione.

    Devi modificare gli URL delle immagini per i seguenti componenti:

    Nome del componente (nel file di override) URL immagine
    ao your_private_repo/apigee-operators
    authz your_private_repo/apigee-authn-authz
    cassandra your_private_repo/apigee-hybrid-cassandra

    auth: your_private_repo/apigee-hybrid-cassandra-client
    backup: your_private_repo/apigee-cassandra-backup-utility
    restore: your_private_repo/apigee-cassandra-backup-utility
    connectAgent your_private_repo/apigee-connect-agent
    installer your_private_repo/apigee-installer
    kubeRBACProxy your_private_repo/apigee-kube-rbac-proxy
    logger your_private_repo/apigee-stackdriver-logging-agent
    mart your_private_repo/apigee-mart-server
    metrics your_private_repo/apigee-prom-prometheus

    sdSidecar: your_private_repo/apigee-stackdriver-prometheus-sidecar
    runtime your_private_repo/apigee-runtime
    synchronizer your_private_repo/apigee-synchronizer
    udca your_private_repo/apigee-udca

    fluentd: your_private_repo/apigee-stackdriver-logging-agent
    watcher your_private_repo/apigee-watcher

  5. Applica le modifiche utilizzando le nuove immagini in GCR, come descritto in Applica la configurazione al cluster.

Progetti Private Service Connect e confini del perimetro

Se utilizzi i Controlli di servizio VPC insieme a Private Service Connect, il progetto Google Cloud all'estremità della connessione Private Service Connect deve essere raggiungibile dallo stesso perimetro di servizio del tuo progetto Apigee.

A partire dal 15 gennaio 2027, Apigee valuta il progetto in peering come una risorsa protetta aggiuntiva per le operazioni nell'elenco seguente. Se il tuo progetto Apigee si trova all'interno di un perimetro di servizio e il progetto in peering si trova all'esterno, queste operazioni restituiscono PERMISSION_DENIED.

Operazioni interessate

Questo requisito influisce solo sulle seguenti operazioni del control plane:

Controlla se il problema ti riguarda

  1. Determina se il tuo progetto Apigee appartiene a un perimetro di servizio che limita apigee.googleapis.com. Consulta Gestione dei perimetri di servizio.
  2. Elenca i progetti in peering che utilizzi con Private Service Connect:
    • Per le connessioni in entrata, i progetti nell'elenco di accettazione dei consumer di ogni istanza.
    • Per le connessioni in uscita, il progetto proprietario del collegamento al servizio denominato da ogni collegamento all'endpoint.
  3. Per ogni progetto in peering, controlla se è protetto dallo stesso perimetro del tuo progetto Apigee.

Se ogni progetto in peering si trova nello stesso perimetro, non è necessario alcun intervento.

Risolvi un progetto peer all'esterno del perimetro

Scegli l'opzione che corrisponde ai tuoi requisiti di sicurezza:

  • Aggiungi il progetto in peering al perimetro. Utilizza questa opzione quando entrambi i progetti appartengono allo stesso confine di attendibilità. Consulta Gestione dei perimetri di servizio.
  • Consenti l'accesso con una regola in entrata o in uscita. Utilizza questa opzione se i progetti devono rimanere in perimetri separati. Consulta Regole in entrata e in uscita.
  • Rimuovi il riferimento tra perimetri. Rimuovi il progetto dalla lista consentita dei consumer o elimina il collegamento all'endpoint che punta all'esterno del perimetro.

Prima di modificare un perimetro, puoi utilizzare la modalità dry run per vedere l'effetto della modifica senza applicarla.

Concessione dell'accesso ai portali integrati al perimetro

VPC-SC supporta la concessione di livelli di accesso VPC-SC ai portali integrati, ma questo processo richiede passaggi aggiuntivi, come descritto in questa sezione.

Se non concedi un livello di accesso ai portali integrati, questi non saranno disponibili per le organizzazioni Apigee abilitate per i Controlli di servizio VPC.

Concessione di un livello di accesso ai portali:

  • Non inserisce i portali integrati all'interno del perimetro.
  • Consente l'accesso ai portali integrati dall'esterno del perimetro.
  • Consente l'esposizione dei dati Apigee protetti da VPC-SC (ad esempio i dati delle applicazioni) agli utenti del portale all'esterno del perimetro VPC-SC.

Per saperne di più, consulta Consenti l'accesso alle risorse protette dall'esterno di un perimetro.

Prerequisiti

Prima di concedere l'accesso al perimetro a un portale integrato, devi attivare l'Access Context Manager API per il tuo progetto, se non è già attivata. Puoi farlo nella console Cloud o utilizzando il comando gcloud services enable.

Per verificare se l'API è abilitata, esamina l'output del comando gcloud services list, come descritto nel Passaggio 2: abilita le API Apigee.

Inoltre, devi avere l'indirizzo email del account di servizio per il progetto in cui viene utilizzato il portale. Per farlo, devi avere l'ID progetto e il numero di progetto Google Cloud. I passaggi seguenti descrivono come ottenere questi valori:

  1. Recupera i dettagli del progetto Google Cloud utilizzando il comando gcloud projects list, come mostrato nell'esempio seguente:
    gcloud projects list

    Questo comando restituisce l'ID progetto (nella colonna PROJECT_ID) e il numero di progetto (nella colonna PROJECT_NUMBER) per ogni progetto della tua organizzazione GCP.

  2. Identifica l'indirizzo email del account di servizio Apigee. Questo è lo stesso account creato dal programma di installazione di Apigee durante il provisioning dell'organizzazione nel Passaggio 3: crea un'organizzazione.

    Per ottenere questo indirizzo email, utilizza il comando iam service-accounts list, che utilizza la seguente sintassi:

    gcloud iam service-accounts list --project GCP_PROJECT_ID

    Ad esempio:

    gcloud iam service-accounts list --project my-project
    
    DISPLAY NAME                              EMAIL                                                DISABLED
    Apigee default service account            service-8675309@gcp-sa-apigee.  False
    Compute Engine default service account     8675309-compute@          False

    Il account di servizio che ti interessa è quello il cui indirizzo email corrisponde al seguente formato:
    service-GCP_PROJECT_NUMBER@gcp-sa-apigee.

    Ad esempio:
    service-8675309@gcp-sa-apigee.

  3. Recupera l'ID della policy (o del perimetro) utilizzando il comando access-context-manager policies list. Passa l'ID organizzazione a questo comando, come mostrato nell'esempio seguente:

    gcloud access-context-manager policies list --organization=organizations/GCP_ORG_ID

    gcloud risponde con un elenco di policy associate all'organizzazione specificata, ad esempio:

    gcloud access-context-manager policies list --organization=organizations/2244340
    
    NAME          ORGANIZATION      TITLE                 ETAG
    04081981      2244340           Default policy        421924c5a97c0Icu8

    L'ID policy di VPC-SC (noto anche come ID perimetro) è l'ID del perimetro di servizio VPC-SC che funge da confine tra il tuo progetto e altri servizi. È il valore nella colonna NAME.

Passaggi per concedere l'accesso al perimetro ai portali integrati

Per concedere l'accesso perimetrale a un portale integrato:

  1. Raccogli l'indirizzo email del account di servizio e l'ID policy di VPC-SC, come descritto in Prerequsites.
  2. Crea un file delle condizioni sulla tua macchina di amministrazione che specifichi l'indirizzo del account di servizio che concederà l'accesso al portale tramite il perimetro.

    Il file può avere qualsiasi nome, ma deve avere l'estensione *.yaml. Ad esempio: my-portal-access-rules.yaml.

  3. Nel file delle condizioni, aggiungi una sezione members che specifica il service account Apigee, come mostrato nell'esempio seguente:

    - members:
      - serviceAccount:service-8675309@gcp-sa-apigee.

    Tieni presente che è sufficiente aggiungere una sezione members; non è necessario aggiungere una sezione per il livello di accesso. Per saperne di più sulla creazione di un file di condizioni, consulta Limita l'accesso per utente o service account.

  4. Crea un livello di accesso con il comando access-context-manager levels create, ad esempio:
    gcloud access-context-manager levels create ACCESS_LEVEL_ID \
      --title ACCESS_LEVEL_TITLE \
      --basic-level-spec PATH/TO/CONDITIONS_FILE.yaml \
      --policy=POLICY_ID

    Dove:

    • ACCESS_LEVEL_ID è un identificatore del nuovo livello di accesso che viene concesso, ad esempio my-portal-access-level.
    • ACCESS_LEVEL_TITLE è un titolo per il livello di accesso. Il titolo può essere qualsiasi cosa tu voglia, ma Google consiglia di assegnargli un valore significativo in modo che tu e gli altri amministratori sappiate a cosa si applica. Ad esempio, Livello di accesso al mio portale.
    • CONDITIONS_FILE è il percorso del file YAML creato nel passaggio precedente.
    • POLICY_ID è l'ID della policy o del perimetro.

    Ad esempio:

    gcloud access-context-manager levels create my-portal-access-level \
      --title My Portal Access Level \
      --basic-level-spec ~/my-portal-access-rules.yaml \
      --policy=04081981
  5. Aggiorna il perimetro con il nuovo livello di accesso utilizzando il comando access-context-manager perimeters update:
    gcloud access-context-manager perimeters update POLICY_ID \
      --add-access-levels=ACCESS_LEVEL_ID \
      --policy=POLICY_ID

    Ad esempio:

    gcloud access-context-manager perimeters update 04081981 \
      --add-access-levels=my-portal-access-level \
      --policy=04081981

Risoluzione dei problemi

Verifica quanto segue:

  • Se l'API Access Context Manager non è abilitata per il tuo progetto Google Cloud, gcloud ti chiede di abilitarla quando provi a elencare o impostare le policy.
  • Assicurati di utilizzare l'ID organizzazione Google Cloud e non l'ID organizzazione Apigee quando ottieni i dettagli sull'organizzazione.
  • Alcuni comandi descritti in questa sezione richiedono autorizzazioni elevate. Ad esempio, per ottenere dettagli sui service account di un progetto, devi essere un proprietario del progetto.
  • Per verificare che il account di servizio esista, esegui il comando iam service-accounts describe, come mostrato nell'esempio seguente:

    gcloud iam service-accounts describe service-8675309@gcp-sa-apigee.

    gcloud risponde con informazioni sul account di servizio, tra cui il nome visualizzato e l'ID progetto a cui appartiene. Se il account di servizio non esiste, gcloud risponde con un errore NOT_FOUND.

Limitazioni

Le integrazioni di Apigee con i Controlli di servizio VPC presentano le seguenti limitazioni:

  • I portali integrati richiedono passaggi aggiuntivi per la configurazione.
  • Devi eseguire il deployment dei portali Drupal all'interno del perimetro di servizio.