Administra una puerta de enlace segura

En esta página, se explica cómo completar tareas comunes de administración de la puerta de enlace segura.

Configura tu entorno de shell

Para optimizar el proceso de configuración y, luego, interactuar con las APIs de la puerta de enlace segura, define las siguientes variables de entorno en tu shell de trabajo.

  • Parámetros generales

    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

    Reemplaza lo siguiente:

    • MY_PROJECT_ID: Es el ID del proyecto en el que se crea la puerta de enlace segura.
    • MY_APPLICATION_ID: Es el ID de tu aplicación. Por ejemplo, github. El nombre puede tener un máximo de 63 caracteres y puede contener letras minúsculas, números y guiones. El primer carácter debe ser una letra, y el último puede ser una letra o un número.
    • MY_APPLICATION_DISPLAY_NAME: Es el nombre legible que se mostrará.

    • MY_HOST_NAME: Es el nombre de host de tu aplicación. Por ejemplo, github.com El nombre de host puede tener hasta 253 caracteres y debe cumplir con uno de los siguientes formatos:

      • Una dirección IPv4 válida
      • Una dirección IPv6 válida
      • Un nombre de DNS válido
      • Un asterisco (*)
      • Un asterisco (*) seguido de un nombre de DNS válido

  • Parámetros de puerta de enlace seguros

    SECURITY_GATEWAY_ID=MY_SECURITY_GATEWAY_ID
SECURITY_GATEWAY_DISPLAY_NAME="MY_SECURITY_GATEWAY_DISPLAY_NAME"

    Reemplaza lo siguiente:

    • MY_SECURITY_GATEWAY_ID: ID de la puerta de enlace segura. El ID puede tener un máximo de 63 caracteres y puede contener letras en minúscula, números y guiones. El primer carácter debe ser una letra y el último puede ser una letra o un número.
    • MY_SECURITY_GATEWAY_DISPLAY_NAME: Es el nombre legible de la puerta de enlace segura. El nombre puede tener hasta 63 caracteres y puede incluir caracteres imprimibles.

Actualiza una puerta de enlace segura

En el siguiente ejemplo, se muestra cómo actualizar los centros de una puerta de enlace segura existente.

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"

Obtén los detalles de una puerta de enlace segura

Para obtener los detalles de una puerta de enlace segura, ejecuta el siguiente 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}"

Enumera las puertas de enlace seguras

Para enumerar todas las puertas de enlace seguras de un proyecto, ejecuta el siguiente 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"

Borra una puerta de enlace segura

Para borrar una puerta de enlace segura, ejecuta el siguiente 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}"

Actualiza un recurso de aplicación

Puedes actualizar una aplicación existente llamando a la API de Update. A continuación, se indican los campos editables permitidos:

  • display_name
  • endpoint_matchers

Puedes usar update_mask para controlar qué campos deseas actualizar. A continuación, se muestra un ejemplo para actualizar 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"

Obtén los detalles de un recurso de aplicación

Después de crear o actualizar una aplicación correctamente, puedes obtener los detalles del recurso de la aplicación llamando a la API de 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}"

Enumera los recursos de la aplicación

Puedes enumerar todos los recursos de la aplicación en una puerta de enlace segura llamando a la API de 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"

Borra un recurso de aplicación

Para borrar un recurso de aplicación, llama a la API de 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}"