管理安全閘道

本頁說明如何完成常見的安全閘道管理工作。

設定 Shell 環境

如要簡化設定程序並與安全閘道 API 互動，請在工作殼層中定義下列環境變數。

• 一般參數

  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
  

  更改下列內容：

  • MY_PROJECT_ID：建立安全閘道的專案 ID。
  • MY_APPLICATION_ID：應用程式的 ID。例如：github。名稱最多可以包含 63 個半形字元，並能搭配使用小寫英文字母、數字和連字號，開頭須為英文字母，結尾可以是英文字母或數字。
  • MY_APPLICATION_DISPLAY_NAME：要顯示的名稱，使用者可輕鬆理解。

  • MY_HOST_NAME：應用程式的主機名稱。例如：github.com。主機名稱長度上限為 253 個字元，且必須符合下列其中一種格式：

    • 有效的 IPv4 位址
    • 有效的 IPv6 位址
    • 有效的 DNS 名稱
    • 星號 (*)
    • 星號 (*) 後接有效的 DNS 名稱

• 安全閘道參數

  SECURITY_GATEWAY_ID=MY_SECURITY_GATEWAY_ID
  SECURITY_GATEWAY_DISPLAY_NAME="MY_SECURITY_GATEWAY_DISPLAY_NAME"
  

  更改下列內容：

  • MY_SECURITY_GATEWAY_ID：安全閘道的 ID。ID 最多可包含 63 個字元，且只能包含小寫英文字母、數字和連字號。第一個字元須為英文字母，最後一個字元可以是英文字母或數字。
  • MY_SECURITY_GATEWAY_DISPLAY_NAME：安全閘道清楚易懂的名稱。名稱長度上限為 63 個字元，且只能包含可列印的字元。

更新安全閘道

以下範例說明如何更新現有安全閘道的中心。

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"

取得安全閘道的詳細資料

如要取得安全閘道的詳細資料，請執行下列指令。

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}"

列出安全閘道

如要列出專案中的所有安全閘道，請執行下列指令。

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

刪除安全閘道

如要刪除安全閘道，請執行下列指令。

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}"

更新應用程式資源

您可以呼叫 Update API 更新現有應用程式。以下是可編輯的欄位：

• display_name
• endpoint_matchers

您可以使用 update_mask 控制要更新的欄位。以下是更新 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"

取得應用程式資源的詳細資料

成功建立或更新應用程式後，您可以呼叫 Get API 取得應用程式資源詳細資料。

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}"

列出應用程式資源

您可以呼叫 List API，列出安全閘道下的所有應用程式資源。

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"

刪除應用程式資源

如要刪除應用程式資源，請呼叫 Delete API。

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}"