일반 HTTP 연결 구성 및 사용

이 페이지에서는 일반 HTTP 엔드포인트에 대한 연결을 구성하는 방법을 설명합니다.

Git 저장소 연결 및 계정 커넥터, 외에도 일반 HTTP 엔드포인트에 대한 Developer Connect 연결을 설정할 수 있습니다. 이렇게 하면 HTTP 엔드포인트를 사용하여 액세스할 수 있는 한 여러 서드 파티 개발자 도구, 서비스, API에 대한 연결을 설정하고 관리할 수 있습니다.

HTTP 연결 만들기

HTTP 연결은 기본 인증 (사용자 이름 및 비밀번호) 및 전달자 토큰 인증을 지원합니다. 두 인증 유형 모두 Secret Manager에서 보안 비밀을 만들어야 합니다.

전달자 토큰 인증

  1. Secret Manager를 사용하여 보안 비밀 및 토큰이 포함된 보안 비밀 버전을 만듭니다.

    토큰은 이 연결을 만들 도구에 액세스할 수 있는 개인 액세스 토큰 또는 API 토큰입니다.

  2. 전달자 토큰 인증을 사용하여 연결을 만들려면 다음 명령어를 실행합니다.

    gcloud developer-connect connections create CONNECTION_ID \
    --location=REGION \
    --project=PROJECT_ID \
    --http-config-host-uri=HOST_URI \
    --http-config-bearer-token-authentication-secret-version=TOKEN_SECRET_VERSION \
    --http-config-service-directory=SERVICE_DIRECTORY_SERVICE \
    --http-config-ssl-ca-certificate=SSL_CERTIFICATE_FILE_PATH \
    --git-proxy-config-enabled
    

    다음을 바꿉니다.

기본 인증

  1. Secret Manager를 사용하여 보안 비밀 및 사용자 이름과 비밀번호가 포함된 보안 비밀 버전을 만듭니다.

  2. 기본 인증을 사용하여 연결을 만들려면 다음 명령어를 실행합니다.

    gcloud developer-connect connections create CONNECTION_ID \
    --location=REGION \
    --project=PROJECT_ID \
    --http-config-host-uri=HOST_URI \
    --http-config-basic-authentication-username=USERNAME \
    --http-config-basic-authentication-password-secret-version=PASSWORD_SECRET_VERSION \
    --http-config-service-directory=SERVICE_DIRECTORY_SERVICE \
    --http-config-ssl-ca-certificate=SSL_CERTIFICATE_FILE_PATH \
    --git-proxy-config-enabled \
    

    다음을 바꿉니다.

    • CONNECTION_ID를 이 새 연결의 고유 ID로 바꿉니다.
    • REGION을 이 연결을 만드는 Google Cloud 리전으로 바꿉니다.
    • PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.
    • HOST_URI를 기본 HTTPS 엔드포인트 (예: https://api.myservice.com)로 바꿉니다.
    • USERNAME을 기본 사용자 이름-비밀번호 인증의 사용자 이름으로 바꿉니다.
    • PASSWORD_SECRET_VERSION을 기본 사용자 이름-비밀번호 인증의 비밀번호에 대한 Secret Manager 보안 비밀 버전 리소스 이름으로 바꿉니다. (예: projects/01234567890/secrets/exampletool-api-pw/versions/1)
    • SERVICE_DIRECTORY_SERVICE를 비공개 네트워크 액세스의 서비스 디렉터리 리소스 이름으로 바꿉니다. 이는 선택사항입니다.
    • SSL_CERTIFICATE_FILE_PATH를 SSL CA 인증서 콘텐츠가 포함된 로컬 파일 의 경로로 바꿉니다. 이는 선택사항입니다.
    • Developer Connect 프록시를 사용하여 이 연결에 액세스하려면 --git-proxy-config-enabled 옵션을 포함합니다.

연결이 생성되면 Developer Connect에서 연결 리소스 이름을 사용하여 연결에 액세스할 수 있습니다.