truststore에 대해 클라이언트 인증서 유효성 검사

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

이 문서에서는 올바른 클라이언트 인증서가 Apigee Edge 라우터에 업로드되었는지 확인하는 방법을 설명합니다. 인증서 검증 프로세스는 Apigee Edge 라우터의 NGINX에서 사용하는 기본 메커니즘인 OpenSSL을 사용합니다.

API 요청의 일부로 클라이언트 애플리케이션에서 전송한 인증서와 Apigee Edge 라우터에 저장된 인증서가 일치하지 않으면 400 Bad Request - SSL Certificate 오류가 발생합니다. 이 문서에 설명된 프로세스 를 사용하여 인증서를 검증하면 이러한 문제를 사전에 감지하고 런타임 시 인증서 오류를 방지할 수 있습니다.

시작하기 전에

이 문서의 단계를 사용하기 전에 다음 주제를 이해해야 합니다.

Apigee 라우터의 트러스트 저장소를 기준으로 클라이언트 인증서 검증

이 섹션에서는 클라이언트 인증서가 Apigee Edge 라우터의 트러스트 저장소에 저장된 인증서와 동일한지 확인하는 데 사용되는 단계를 설명합니다.

  1. 라우터 머신 중 하나에 로그인합니다.
  2. 인증서가 Apigee Edge 라우터의 트러스트 저장소에 저장된 /opt/nginx/conf.d 폴더로 이동합니다.
  3. 클라이언트 인증서를 검증할 트러스트 저장소를 식별합니다. 트러스트 저장소 이름의 형식은 다음과 같습니다. 
    org-env-virtualhost-client.pem

    각 항목의 의미는 다음과 같습니다.

    • org은 Apigee 조직 이름입니다
    • env은 Apigee 환경 이름입니다
    • virtualhost은 Apigee 가상 호스트 이름입니다.

      • 예를 들어 다음을 검증하려면 다음을 수행합니다.

      • 조직: myorg
      • 환경: test
      • 가상 호스트: secure

      트러스트 저장소 이름은 myorg-test-secure-client.pem입니다.

  4. 로컬 머신에서 검증하려는 실제 클라이언트 인증서를 /tmp 디렉터리로 전송합니다. scp, sftp 또는 기타 유틸리티를 사용합니다.

    예를 들어 다음과 같이 scp 명령어를 사용합니다. 

    scp client_cert.pem router-host:/tmp

    여기서 router-host는 라우터 머신의 이름입니다.

  5. 다음과 같이 OpenSSL을 사용하여 클라이언트 인증서를 검증합니다. 
    openssl verify -trusted org-env-virtualhost-client.pem /tmp/client-cert.pem

    각 항목의 의미는 다음과 같습니다.

    • org은 Apigee 조직 이름입니다
    • env은 Apigee 환경 이름입니다
    • virtualhost은 Apigee 가상 호스트 이름입니다.

  6. 위 명령어에서 반환된 오류를 수정합니다.

    Apigee Edge 라우터의 트러스트 저장소에 올바른 인증서가 포함되어 있지 않으면 이 트러스트 저장소에 인증서 업로드 API를 사용하여 올바른 인증서를 PEM 형식으로 삭제하고 업로드합니다.