클라이언트 라이브러리 엔드포인트 구성

각 Cloud de Confiance by S3NS API 서비스는 서비스별 엔드포인트를 통해 액세스됩니다.

예를 들어 Java-Speech 및 Java-Translate 클라이언트 라이브러리의 기본 엔드포인트는 각각 https://speech.googleapis.com:443 및 https://translate.googleapis.com:443입니다.

자바용 Cloud 클라이언트 라이브러리는 클라이언트 초기화 중에 올바른 서비스 엔드포인트를 자동으로 결정합니다. 커스텀 엔드포인트가 구성되지 않은 경우 라이브러리는 서비스의 기본 엔드포인트를 사용합니다.

엔드포인트의 구성

Java-Speech 엔드포인트를 예로 들어 다음 표에서는 엔드포인트를 구성하는 섹션을 자세히 설명합니다.

서비스 이름을 제외하고 자바용 모든 Cloud 클라이언트 라이브러리 엔드포인트의 기본값입니다. 모든 서비스의 값이 다르므로 서비스 이름에는 기본값이 없습니다. Cloud de Confiance

커스텀 엔드포인트를 구성해야 하는 경우

다음과 같이 기본 엔드포인트를 대체하는 특정 사용 사례가 있습니다.

• 서비스에서 리전 엔드포인트를 제공합니다. 기본 엔드포인트는 리전 변형을 고려하지 않습니다.
• 프로덕션 환경에서 작업하지 않습니다. 예를 들어 TLS를 구성하지 않고 에뮬레이터로 로컬에서 테스트합니다.

필요한 경우에만 엔드포인트 구성을 수정합니다. 커스텀 엔드포인트를 사용하는 경우 포트 번호 (예: example.com:443)를 포함해야 합니다. 클라이언트 라이브러리는 기본 서비스 엔드포인트와 달리 커스텀 엔드포인트에 443와 같은 기본 포트를 자동으로 추가하지 않습니다.

커스텀 엔드포인트 구성

자바용 Cloud 클라이언트 라이브러리의 서비스별 ClientSettings에서 엔드포인트를 설정할 수 있습니다.

다음 예에서는 Java-KMS를 사용합니다.

1. ClientSettings.Builder에서 엔드포인트를 설정하고 ClientSettings를 만듭니다.

   // Replace with your desired endpoint
   String endpoint = "customEndpoint.com:443";
   KeyManagementServiceSettings keyManagementServiceSettings =
    KeyManagementServiceSettings.newBuilder()
       .setEndpoint(endpoint)
       .build();
   

2. ClientSettings로 클라이언트를 시작합니다.

   try (KeyManagementServiceClient keyManagementServiceClient =
     KeyManagementServiceClient.create(keyManagementServiceSettings)) {
     ...
   }
   

   엔드포인트는 customEndpoint.com:443으로 확인됩니다.

   클라이언트는 다음 소스 중 하나에서 엔드포인트를 제공하는 첫 번째 소스의 엔드포인트를 사용합니다.

   1. ClientSettings.Builder.setEndpoint()를 통해 프로그래매틱 방식으로 설정된 엔드포인트입니다.
   2. 서비스의 기본 엔드포인트(예: https://{serviceName}.googleapis.com:443)입니다.

다음 스니펫은 클라이언트의 확인된 엔드포인트를 결정하는 방법을 보여줍니다.

// The client's settings class contains a getter for the endpoint
keyManagementServiceClient.getSettings().getEndpoint();