Gestire un gateway sicuro

Questa pagina spiega come completare le attività comuni di gestione del gateway sicuro.

Configura l'ambiente shell

Per semplificare la procedura di configurazione e interagire con le API del gateway sicuro, definisci le seguenti variabili di ambiente nella shell di lavoro.

  • Parametri generali

    API="beyondcorp.googleapis.com"
API_VERSION=v1
PROJECT_ID=MY_PROJECT_ID
APPLICATION_ID=MY_APPLICATION_ID
APPLICATION_DISPLAY_NAME="MY_APPLICATION_DISPLAY_NAME"
HOST_NAME=MY_HOST_NAME

    Sostituisci quanto segue:

    • MY_PROJECT_ID: l'ID del progetto in cui viene creato il gateway sicuro.
    • MY_APPLICATION_ID: l'ID della tua applicazione. Ad esempio, github. Il nome può contenere al massimo 63 caratteri e può contenere lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera e l'ultimo può essere una lettera o un numero.
    • MY_APPLICATION_DISPLAY_NAME: il nome leggibile da mostrare.

    • MY_HOST_NAME: Il nome host della tua applicazione. Ad esempio, github.com. Il nome host può contenere fino a 253 caratteri e deve rispettare uno dei seguenti formati:

      • Un indirizzo IPv4 valido
      • Un indirizzo IPv6 valido
      • Un nome DNS valido
      • Un asterisco (*)
      • Un asterisco (*) seguito da un nome DNS valido

  • Parametri del gateway sicuro

    SECURITY_GATEWAY_ID=MY_SECURITY_GATEWAY_ID
SECURITY_GATEWAY_DISPLAY_NAME="MY_SECURITY_GATEWAY_DISPLAY_NAME"

    Sostituisci quanto segue:

    • MY_SECURITY_GATEWAY_ID: l'ID del gateway sicuro. L'ID può contenere al massimo 63 caratteri e può includere lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera e l'ultimo può essere una lettera o un numero.
    • MY_SECURITY_GATEWAY_DISPLAY_NAME: Il nome leggibile del gateway sicuro. Il nome può contenere fino a 63 caratteri stampabili.

Aggiorna un gateway sicuro

Il seguente esempio mostra come aggiornare gli hub di un gateway sicuro esistente.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-X PATCH \
-d "{ \"hubs\": {\"us-central1\": {}, \"us-east1\": {}} }" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}?update_mask=hubs"

Visualizzare i dettagli di un gateway sicuro

Per ottenere i dettagli di un gateway sicuro, esegui questo comando.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}"

Elenco di gateway sicuri

Per elencare tutti i gateway sicuri in un progetto, esegui questo comando.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways"

Elimina un gateway sicuro

Per eliminare un gateway sicuro, esegui questo comando.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-X DELETE \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}"

Aggiorna una risorsa dell'applicazione

Puoi aggiornare un'applicazione esistente chiamando l'API Update. Di seguito sono riportati i campi modificabili consentiti:

  • display_name
  • endpoint_matchers

Puoi utilizzare update_mask per controllare i campi che vuoi aggiornare. Di seguito è riportato un esempio per aggiornare endpoint_matchers:

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-X PATCH \
-d "{ \"endpoint_matchers\": [{hostname: \"${HOST_NAME}\"}] }" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}/applications/${APPLICATION_ID}?update_mask=endpoint_matchers"

Visualizza i dettagli di una risorsa dell'applicazione

Dopo la creazione o l'aggiornamento di un'applicazione, puoi ottenere i dettagli della risorsa chiamando l'API Get.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}/applications/${APPLICATION_ID}"

Elenco delle risorse dell'applicazione

Puoi elencare tutte le risorse dell'applicazione in un gateway sicuro chiamando l'API List.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}/applications"

Eliminare una risorsa dell'applicazione

Per eliminare una risorsa dell'applicazione, chiama l'API Delete.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-X DELETE \
"https://${API}/${API_VERSION}/projects/${PROJECT_ID}/locations/global/securityGateways/${SECURITY_GATEWAY_ID}/applications/${APPLICATION_ID}"