Utilizza l'autenticazione MD5
Il router Cloud utilizza il protocollo BGP (Border Gateway Protocol) per scambiare le route tra una rete Virtual Private Cloud (VPC) e una rete peer. Per impostazione predefinita, le sessioni BGP del router Cloud non sono autenticate. Tuttavia, quando utilizzi il router Cloud con determinati prodotti, puoi facoltativamente e configurare le sessioni BGP da utilizzare per l'autenticazione MD5.
I prodotti che possono utilizzare l'autenticazione MD5 includono quanto segue:
Puoi anche utilizzare l'autenticazione MD5 con appliance virtuali di rete di terze parti. Per ulteriori informazioni, consulta Appliance router nella documentazione di Network Connectivity Center.
Quando configuri una sessione per utilizzare l'autenticazione MD5, devi fornire un secret chiave condivisa: una chiave che utilizzi durante la configurazione del router Cloud e quando configuri il router peer. Dopo completare i passaggi di configurazione richiesti, il router Cloud utilizza questa chiave per l'autenticazione il peer BGP. Il router Cloud applica l'autenticazione MD5 utilizzando il modello descritto in RFC 2385.
Puoi aggiungere l'autenticazione MD5 quando crei un peer. Puoi anche aggiungere l'autenticazione a una sessione esistente, cambiare la chiave utilizzata da una sessione, o rimuovere l'autenticazione.
Prima di iniziare
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Se utilizzi Google Cloud CLI, imposta l'ID progetto eseguendo il seguente comando.
gcloud
le istruzioni riportate in questa pagina presuppongono che l'ID progetto sia stato impostato.gcloud config set project PROJECT_ID
-
Verifica che l'ID sia stato impostato eseguendo questo comando:
gcloud config list --format='text(core.project)'
Creare una sessione che utilizza l'autenticazione
Per alcuni prodotti per la connettività di rete, puoi configurare un peer BGP utilizza l'autenticazione MD5 durante la creazione della risorsa. Questi prodotti includono VPN ad alta disponibilità e Dedicated Interconnect.
Per ulteriori informazioni, consulta le seguenti sezioni:
- Crea un tunnel VPN ad alta disponibilità connesso a un gateway VPN peer
- Crea un tunnel VPN ad alta disponibilità tra le reti Google Cloud
- Creare collegamenti VLAN (Dedicated Interconnect)
Se stai creando un collegamento VLAN per l'interconnessione con partner di livello 2, crea prima il collegamento e poi aggiorna il peer BGP per aggiungere l'autenticazione MD5. Per informazioni su come aggiungere l'autenticazione durante l'aggiornamento di una sessione BGP, vedi quanto segue . Se hai una connessione di livello 3, contatta il tuo provider di servizi per istruzioni.
Aggiungere l'autenticazione a una sessione esistente
Per aggiungere l'autenticazione a un peer BGP esistente, utilizza una delle le seguenti procedure. Quando aggiungi l'autenticazione, assicurati che la chiave che usi è identico a quello usato dal router peer.
Google Cloud non mostra la chiave di autenticazione MD5 e solo mostrano il nome della chiave al termine della configurazione.
- Se configuri l'autenticazione MD5 tramite gcloud o UI, Google Cloud
genera automaticamente il nome della chiave sotto forma di
PEER_NAME-key
. - Se configuri l'autenticazione MD5 tramite API, puoi specificare il nome della chiave.
Console
Nella console Google Cloud, vai alla pagina Router Cloud.
Nel campo Nome, fai clic sul nome del router Cloud appropriato.
Nella pagina Dettagli router, fai clic sul nome della sessione BGP che si desidera modificare.
Nella pagina Dettagli sessione BGP, fai clic su
Modifica.Per aggiungere l'autenticazione MD5:
- Nella sezione Autenticazione MD5, seleziona Attivata. La pagina per includere un campo di testo.
- Inserisci un token di sicurezza oppure fai clic su Genera e copia per generare un nuovo token di sicurezza.
- Prendi nota della chiave. Dopo aver lasciato questa pagina, non puoi recuperare la chiave.
Fai clic su Salva.
gcloud
Per aggiornare la sessione con gcloud CLI, utilizza
Comando gcloud compute routers update-bgp-peer
:
gcloud compute routers update-bgp-peer ROUTER_NAME \ --peer-name=PEER_NAME \ --region=REGION \ --md5-authentication-key=SECRET_KEY
Sostituisci i seguenti valori:
ROUTER_NAME
: il nome del router CloudPEER_NAME
: il nome del peer BGPREGION
: la regione Google CloudSECRET_KEY
: il tuo secret condiviso l'autenticazione MD5 chiave
API
Per aggiornare la sessione utilizzando l'API, utilizza il metodo
compute.routers.patch
. Quando utilizzi questo metodo per aggiungere l'autenticazione alla sessione, la richiesta deve fare due cose:
- Aggiungi una voce per la chiave nell'array
md5AuthenticationKeys
. Quando aggiungi la voce, fornisci sia un nome che un valore per la chiave. - Aggiorna l'array
bgpPeers
in modo da includere un valore per il parametromd5AuthenticationKeyName
. Questo campo fa riferimento alla chiave per nome.
Quando applichi la patch all'array md5AuthenticationKeys
, devi fornire il valore name
di ogni elemento dell'array (a meno che non vogliate rimuoverne alcuni).
Tuttavia, non è necessario specificare il valore per il campo key
di ogni elemento.
Se ometti questo valore, il router Cloud conserva il valore precedente che
è stato utilizzato. Questo comportamento è stato progettato per proteggere la segretezza delle chiavi.
È diverso dagli altri metodi di patch, che in genere richiedono di specificare un valore per ogni campo di un elemento dell'array.
Quando applichi la patch all'array bgpPeers
, devi fornire i valori
per ogni campo di ogni elemento (a meno che tu non voglia rimuovere alcuni peer o alcuni
).
Ad esempio, supponiamo che il router Cloud abbia due peer, uno che utilizza l'autenticazione MD5 e uno che non la utilizza. Se vuoi abbandonare la prima peer invariato, ma aggiungi l'autenticazione MD5 al secondo peer, useresti un come la seguente:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "md5AuthenticationKeys": [ { "name": "KEY_NAME_1", }, { "name": "KEY_NAME_2", "key": "SECRET_KEY" } ], "bgpPeers": [ { "name": "PEER_NAME_1", "md5AuthenticationKeyName": "KEY_NAME_1", "interfaceName": "INTERFACE_NAME_1", "ipAddress": "IP_ADDRESS_1", "peerIpAddress": "PEER_IP_ADDRESS_1", "peerAsn": "PEER_ASN_1" }, { "name": "PEER_NAME_2", "md5AuthenticationKeyName": "KEY_NAME_2", "interfaceName": "INTERFACE_NAME_2", "ipAddress": "IP_ADDRESS_2", "peerIpAddress": "PEER_IP_ADDRESS_2", "peerAsn": "PEER_ASN_2" } ], }
Sostituisci i seguenti valori:
PROJECT_ID
: il progetto che contiene Router CloudREGION
: la regione Google CloudROUTER_NAME
: il nome del router CloudKEY_NAME_1
: il nome della chiave attualmente in uso (daPEER_NAME_1
)KEY_NAME_2
: il nome della nuova chiave che vuoi aggiungi perPEER_NAME_2
. Prendi nota del nome. Se vuoi apportare modifiche in un secondo momento utilizzando l'API, ti servirà il nome.SECRET_KEY
: la tua chiave di autenticazione MD5 segreta che che stai aggiungendo perPEER_NAME_2
PEER_NAME_1
: il nome del peer BGP che sei senza modificaINTERFACE_NAME_1
: il nome dell'interfaccia per il BGP sessione di peering che rimane invariataIP_ADDRESS_1
: l'indirizzo IP sul router Cloud (per il peer che non cambia)PEER_IP_ADDRESS_1
: l'indirizzo IP del peer che non cambiaPEER_ASN_1
: il numero di sistema autonomo (ASN) BGP per il peer che non cambiaPEER_NAME_2
: il nome del peer BGP che vuoi l'aggiornamento in modo che utilizzi l'autenticazione MD5INTERFACE_NAME_2
: il nome dell'interfaccia per il BGP sessione di peeringIP_ADDRESS_2
: l'indirizzo IP sul router CloudPEER_IP_ADDRESS_2
: l'indirizzo IP del router peerPEER_ASN_2
: il numero di sistema autonomo (ASN) BGP per questo peer BGP
Aggiorna la chiave di autenticazione
Per modificare la chiave utilizzata da Cloud Router per una sessione di peering, utilizza una delle seguenti procedure. Quando aggiorni la chiave router Cloud, assicurati che la chiave che utilizzi sia identica a quella utilizzata il router peer.
Google Cloud non mostra la chiave di autenticazione MD5 e solo mostrano il nome della chiave al termine della configurazione.
- Se configuri l'autenticazione MD5 tramite gcloud o UI, Google Cloud
genera automaticamente il nome della chiave sotto forma di
PEER_NAME-key
. - Se configuri l'autenticazione MD5 tramite API, puoi specificare il nome della chiave.
Console
Nella console Google Cloud, vai alla pagina Router Cloud.
Nel campo Nome, fai clic sul nome del Cloud Router appropriato.
Nella pagina Dettagli router, fai clic sul nome della sessione BGP che desideri modificare.
Nella pagina Dettagli sessione BGP, fai clic su
Modifica.Nella sezione Autenticazione MD5, fai clic su Aggiorna la chiave di autenticazione MD5.
Nel campo Chiave di autenticazione MD5, inserisci il nuovo secret di autenticazione o, per compilare il campo, fai clic su Genera e copia.
Prendi nota della chiave. Dopo aver abbandonato la pagina, non puoi recuperare la chiave.
Fai clic su Salva.
gcloud
Per aggiornare la sessione, utilizza
gcloud compute routers update-bgp-peer
.
gcloud compute routers update-bgp-peer ROUTER_NAME \ --peer-name=PEER_NAME \ --region=REGION \ --md5-authentication-key=SECRET_KEY
Sostituisci i seguenti valori:
ROUTER_NAME
: il nome del router CloudPEER_NAME
: il nome del peer BGPREGION
: la regione Google CloudSECRET_KEY
: la nuova chiave di autenticazione segreta MD5 che vuoi utilizzare
API
Per aggiornare la sessione, utilizza
compute.routers.patch
. Ad esempio, utilizza una richiesta come la seguente.
Questo esempio sostituisce l'intero array di app peer, non solo quello specifico
identificato. Ciò significa che rimuove tutti i peer tranne
PEER_NAME
. Rimuove tutte le chiavi tranne
KEY_NAME
e aggiorna KEY_NAME
con
il nuovo valore UPDATED_SECRET_KEY
.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "md5AuthenticationKeys": [ { "name": "KEY_NAME", "key": "UPDATED_SECRET_KEY" } ], "bgpPeers": [ { "name": "PEER_NAME", "md5AuthenticationKeyName": "KEY_NAME", "interfaceName": "INTERFACE_NAME", "ipAddress": "IP_ADDRESS", "peerIpAddress": "PEER_IP_ADDRESS", "peerAsn": "PEER_ASN" } ], }
Sostituisci i seguenti valori:
PROJECT_ID
: il progetto che contiene Router CloudREGION
: la regione Google CloudROUTER_NAME
: il nome del router CloudKEY_NAME
: il nome della chiave che vuoi aggiornare. Ogni volta che utilizzi l'autenticazione MD5 tramite l'API, devi fare riferimento alla chiave tramite il nomeUPDATED_SECRET_KEY
: la tua nuova chiave di autenticazione MD5 segretaPEER_NAME
: il nome del peer BGPINTERFACE_NAME
: il nome dell'interfaccia per il BGP sessione di peeringIP_ADDRESS
: l'indirizzo IP sul router CloudPEER_IP_ADDRESS
: l'indirizzo IP del router peerPEER_ASN
: il numero di sistema autonomo (ASN) BGP per questo peer BGP
Controllare lo stato dell'autenticazione
Per controllare lo stato dell'autenticazione MD5, segui questi passaggi. Consulta anche Visualizzare i dettagli del router Cloud.
Console
Nella console Google Cloud, vai alla pagina Router Cloud.
Nel campo Nome, fai clic sul nome del router Cloud appropriato.
Nella pagina Dettagli router, cerca Autenticazione MD5. colonna. Per ogni sessione, il valore in questa colonna indica se l'autenticazione MD5 è attivata.
gcloud
Per controllare la sessione con gcloud CLI, utilizza il comando
Comando gcloud compute routers get-status
.
gcloud compute routers get-status ROUTER_NAME \ --project=PROJECT \ --region=REGION \
Sostituisci i seguenti valori:
ROUTER_NAME
: il nome del router CloudPROJECT
: il nome del progettoREGION
: la regione Google Cloud
L'output include l'oggetto result.bgpPeerStatus[]
, che contiene informazioni sulle sessioni BGP del router Cloud. La
su ogni sessione includono i seguenti due campi:
md5AuthEnabled
: un campo booleano che indica se MD5 l'autenticazione sia abilitata per la sessionestatusReason
: un campo che descrive lo stato della sessione
API
Utilizza la
routers.getRouterStatus
:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus
Sostituisci quanto segue:
PROJECT_ID
: il progetto che contiene Router CloudREGION
: la regione in cui si trova il router Cloud localizzatoROUTER_NAME
: il nome del router Cloud
L'output include informazioni su ogni sessione BGP. I dati relativi a ciascun sessione include i seguenti due campi:
md5AuthEnabled
: un campo booleano che indica se l'autenticazione MD5 è attivata per la sessionestatusReason
: un campo che descrive lo stato della sessione. Questo viene visualizzato solo quando si verifica un problema con l'autenticazione MD5. In questo caso, il valore del campo èMD5_AUTH_INTERNAL_PROBLEM
.
Per configurare il monitoraggio continuo delle sessioni BGP, utilizza Cloud Logging. Logging registra informazioni sullo stato dell'autenticazione MD5 in l'evento BGP, che fa parte Log informativo.
Rimuovere l'autenticazione da una sessione
Se vuoi rimuovere l'autenticazione MD5 da una sessione BGP, devi rimuovere Autenticazione MD5 sia dal router Cloud che dal peer o eseguire il provisioning di un router.
Per rimuovere l'autenticazione MD5 dalla sessione BGP sul router Cloud, utilizza una delle seguenti procedure.
Console
Nella console Google Cloud, vai alla pagina Router Cloud.
Nel campo Nome, fai clic sul nome del router Cloud appropriato.
Nella pagina Dettagli router, fai clic sul nome della sessione BGP che desideri modificare.
Nella pagina Dettagli sessione BGP, fai clic su
Modifica.Per Autenticazione MD5, fai clic su Disattivata.
Fai clic su Salva. Viene visualizzata la finestra di dialogo Disattiva chiave di autenticazione MD5.
Nella finestra di dialogo di conferma, fai clic su Conferma.
gcloud
Per rimuovere l'autenticazione MD5, utilizza la
Comando gcloud compute routers update-bgp-peer
:
gcloud compute routers update-bgp-peer ROUTER_NAME \ --peer-name=PEER_NAME \ --region=REGION \ --clear-md5-authentication-key
Sostituisci i seguenti valori:
ROUTER_NAME
: il nome del router CloudPEER_NAME
: il nome del peer BGPREGION
: la regione Google Cloud
API
Per rimuovere l'autenticazione MD5, utilizza la
compute.routers.patch
.
Quando rimuovi l'autenticazione utilizzando l'API, l'aggiornamento deve fare due cose:
- Aggiorna l'array
md5AuthenticationKeys
- Rimuovi il valore
md5AuthenticationKey
dalla vocebgpPeers
pertinente
Ad esempio, se il router Cloud ha due peer BGP e vuoi rimuovere l'autenticazione MD5 da uno di questi. In questo caso, utilizza una richiesta come le seguenti:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "md5AuthenticationKeys": [ "name": "KEY_NAME_FOR_UNCHANGED_PEER", ], "bgpPeers": [ { "name": "NAME_OF_UPDATED_PEER", "interfaceName": "INTERFACE_NAME_FOR_UPDATED_PEER", "ipAddress": "IP_ADDRESS_FOR_UPDATED_PEER", "peerIpAddress": "PEER_IP_ADDRESS_FOR_UPDATED_PEER", "peerAsn": "PEER_ASN_FOR_UPDATED_PEER" }, { "name": "NAME_OF_UNCHANGED_PEER", "interfaceName": "INTERFACE_NAME_FOR_UNCHANGED_PEER", "ipAddress": "IP_ADDRESS_FOR_UNCHANGED_PEER", "peerIpAddress": "PEER_IP_ADDRESS_FOR_UNCHANGED_PEER", "peerAsn": "PEER_ASN_FOR_UNCHANGED_PEER" "md5AuthenticationKeyName": "KEY_NAME_FOR_UNCHANGED_PEER" } ], ], }
Sostituisci i seguenti valori:
PROJECT_ID
: il progetto che contiene Router CloudREGION
: la regione Google Cloud in cui Il router Cloud si trovaROUTER_NAME
: il nome del router CloudNAME_OF_UPDATED_PEER
: il nome del peering sessione che desideri modificareINTERFACE_NAME_FOR_UPDATED_PEER
: il nome del per il peer BGP che vuoi modificareIP_ADDRESS_FOR_UPDATED_PEER
: l'indirizzo IP sul Router Cloud utilizzato dal peer che vuoi modificarePEER_IP_ADDRESS_FOR_UPDATED_PEER
: l'indirizzo IP di il router peer per la sessione di peering che vuoi modificarePEER_ASN
: il numero di sistema autonomo (ASN) BGP Per questo peer BGP vuoi modificareNAME_OF_UNCHANGED_PEER
: il nome del peering sessione che vuoi mantenere invariataINTERFACE_NAME_FOR_UNCHANGED_PEER
: il nome del per il peer BGP che vuoi mantenere invariatoIP_ADDRESS_FOR_UNCHANGED_PEER
: l'indirizzo IP sul router Cloud utilizzato dal peer che vuoi mantenere invariatoPEER_IP_ADDRESS_FOR_UNCHANGED_PEER
: l'indirizzo IP di il router peer per la sessione di peering che vuoi mantenere invariatoPEER_ASN_FOR_UNCHANGED_PEER
: il sistema autonomo BGP numero (ASN) per il peer BGP che vuoi mantenere invariatoKEY_NAME_FOR_UNCHANGED_PEER
: il nome del Chiave di autenticazione MD5 per il peer BGP a cui vuoi mantenere invariato
Rimuovere una sessione che utilizza l'autenticazione
Per rimuovere una sessione di peering che utilizza l'autenticazione MD5, utilizza una delle le seguenti procedure.
Console
Nella console Google Cloud, vai alla pagina Router Cloud.
- Seleziona il router da cui vuoi rimuovere una sessione BGP.
- Per le sessioni BGP, seleziona la sessione BGP che vuoi rimuovere.
- Nella parte superiore della pagina, fai clic su Elimina, e confermare l'eliminazione.
gcloud
Per rimuovere una sessione BGP con l'autenticazione MD5 abilitata, utilizza la
Comando gcloud compute routers remove-bgp-peer
.
Per ulteriori informazioni, vedi Disattivare o rimuovere le sessioni BGP.
API
Per rimuovere una sessione BGP con l'autenticazione MD5 abilitata, utilizza il metodo
compute.routers.patch
.
Quando rimuovi una sessione BGP con autenticazione MD5 utilizzando l'API, l'aggiornamento deve fare due cose: rimuovere la chiave dall'array md5AuthenticationKeys
e rimuovere bgpPeer
stesso.
Ad esempio, supponiamo che il router Cloud abbia due peer e che tu voglia rimuovere uno di questi. In questo caso, utilizza una richiesta simile alla seguente:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME { "md5AuthenticationKeys": [ "name": "KEY_NAME_FOR_RETAINED_PEER", ], "bgpPeers": [ { "name": "NAME_OF_RETAINED_PEER", "interfaceName": "INTERFACE_FOR_RETAINED_PEER", "ipAddress": "IP_ADDRESS_FOR_RETAINED_PEER", "peerIpAddress": "PEER_IP_ADDRESS_FOR_RETAINED_PEER", "peerAsn": "PEER_ASN_FOR_RETAINED_PEER", "md5AuthenticationKeyName": "KEY_NAME_FOR_RETAINED_PEER" } ], }
Sostituisci i seguenti valori:
PROJECT_ID
: il progetto che contiene Router CloudREGION
: la regione Google CloudROUTER_NAME
: il nome del router CloudKEY_NAME_FOR_RETAINED_PEER
: nome della chiave utilizzata dal peer che conserviNAME_OF_RETAINED_PEER
: il nome del peer BGP che stai mantenendoINTERFACE_FOR_RETAINED_PEER
: il nome dell'interfaccia per il peer BGP che mantieniIP_ADDRESS_FOR_RETAINED_PEER
: l'indirizzo IP sul Router Cloud per il peer che mantieniPEER_IP_ADDRESS_FOR_RETAINED_PEER
: l'indirizzo IP del peer che stai conservandoPEER_ASN_FOR_RETAINED_PEER
: il numero di sistema autonomo BGP (ASN) per il peer che vuoi conservareKEY_NAME_FOR_RETAINED_PEER
: il nome del Chiave di autenticazione MD5 per il peer BGP a cui mantenendo
Ad esempio, supponiamo che tu abbia creato i seguenti peer:
PATCH https://compute.googleapis.com/compute/v1/projects/project_id/regions/region_name/routers/cloud_router_name { "md5AuthenticationKeys": [ { "name": "first_key_name", "key": "first_secret_key_value" }, { "name": "second_key_name", "key": "second_secret_key_value" } ], "bgpPeers": [ { "name": "first_peer", "md5AuthenticationKeyName": "first_key_name", "interfaceName": "first_interface", "ipAddress": "first_address", "peerIpAddress": "first_peer_interface", "peerAsn": "first_peer_asn" }, { "name": "second_peer", "md5AuthenticationKeyName": "second_key_name", "interfaceName": "second_interface", "ipAddress": "second_address", "peerIpAddress": "second_peer_interface", "peerAsn": "second_peer_asn" } ], }
Se poi volessi rimuovere il secondo peer, utilizza una richiesta come la seguente:
PATCH https://compute.googleapis.com/compute/v1/projects/project_id/regions/region_name/routers/cloud_router_name { "md5AuthenticationKeys": [ { "name": "first_key_name", } ], "bgpPeers": [ { "name": "first_peer", "md5AuthenticationKeyName": "first_key_name", "interfaceName": "first_interface", "ipAddress": "first_address", "peerIpAddress": "first_peer_interface", "peerAsn": "first_peer_asn" } ], }