Questa pagina è stata tradotta dall'API Cloud Translation.

Configurazione di Cloud IDS

Segui queste istruzioni per configurare Cloud IDS per la tua applicazione. Per informazioni concettuali su Cloud IDS, consulta la panoramica di Cloud IDS.

Prima di iniziare

Prima di configurare Cloud IDS, devi soddisfare i seguenti requisiti.

Configura le autorizzazioni IAM per Cloud IDS

Cloud IDS dispone di diversi ruoli Identity and Access Management (IAM). Puoi utilizzare i comandi di esempio per concedere a un entità le autorizzazioni IAM necessarie.

Ruolo Cloud IDS Admin (roles/ids.admin). I principali del progetto con questo ruolo possono creare endpoint IDS. Se sei un proprietario del progetto, disponi già di questa autorizzazione e non hai bisogno di un ruoloids.admin esplicito per creare endpoint IDS.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
   --role=roles/ids.admin \
   --member=user:USER_NAME ;
```
Questo ruolo consente le seguenti operazioni:
- Crea endpoint
- Elimina endpoint
- Ricevi endpoint
- Elenco endpoint
Ruolo Visualizzatore Cloud IDS (roles/ids.viewer). I visualizzatori e i principali del progetto con questo ruolo hanno accesso di sola lettura agli endpoint IDS. Se sei un proprietario, un editor o uno spettatore del progetto, disponi già di questa autorizzazione.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
   --role=roles/ids.viewer \
   --member=user:USER_NAME ;
```
Ruolo Utente di mirroring dei pacchetti di Compute (roles/compute.packetMirroringUser). Un ruolo necessario per collegare un criterio di mirroring dei pacchetti all'endpoint IDS. Se disponi del ruolo compute.securityAdmin o container.serviceAgent, hai già questa autorizzazione. Per ulteriori informazioni su questo ruolo, consulta la documentazione di riferimento dei ruoli IAM di base e predefiniti.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
   --role=roles/compute.packetMirroringUser \
   --member=user:USER_NAME ;
```
Ruolo Visualizzatore log (roles/logging.viewer). Un ruolo aggiuntivo necessario per visualizzare le minacce recenti, che è una funzionalità di base fondamentale di Cloud IDS. Per ulteriori informazioni su questo ruolo, consulta la guida al controllo dell'accesso.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
   --role=roles/logging.viewer \
   --member=user:USER_NAME ;
```

Inoltre, sono necessarie le seguenti autorizzazioni varie:

compute.regions.list
compute.zones.list

Configura l'accesso privato ai servizi

Per creare endpoint IDS, devi attivare l'API Service Networking e configurare il peering di rete per la rete Virtual Private Cloud (VPC). Questa operazione deve essere eseguita solo una volta per progetto del cliente e può essere eseguita utilizzando la console Google Cloud o Google Cloud CLI. Quando assegni un intervallo di indirizzi IP, deve essere un intervallo di indirizzi IP privato conforme a RFC 1918 (10.0.0.0/8,172.16.0.0/12 o 192.168.0.0/16), altrimenti la creazione dell'endpoint non va a buon fine.

Per configurare l'accesso privato ai servizi:

Abilita l'API Service Networking utilizzando il seguente comando. Sostituisci PROJECT_ID con l'ID del tuo progetto.
```
gcloud services enable servicenetworking.googleapis.com \
 --project=PROJECT_ID
```
Se non hai ancora allocato un intervallo di indirizzi IP nella tua rete, devi allocare un intervallo IP per i servizi Google nella rete VPC. Nel comando seguente, puoi omettere il campo addresses e Google Cloud seleziona un intervallo di indirizzi inutilizzato nella rete VPC:
```
gcloud compute addresses create RESERVED_RANGE_NAME \
  --global \
  --purpose=VPC_PEERING \
  --addresses=192.168.0.0 \
  --prefix-length=16 \
  --description="DESCRIPTION" \
  --network=VPC_NETWORK
```
Sostituisci quanto segue:
- RESERVED_RANGE_NAME: un nome per l'intervallo allocato, ad esempio my-allocated-range
- DESCRIPTION: una descrizione dell'intervallo, ad esempio allocated for my-service
- VPC_NETWORK: il nome della rete VPC, ad esempio my-vpc-network
Crea una connessione privata a un producer di servizi. La connessione privata stabilisce una connessione di peering della rete VPC tra la tua rete VPC e la rete del producer di servizi.

Se hai già una connessione privata esistente, utilizza il comando gcloud services vpc-peerings update per aggiornarla:
```
gcloud services vpc-peerings update \
  --service=servicenetworking.googleapis.com \
  --ranges=RESERVED_RANGE_NAME \
  --network=VPC_NETWORK \
  --project=PROJECT_ID
```
Se non hai già una connessione privata, utilizza il comando gcloud services vpc-peerings connect. Questo comando avvia un'operazione a lunga esecuzione che restituisce un nome dell'operazione.
```
gcloud services vpc-peerings connect \
  --service=servicenetworking.googleapis.com \
  --ranges=RESERVED_RANGE_NAME \
  --network=VPC_NETWORK \
  --project=PROJECT_ID
```
Sostituisci quanto segue:
- RESERVED_RANGE_NAME: il nome di uno o più intervalli allocati
- VPC_NETWORK: il nome della rete VPC
- PROJECT_ID: l'ID del progetto che contiene la tua rete VPC
Per verificare se l'operazione è riuscita, utilizza il comando gcloud services vpc-peerings operations describe:
```
gcloud services vpc-peerings operations describe \
    --name=OPERATION_NAME
```
Sostituisci OPERATION_NAME con il nome dell'operazione restituito dal passaggio precedente.

Ripeti i passaggi 2 e 3 per ogni rete VPC che vuoi monitorare.

(Facoltativo) Abilita i Controlli di servizio VPC

Dopo aver attivato l'accesso ai servizi privati, puoi attivare facoltativamente i Controlli di servizio VPC su Cloud IDS. Se abilitato, esegui il comando services vpc-peerings enable-vpc-service-controls per attivare i Controlli di servizio VPC per tutte le connessioni di peering:

gcloud services vpc-peerings enable-vpc-service-controls \
    --service=servicenetworking.googleapis.com \
    --network=VPC_NETWORK \
    --project=PROJECT_ID

Sostituisci quanto segue:

VPC_NETWORK: il nome della rete VPC
PROJECT_ID: l'ID del progetto che contiene la rete VPC

Crea un endpoint Cloud IDS

Ti consigliamo di creare un endpoint IDS per ogni regione in cui hai eseguito il deployment dei carichi di lavoro. Puoi anche creare più endpoint IDS per regione. Segui i passaggi riportati di seguito per creare un endpoint IDS e assegnargli un profilo del servizio IDS.

Console

Nella console Google Cloud, vai a Endpoint IDS.

Vai a Endpoint IDS

Configura l'endpoint:

Fai clic su Crea endpoint.
Inserisci un nome nel campo Nome endpoint.
(Facoltativo) Inserisci una descrizione nel campo Descrizione.
Fai clic sull'elenco a discesa Rete e seleziona la rete che vuoi che Cloud IDS esamini.
Scegli la regione e la zona della tua rete o sottorete dagli elenchi a discesa Regione e Zona.
Fai clic su Continua.

Seleziona il profilo di servizio Cloud IDS:

Fai clic su Seleziona profilo di servizio IDS.
In Livello di gravità minima delle minacce, seleziona il livello di avviso corretto.
Fai clic su Crea. Il processo di creazione può richiedere 10-15 minuti.

Dopo aver creato l'endpoint IDS, associa un criterio di Mirroring pacchetto all'endpoint IDS:

Seleziona la scheda Endpoint.
Accanto all'endpoint IDS, fai clic su Allega.
Nel campo Nome criterio, inserisci un nome per il criterio di Mirroring pacchetto.
Fai clic su Avanti.
Scegli la subnet o le istanze da sottoporre a mirroring. Puoi selezionare più sottoreti e istanze.
Fai clic su Avanti.
Decidi se vuoi eseguire il mirroring di tutto il traffico o filtrarlo:
1. Se vuoi eseguire il mirroring di tutto il traffico, assicurati che l'opzione Esegui il mirroring di tutto il traffico sia selezionata.
2. Se vuoi filtrare il traffico in base al protocollo, all'intervallo di indirizzi IP o al traffico in entrata o in uscita, seleziona Esegui il mirroring del traffico filtrato:
  1. Seleziona Consenti tutti i protocolli o Consenti protocolli specifici.
  2. Seleziona Consenti tutti gli intervalli IP o Consenti intervalli IP specifici.
Fai clic su Invia. L'endpoint è stato creato.

Ora puoi controllare se sono stati generati log delle minacce. I seguenti passaggi sono facoltativi:

Fai clic sulla scheda Minacce IDS.
Fai clic sul nome di una minaccia per visualizzare la pagina Dettagli sulla minaccia relativa.
Torna alla scheda Minacce.
Fai clic su Menu a destra dell'endpoint IDS e seleziona Visualizza log delle minacce.

gcloud

Flag facoltativi

I comandi in questa sezione potrebbero avere alcuni o tutti i seguenti parametri facoltativi:

--no-async

Attendi il completamento dell'operazione in corso anziché tornare immediatamente.

--filter=EXPRESSION

Applica un'ESPRESSIONE di filtro booleano a ogni elemento della risorsa da elencare. Se l'espressione restituisce True, l'elemento viene elencato. Per maggiori dettagli ed esempi di espressioni di filtro, esegui $ gcloud topic filters. Questo flag interagisce con altri flag che vengono applicati in questo ordine: --flatten, --sort-by, --filter, --limit.

--limit=LIMIT

Numero massimo di risorse da elencare. Il valore predefinito è illimitato. Questo flag interagisce con altri flag che vengono applicati in questo ordine: --flatten, --sort-by, --filter, --limit.

--page-size=PAGE_SIZE

L'output di un elenco di risorse dei gruppi Cloud IDS viene suddiviso in pagine. Questo flag specifica il numero massimo di risorse per pagina. Il valore predefinito è determinato dal servizio se supporta la paginazione; in caso contrario, è illimitato (nessuna paginazione). La paginazione può essere applicata prima o dopo --filter e --limit a seconda del servizio.

--sort-by=[FIELD,…]

Un elenco separato da virgole di nomi di chiavi di campo della risorsa in base ai quali ordinare. L'ordinamento predefinito è crescente. Anteponi un campo con "~" per l'ordinamento decrescente in quel campo. Questo flag interagisce con altri flag che vengono applicati in questo ordine: --flatten, --sort-by, --filter, --limit.

--uri

Stampa un elenco di URI delle risorse anziché l'output predefinito.

--threat-exceptions

Un elenco separato da virgole di ID minaccia da esentare dagli avvisi su questo endpoint. Limite di 99 eccezioni per endpoint.

Istruzioni

Per creare un nuovo endpoint IDS, svolgi i seguenti passaggi:

Utilizza il comando gcloud ids endpoints create. Sostituisci ENDPOINT_NAME, VPC_NETWORK, ZONE e SEVERITY con le informazioni corrispondenti alla tua applicazione.

gcloud ids endpoints create ENDPOINT_NAME \
  --network=VPC_NETWORK \
  --zone=ZONE \
  --severity=SEVERITY \
 [--no-async] \
 [GCLOUD_WIDE_FLAG...]

L'indicatore di gravità è obbligatorio e deve avere uno dei seguenti valori:
- INFORMATIVE
- BASSO
- MEDIO
- ALTO
- CRITICO
Dopo aver creato l'endpoint, collega un criterio di Mirroring pacchetto. Innanzitutto, ottieni l'URL dal campo endpoint_forwarding_rule utilizzando il seguente comando:
```
gcloud ids endpoints describe ENDPOINT_NAME
```

Crea il criterio di Mirroring pacchetto utilizzando il seguente comando:

gcloud compute packet-mirrorings create POLICY_NAME \
--region=REGION --collector-ilb=ENDPOINT_FORWARDING_RULE \
--network=VPC_NETWORK --mirrored-subnets=SUBNET

Mirroring pacchetto dispone di diversi flag facoltativi, tra cui quelli che puoi utilizzare per filtrare il traffico in base al protocollo, all'intervallo di indirizzi IP o al traffico in entrata o in uscita. Per ulteriori informazioni su questi flag facoltativi, consulta la documentazione di riferimento sul mirroring dei pacchetti.

Per eliminare un endpoint IDS, utilizza il comando gcloud ids endpoints delete. Sostituisci ENDPOINT_NAME, PROJECT_ID e ZONE con le informazioni corrispondenti alla tua applicazione:

gcloud ids endpoints delete ENDPOINT_NAME \
   [--project=PROJECT_ID] \
   [--zone=ZONE] \
   [--no-async] \
   [GCLOUD_WIDE_FLAG...]

Per descrivere un endpoint IDS, utilizza il comando gcloud ids endpoints describe. Sostituisci ENDPOINT_NAME, PROJECT_ID e ZONE con le informazioni corrispondenti alla tua applicazione:

gcloud ids endpoints describe ENDPOINT_NAME \
   [--project=PROJECT_ID] \
   [--zone=ZONE] \
   [GCLOUD_WIDE_FLAG...]

Per elencare gli endpoint IDS, utilizza il comando gcloud ids endpoints list:

gcloud ids endpoints list /
    [--filter=EXPRESSION] \
    [--limit=LIMIT] \
    [--page-size=PAGE_SIZE] \
    [--sort-by=[FIELD,...]] \
    [--uri] \
    [GCLOUD_WIDE_FLAG...]

API

Le risorse endpoint Cloud IDS hanno i seguenti campi:

Campo	Tipo	Descrizione del campo
createTime	string	[Solo output] Timestamp di creazione nel formato di testo RFC 3339.
updateTime	string	[Solo output] Timestamp dell'ultimo aggiornamento nel formato di testo RFC 3339.
nome	string	[Solo output] Nome dell'endpoint nel formato `projects/{project_id}/locations/{locationId}/endpoints/{endpointId}`.
e viceversa	string	Nome della rete VPC connessa all'endpoint IDS. Può contenere il nome della rete VPC stessa (ad esempio `"src-net"`) o l'URL completo della rete (ad esempio `"projects/{project_id}/global/networks/src-net"`). Questo campo è obbligatorio durante la creazione dell'endpoint.
gravità	string	Il livello di gravità dell'avviso minimo registrato dall'endpoint. I valori possibili sono: INFORMATIVE BASSO MEDIO ALTO CRITICO Questo campo è obbligatorio durante la creazione dell'endpoint.
description	string	Una descrizione facoltativa dell'endpoint.
endpoint_forwarding_rule	string	[Solo in uscita] URL dell'indirizzo di rete dell'endpoint a cui deve essere inviato il traffico tramite Mirroring pacchetto.
endpoint	string	[Solo output] Indirizzo IP interno del punto di contatto della rete dell'endpoint.

Per creare un endpoint Cloud IDS, utilizza una richiesta POST HTTP come la seguente, sostituendo le variabili come appropriato. ENDPOINT_NAME deve contenere da 1 a 63 caratteri, deve contenere solo lettere minuscole, cifre e trattini, deve iniziare con una lettera minuscola e non deve terminare con un trattino.

POST https://ids.googleapis.com/v1/projects/PROJECT_NAME/locations/ZONE/endpoints?endpointId=ENDPOINT_NAME
{
    "network": "NETWORK_NAME",
    "severity": "SEVERITY_LEVEL",
}

Per eliminare un endpoint Cloud IDS, utilizza una richiesta HTTP DELETE come la seguente, sostituendo le variabili come appropriato:

DELETE https://ids.googleapis.com/v1/projects/PROJECT_NAME/locations/ZONE/endpoints?endpointId=ENDPOINT_NAME

Per ottenere un endpoint Cloud IDS, utilizza una richiesta HTTP GET come la seguente, sostituendo le variabili come appropriato:

GET https://ids.googleapis.com/v1/projects/PROJECT_NAME/locations/ZONE/endpoints?endpointId=ENDPOINT_NAME

Per elencare tutti gli endpoint di Cloud IDS in una zona, utilizza una richiesta HTTP GET come la seguente, sostituendo le variabili come appropriato:

GET https://ids.googleapis.com/v1/projects/PROJECT_NAME/locations/ZONE/endpoints

In alternativa, per elencare tutti gli endpoint Cloud IDS in tutte le zone, puoi sostituire ZONE con un trattino come segue:

GET https://ids.googleapis.com/v1/projects/PROJECT_NAME/locations/-/endpoints

(Facoltativo) Configura le eccezioni alle minacce

Puoi disattivare gli ID minaccia che generano molti falsi positivi o che non sono necessari utilizzando il flag --threat-exceptions quando crei o aggiorni l'endpoint Cloud IDS. L'esempio seguente aggiorna un endpoint Cloud IDS esistenteENDPOINT_NAME per esentare gli ID minaccia THREAT_ID1 eTHREAT_ID2:

   gcloud ids endpoints update ENDPOINT_NAME 

      --threat-exceptions=THREAT_ID1,THREAT_ID2