셸 환경 설정
설정 프로세스를 간소화하고 보안 게이트웨이 API와 상호작용하려면 작업 셸에서 다음 환경 변수를 정의합니다.
일반 매개변수
API="beyondcorp.googleapis.com" API_VERSION=v1 PROJECT_ID=MY_PROJECT_ID APPLICATION_NAME=MY_APPLICATION_NAME HOST_NAME=MY_HOST_NAME
다음을 바꿉니다.
- MY_PROJECT_ID: 보안 게이트웨이가 생성된 프로젝트 ID입니다.
- MY_APPLICATION_NAME: SaaS 애플리케이션의 이름입니다. 예를 들면
github입니다. 이름은 최대 63자(영문 기준)까지 입력할 수 있으며 소문자, 숫자, 하이픈을 포함할 수 있습니다. 첫 번째 문자는 문자여야 하며 마지막 문자는 문자 또는 숫자일 수 있습니다. MY_HOST_NAME: SaaS 애플리케이션의 호스트 이름입니다. 예를 들면
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_nameendpoint_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_NAME?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_NAME"
애플리케이션 리소스 나열
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_NAME"