내용으로 건너뛰기

상호 TLS가 필요한 API Gateway 사용자 지정 도메인 이름에서 HTTP 403 Frobidden 오류를 해결하려면 어떻게 해야 합니까?

6분 분량
0

상호 Transport Layer Security(TLS) 인증이 활성화된 Amazon API Gateway 사용자 지정 도메인 이름이 HTTP 403 Forbidden 오류를 반환합니다. 왜 이런 일이 발생하는지 모르겠습니다.

간략한 설명

참고: API Gateway는 다양한 이유로 403 Forbidden 오류를 반환합니다. 이 문서에서는 상호 TLS에만 관련된 403 Forbidden 오류를 다룹니다. 다른 유형의 403 Forbidden 오류의 문제 해결에 대한 자세한 내용은 API Gateway의 HTTP 403 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

상호 TLS가 필요한 사용자 지정 도메인 이름을 사용하여 API Gateway API를 호출하려면 클라이언트가 API 요청에서 신뢰할 수 있는 인증서를 제시해야 합니다. 클라이언트가 API를 호출하면 API Gateway는 truststore에서 클라이언트 인증서 발급자를 찾습니다.

다음과 같은 경우 API Gateway가 TLS 연결에 실패하고 403 상태 코드를 반환합니다.

  • API Gateway가 truststore에서 클라이언트 인증서 발급자를 찾을 수 없습니다.
  • 클라이언트 인증서가 안전하지 않은 서명 알고리즘을 사용합니다.
  • 클라이언트 인증서가 자체 서명되었습니다.

API에 대해 Amazon CloudWatch 로깅이 활성화되면 오류의 원인을 나타내는 오류 메시지가 실행 로그에 표시됩니다.

중요: 로깅이 활성화된 후 API 요청에서 CloudWatch 로그가 생성되지 않는 경우 403 Forbidden 오류는 상호 TLS와 관련이 없는 것입니다.

REST API의 경우

REST API에 대한 Amazon CloudWatch 로깅을 설정한 경우 실행 로그에 다음 오류 메시지 중 하나가 표시됩니다.

  • Access denied. Reason: Could not find issuer for certificate
  • Access denied. Reason: Client cert using an insecure Signature Algorithm
  • Access denied. Reason: self signed certificate

HTTP API의 경우

HTTP API가 실행 로깅을 지원하지 않습니다. 상호 TLS가 필요하고 HTTP API를 호출하는 사용자 지정 도메인 이름에서 반환되는 403 Forbidden 오류 문제를 해결하려면 다음 단계를 완료하십시오.

  1. 사용자 지정 도메인 이름에 대해 테스트용으로만 REST API를 호출하는 새 API 매핑을 생성합니다.
    참고: 테스트할 REST API가 없는 경우 PetStore REST API 예제를 사용하십시오. 그런 다음 예제 API를 새 단계에 배포하고 사용자 지정 도메인 이름을 사용하는 새 API 매핑을 생성합니다.
  2. REST API에 생성한 새 API 매핑에 대해서는 이 문서의 해결 방법 섹션에 있는 지침을 따르십시오.
  3. 사용자 지정 도메인 이름에 대한 API 매핑을 다시 HTTP API로 라우팅합니다.

해결 방법

오류 원인 확인

  1. REST API에 대한 CloudWatch 로깅을 활성화합니다.

  2. 실행 및 액세스 로깅을 구성합니다. 참고: 이 사용 사례에 대해 액세스 로깅을 구성할 때는 다음 $context 변수를 사용합니다.

    { "accountId":"$context.accountId", "apiId":"$context.apiId", "domainName":"$context.domainName", "domainPrefix":"$context.domainPrefix", "error.message":"$context.error.message", "error.responseType":"$context.error.responseType", "extendedRequestId":"$context.extendedRequestId", "httpMethod":"$context.httpMethod", "identity.sourceIp":"$context.identity.sourceIp", "identity.clientCert.clientCertPem":"$context.identity.clientCert.clientCertPem", "identity.clientCert.subjectDN":"$context.identity.clientCert.subjectDN", "identity.clientCert.issuerDN":"$context.identity.clientCert.issuerDN", "identity.clientCert.serialNumber":"$context.identity.clientCert.serialNumber", "identity.clientCert.validity.notBefore":"$context.identity.clientCert.validity.notBefore", "identity.clientCert.validity.notAfter":"$context.identity.clientCert.validity.notAfter", "identity.userAgent":"$context.identity.userAgent", "path":"$context.path", "protocol":"$context.protocol", "requestId":"$context.requestId", "requestTime":"$context.requestTime", "requestTimeEpoch":"$context.requestTimeEpoch", "resourceId":"$context.resourceId", "resourcePath":"$context.resourcePath", "stage":"$context.stage", "responseLatency":"$context.responseLatency", "responseLength":"$context.responseLength", "status":"$context.status" }

    이 액세스 로그 템플릿은 상호 TLS가 403 오류의 원인인 경우 클라이언트 인증서 정보를 로깅합니다. 또한 이 템플릿을 사용하면 API를 호출하려 한 호출자를 식별하기 더 쉽습니다.

  3. CloudWatch에서 REST API의 실행 로그를 확인하여 오류의 원인을 식별하십시오. 상호 TLS와 관련된 403 Forbidden 오류가 기록되면 다음과 비슷한 오류 메시지가 나타납니다.

    Extended Request Id: {extendedRequestId} Access denied. Reason: {reason}
    ForbiddenException Forbidden: {requestId}

‘Access denied. Reason: Could not find issuer for certificate’ 오류 해결

API 요청의 클라이언트 인증서 발급자가 사용자 지정 도메인 이름의 truststore에 포함되어 있는지 확인합니다

API 요청의 클라이언트 인증서 발급자 전체 인증서 체인(client.pem)이 사용자 지정 도메인 이름의 truststore에 포함되어야 합니다. trustsore(bundle.pem)는 Amazon Simple Storage Service(Amazon S3)에 저장된 파일입니다. 클라이언트 인증서 발급자가 필수 truststore에 포함되어 있는지 확인하려면 다음 OpenSSL 명령을 실행합니다.

openssl verify -CAfile bundle.pem client.pem

인증서 번들에 중간 인증 기관이 포함된 경우 다음 OpenSSL 명령을 실행합니다.

openssl verify -CAfile rootCA.pem -untrusted intCA.pem client.pem

API 요청의 클라이언트 인증서 발급자가 필수 truststore에 포함된 경우 명령은 OK 응답을 반환합니다.

클라이언트 인증서 발급자가 필수 truststore에 포함되지 않은 경우, 명령은 다음 오류를 반환합니다.

error X at Y depth lookup: unable to get local issuer certificate

이 오류를 해결하려면 클라이언트 인증서에 대한 전체 인증서 체인을 포함하는 새 truststore를 Amazon S3에 업로드하십시오.

사용자 지정 도메인 이름의 truststore에 있는 모든 클라이언트 인증서가 유효한지 확인합니다

사용자 지정 도메인 이름의 truststore에 있는 클라이언트 인증서 중 하나가 유효하지 않은 경우 일부 클라이언트는 API에 액세스하지 못할 수 있습니다. truststore의 클라이언트 인증서가 유효한지 확인하려면 다음 단계를 완료하십시오.

  1. Amazon API Gateway 콘솔을 엽니다.

  2. 탐색 창에서 Custom domain names(사용자 지정 도메인 이름)를 선택합니다. 그런 다음 상호 TLS가 필요한 사용자 지정 도메인 이름을 선택합니다.

  3. Domain details(도메인 세부 정보) 섹션에서 다음과 같은 경고가 있는지 확인합니다. Your truststore bundle has 1 invalid certificates.

  4. 경고가 표시되어 있으면 truststore의 인증서를 디코딩하여 어느 인증서로 인해 경고가 도출되었는지 파악합니다. 다음 OpenSSL 명령은 인증서의 제목과 내용을 표시합니다.

    openssl x509 -in certificate.crt -text -noout
  5. 경고를 생성한 인증서를 업데이트하거나 제거합니다. 그런 다음 새 truststore를 Amazon S3에 업로드합니다.

자세한 내용은 인증서 경고 문제 해결을 참조하십시오.

참고: 인증서 체인이 보존된 경우 API Gateway는 루트 인증 기관 또는 기타 중간 인증 기관에서 직접 서명한 클라이언트 인증서를 수락합니다. 마지막 중간 인증 기관에서만 서명한 클라이언트 인증서를 검증하려면 요청 파라미터 기반 AWS Lambda authorizer를 사용하십시오. 요청 기반 Lambda authorizer에서 사용자 지정 유효성 검사 알고리즘을 만들 수 있습니다. 클라이언트 인증서는 requestContext.identity.clienCert 아래에 있는 API 요청의 입력에서 찾을 수 있습니다.

‘Access denied. Reason: Client cert using an insecure Signature Algorithm’ 오류 해결

truststore 텍스트 파일이 지원되는 해싱 알고리즘을 사용하는지 확인합니다. API Gateway는 truststore에서 다음 해싱 알고리즘을 지원합니다.

  • SHA-256 이상
  • RSA-2048 이상
  • ECDSA-256 이상

truststore 텍스트 파일이 지원되는 해싱 알고리즘을 사용하는지 확인하려면 다음 OpenSSL 명령을 실행합니다.

openssl x509 -in client.crt -text -noout | grep 'Signature Algorithm'

명령 응답은 truststore의 서명 알고리즘을 반환합니다. 알고리즘이 지원되지 않는 경우 클라이언트 인증서가 지원되는 알고리즘을 사용하도록 업데이트합니다. 그런 다음 새 truststore를 Amazon S3에 업로드합니다.

자세한 내용은 truststore 구성을 참조하십시오.

‘Access denied. Reason: self signed certificate’ 오류 해결

API 요청의 자체 서명된 클라이언트 인증서가 변경되거나 손상되지 않았는지 확인합니다. 클라이언트 인증서 서명 요청(my_client.csr), 클라이언트 인증서 프라이빗 키(my_client.key), 클라이언트 인증서 퍼블릭 키(my_client.pem)가 일치해야 합니다.

모듈러스를 비교하려면 다음 OpenSSL 명령을 실행합니다.

openssl req -noout -modulus -in my_client.csr
openssl rsa -noout -modulus -in my_client.key
openssl x509 -noout -modulus -in my_client.pem

참고: 비교하기 쉽도록 해시 값을 더 짧게 생성하려면 출력 모듈러스에 파이프를 사용합니다. 다음 openssl sha1 예시를 참조하십시오.

$ openssl [operation] -noout -modulus -in [data] | openssl sha1

유효한 출력 예시는 다음과 비슷합니다.

2143831a73a8bb28467860df18550c696c03fbcb
2143831a73a8bb28467860df18550c696c03fbcb
2143831a73a8bb28467860df18550c696c03fbcb

데이터 무결성을 확인하려면 콘텐츠 수준에서 데이터가 수정되지 않았는지 확인하십시오. 다음 diff 명령을 실행합니다.

diff client.crt bundle.crt

모듈러스가 일치하지 않거나 diff 명령이 차이를 반환하는 경우, 클라이언트 인증서를 다시 만들고 truststore를 업데이트합니다. 그런 다음 새 truststore를 Amazon S3에 업로드합니다.

자세한 내용은 truststore 구성을 참조하십시오.

관련 정보

API Gateway에서 REST API에 대한 상호 TLS 인증을 켜는 방법

AWS 공식업데이트됨 8달 전
1 댓글

This article was reviewed and updated on 2026-02-27.

전문가

답글을 게시함 3달 전

관련 콘텐츠