일반 HTTP 연결 구성 및 사용

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

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

예를 들어 Confluence의 페이지에 대한 HTTP 연결을 설정하면 Gemini Code Assist가 해당 연결을 사용하여 Confluence 페이지의 콘텐츠에 컨텍스트로 액세스할 수 있습니다.

HTTP 연결 만들기

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

Bearer 토큰 인증

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

   토큰은 이 연결을 만들려는 도구에 액세스할 수 있는 개인 액세스 토큰 또는 API 토큰입니다. 예를 들어 Confluence의 경우 Atlassian 계정의 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
   

   다음을 바꿉니다.

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

연결이 생성되면 Developer Connect에서 연결 리소스 이름을 사용하여 연결에 액세스할 수 있습니다. 예를 들어 이 연결을 사용하여 Gemini Code Assist RAG에 Confluence의 리소스에 대한 액세스 권한을 부여할 수 있습니다.