Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

클라우드용 TLS 인증서 업데이트

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

가상 호스트 또는 대상 엔드포인트/대상 서버에서 키 저장소 및 트러스트 저장소의 이름을 지정하는 데 사용하는 방법은 인증서 업데이트 수행 방법을 결정합니다. 다음을 사용하여 키 저장소 및 트러스트 저장소의 이름을 지정할 수 있습니다.

참조 - 권장
직접 이름
흐름 변수

다음 표에 설명된 것처럼 이러한 각 방법이 인증서 업데이트 프로세스에 미치는 영향은 서로 다릅니다.

구성 유형	인증서를 업데이트/바꾸는 방법	가상 호스트, 대상 엔드포인트/대상 서버를 업데이트하는 방법
참조 (권장)	키 저장소의 경우 새 이름 과 이전 별칭과 동일한 이름 으로 새 키 저장소를 만듭니다. 트러스트 저장소의 경우 새 이름으로 트러스트 저장소를 만듭니다.	키 저장소 또는 트러스트 저장소에 대한 참조를 업데이트합니다. Apigee Edge 지원팀에 문의할 필요가 없습니다.
흐름 변수 (대상 엔드포인트만 해당)	키 저장소의 경우 새 이름 및 동일한 이름 또는 새 이름의 별칭으로 새 키 저장소를 만듭니다. 트러스트 저장소의 경우 새 이름으로 트러스트 저장소를 만듭니다.	각 요청에서 업데이트된 흐름 변수를 새 키 저장소, 별칭 또는 트러스트 저장소의 이름으로 전달합니다. Apigee Edge 지원팀에 문의할 필요가 없습니다.
직접성	새 키 저장소, 별칭, 트러스트 저장소를 만듭니다.	가상 호스트의 경우 라우터를 다시 시작하려면 Apigee Edge 지원팀에 문의하세요. 트러스트 저장소가 대상 엔드포인트/대상 서버에서 사용되는 경우 프록시를 다시 배포합니다.
직접성	키 저장소 또는 트러스트 저장소를 삭제하고 동일한 이름으로 다시 생성합니다.	가상 호스트를 업데이트할 필요는 없습니다. 하지만 새 키 저장소와 별칭이 설정될 때까지 API 요청이 실패합니다. 키 저장소가 Edge와 백엔드 서비스 간의 양방향 TLS에 사용되는 경우 contact Apigee Edge 지원팀에 문의 하여 메시지 프로세서를 다시 시작합니다.
직접성	트러스트 저장소의 경우에만 트러스트 저장소에 새 인증서를 업로드합니다.	가상 호스트의 경우 Apigee Edge 지원팀에 문의하여 Edge 라우터를 다시 시작합니다. 트러스트 저장소가 대상 엔드포인트/대상 서버에서 사용되는 경우 Apigee Edge 지원팀에 문의하여 메시지 프로세서를 다시 시작합니다.

업데이트 전후 인증서 테스트

업데이트하기 전에 다음 openssl 명령어를 사용하여 현재 인증서를 테스트합니다 .

echo | openssl s_client -servername HOSTNAME -connect ORG-ENV.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

여기서 HOSTNAME 은 호스트 별칭이고 ORG-ENV 는 조직 및 환경입니다. 예를 들면 다음과 같습니다.

echo | openssl s_client -servername example.com -connect myOrg-prod.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

다음과 같은 형식으로 출력이 표시됩니다.

notBefore=Dec 30 22:11:38 2015 GMT
notAfter=Dec 30 22:11:38 2016 GMT
subject= /OU=Domain Control Validated/CN=*.apigee.net

인증서를 업데이트한 후 동일한 명령어를 사용하여 테스트합니다.

가상 호스트 또는 대상 엔드포인트/대상 서버가 키 저장소 및 트러스트 저장소를 참조하는 방법 결정

https://enterprise.apigee.com에서 Edge 관리 UI에 로그인합니다.
Edge 관리 UI 메뉴에서 조직 이름을 선택합니다.
가상 호스트의 경우 가상 호스트가 키 저장소 및 트러스트 저장소를 지정하는 방법을 결정합니다.
1. Edge UI 버전에 따라 다음 안내를 따르세요.
  1. 기본 Edge UI 를 사용하는 경우 API > 환경 구성 을 선택합니다.
  2. 새 Edge UI를 사용하는 경우 관리자 > 환경을 선택합니다.
2. 가상 호스트 탭을 선택합니다.
3. 업데이트 중인 특정 가상 호스트의 경우 표시 버튼을 선택하여 속성을 표시합니다. 표시에는 다음 속성이 포함됩니다.
  1. 키 저장소: 현재 키 저장소의 이름으로, 일반적으로 참조로 지정됩니다ref://mykeystoreref.
    
    또는 직접 이름 형식으로 지정되거나 myKeystoreName 흐름 변수 형식으로 지정될 수 있습니다. {ssl.keystore}.
  2. 키 별칭 이 속성의 값은 키 저장소의 별칭 이름입니다. 새 키 저장소는 동일한 이름으로 별칭을 만들어야 합니다.
  3. 트러스트 저장소: 현재 트러스트 저장소의 이름(있는 경우)으로, 일반적으로 참조로 지정됩니다. ref://mytruststoreref
    
    또는 직접 이름으로 지정될 수 있습니다. 형식은 myTruststoreName이며, 흐름 변수로 지정될 수도 있습니다. 형식은 {ssl.truststorestore}입니다.
**대상 엔드포인트/대상 서버의 경우** 대상 엔드포인트가 키 저장소 및 트러스트 저장소를 지정하는 방법을 결정합니다.
1. Edge 관리 UI 메뉴에서 API 를 선택합니다.
2. API 프록시 이름을 선택합니다.
3. 개발 탭을 선택합니다.
4. 대상 엔드포인트에서 기본값을 선택합니다.
5. 코드 영역에 TargetEndpoint 정의가 표시됩니다. <SSLInfo> 요소를 검사하여 키 저장소/트러스트 저장소가 정의되는 방식을 확인합니다.
  
  참고: 대상 엔드포인트가 대상 서버를 사용하는 경우 대상 엔드포인트의 XML 정의가 아래와 같이 표시됩니다. 여기서 <LoadBalancer> 태그는 API 프록시에서 사용하는 대상 서버를 지정합니다.
```
<TargetEndpoint name="default">
  …
  <HTTPTargetConnection>
    <LoadBalancer>
      <Server name="target1" />
      <Server name="target2" />
    </LoadBalancer>
    <Path>/test</Path>
  </HTTPTargetConnection>
    …
</TargetEndpoint>
```
  대상 서버 정의에서 <SSLInfo> 요소를 검사하여 키 저장소/트러스트 저장소가 정의되는 방식을 확인합니다.

키 저장소에서 TLS 인증서 업데이트

키 저장소의 인증서가 만료되면 새 인증서를 키 저장소에 업로드할 수 없습니다. 대신 새 키 저장소를 만들고 인증서를 업로드한 후 가상 호스트 또는 대상 서버/대상 엔드포인트를 업데이트하여 새 키 저장소를 사용합니다.

일반적으로 현재 인증서가 만료되기 전에 새 키 저장소를 만든 후 가상 호스트 또는 대상 엔드포인트를 업데이트하여 새 키 저장소를 사용하므로 만료된 인증서로 인해 서비스 요청이 중단되지 않도록 할 수 있습니다. 그런 다음 새 키 저장소가 올바르게 작동하는지 확인한 후 이전 키 저장소를 삭제할 수 있습니다.

Edge의 클라우드 기반 배포의 경우:

Edge UI를 사용하여 키 저장소 및 트러스트 저장소 만들기에 설명된 대로 새 키 저장소를 만들고 인증서와 키를 업로드합니다.

새 키 저장소에서 기존 키 저장소에서 사용된 키 별칭과 동일한 이름을 사용해야 합니다.
인바운드 연결(Edge로의 API 요청)에서 사용되는 가상 호스트의 경우:
1. 가상 호스트가 키 저장소에 대한 참조를 사용하는 경우 참조를 업데이트합니다.
2. 가상 호스트가 키 저장소의 직접 이름을 사용하는 경우 Apigee Edge 지원팀에 문의합니다.
아웃바운드 연결(Apigee에서 백엔드 서버로)에서 사용되는 대상 엔드포인트/대상 서버 의 경우:
1. 대상 엔드포인트/대상 서버가 키 저장소에 대한 참조를 사용하는 경우 참조를 업데이트합니다. 프록시를 다시 배포할 필요가 없습니다.
2. 대상 엔드포인트/대상 서버가 흐름 변수를 사용하는 경우 흐름 변수를 업데이트합니다. 프록시를 다시 배포할 필요가 없습니다.
3. 대상 엔드포인트/대상 서버가 키 저장소의 직접 이름을 사용하는 경우 이전 키 저장소 및 키 별칭을 참조한 API 프록시의 대상 엔드포인트/대상 서버 구성을 업데이트하여 새 키 저장소 및 키 별칭을 참조합니다.
  
  그런 다음 프록시를 다시 배포해야 합니다.
새 키 저장소가 올바르게 작동하는지 확인한 후 만료된 인증서와 키가 포함된 이전 키 저장소를 삭제합니다.

트러스트 저장소에서 TLS 인증서 업데이트

트러스트 저장소의 인증서가 만료되면 일반적으로 새 트러스트 저장소를 만들고 인증서를 업로드한 후 가상 호스트 또는 대상 서버/대상 엔드포인트를 업데이트하여 새 트러스트 저장소를 사용합니다.

인증서가 체인의 일부인 경우 모든 인증서가 포함된 단일 파일을 만들어 해당 파일을 단일 별칭으로 업로드하거나, 각 인증서에 서로 다른 별칭을 사용하여 체인의 모든 인증서를 트러스트 저장소에 업로드 합니다.

일반적으로 현재 인증서가 만료되기 전에 새 트러스트 저장소를 만든 후 가상 호스트 또는 대상 엔드포인트를 업데이트하여 새 트러스트 저장소를 사용하므로 만료된 인증서로 인해 서비스 요청이 중단되지 않도록 할 수 있습니다. 그런 다음 새 트러스트 저장소가 올바르게 작동하는지 확인한 후 이전 트러스트 저장소를 삭제할 수 있습니다.

Edge의 클라우드 기반 배포의 경우:

Edge UI를 사용하여 키 저장소 및 트러스트 저장소 만들기에 설명된 대로 새 트러스트 저장소를 만들고 인증서를 업로드합니다.

새 인증서를 새 트러스트 저장소에 업로드할 때 별칭 이름은 중요하지 않습니다.
인바운드 연결(Edge로의 API 요청)에서 사용되는 가상 호스트의 경우:
1. 가상 호스트가 트러스트 저장소에 대한 참조를 사용하는 경우 참조를 업데이트합니다.
2. 가상 호스트가 트러스트 저장소의 직접 이름을 사용하는 경우 Apigee Edge 지원팀에 문의합니다.
아웃바운드 연결(Apigee에서 백엔드 서버로)에서 사용되는 대상 엔드포인트/대상 서버 의 경우:
1. 대상 엔드포인트/대상 서버가 트러스트 저장소에 대한 참조를 사용하는 경우 참조를 업데이트합니다. 프록시를 다시 배포할 필요가 없습니다.
2. 대상 엔드포인트/대상 서버가 흐름 변수를 사용하는 경우 흐름 변수를 업데이트합니다. 프록시를 다시 배포할 필요가 없습니다.
3. 대상 엔드포인트/대상 서버가 트러스트 저장소의 직접 이름을 사용하는 경우 대상 엔드포인트/대상 서버 구성을 업데이트하여 이전 트러스트 저장소를 참조한 API 프록시가 새 키 저장소 및 키 별칭을 참조하도록 합니다.
  
  그런 다음 프록시를 다시 배포해야 합니다.
새 트러스트 저장소가 올바르게 작동하는지 확인한 후 만료된 인증서가 포함된 이전 트러스트 저장소를 삭제합니다.