

# Amazon API Gateway에서의 데이터 보호
<a name="data-protection"></a>

AWS [공동 책임 모델](https://aws.amazon.com/compliance/shared-responsibility-model/)은 Amazon API Gateway의 데이터 보호에 적용됩니다. 이 모델에서 설명하는 것처럼 AWS는 모든 AWS 클라우드를 실행하는 글로벌 인프라를 보호할 책임이 있습니다. 사용자는 인프라에서 호스팅되는 콘텐츠를 관리해야 합니다. 사용하는 AWS 서비스의 보안 구성과 관리 작업에 대한 책임도 사용자에게 있습니다. 데이터 프라이버시에 대한 자세한 내용은 [데이터 프라이버시 FAQ](https://aws.amazon.com/compliance/data-privacy-faq/)를 참조하세요. 유럽의 데이터 보호에 대한 자세한 내용은 *AWS 보안 블로그*의 [AWS 공동 책임 모델 및 GDPR](https://aws.amazon.com/blogs/security/the-aws-shared-responsibility-model-and-gdpr/) 블로그 게시물을 참조하세요.

데이터를 보호하려면 AWS 계정보안 인증 정보를 보호하고 AWS IAM Identity Center또는 AWS Identity and Access Management(IAM)를 통해 개별 사용자 계정을 설정하는 것이 좋습니다. 이렇게 하면 개별 사용자에게 자신의 직무를 충실히 이행하는 데 필요한 권한만 부여됩니다. 또한 다음과 같은 방법으로 데이터를 보호하는 것이 좋습니다.
+ 각 계정에 멀티 팩터 인증 설정(MFA)을 사용하세요.
+ SSL/TLS를 사용하여 AWS 리소스와 통신하세요. TLS 1.2는 필수이며 TLS 1.3을 권장합니다.
+ AWS CloudTrail로 API 및 사용자 활동 로깅을 설정하세요. AWS 활동 캡처에 CloudTrail 추적을 사용하는 방법에 대한 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 추적 작업](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-trails.html)을 참조하세요.
+ AWS 암호화 솔루션을 AWS 서비스 내의 모든 기본 보안 컨트롤과 함께 사용하세요.
+ Amazon S3에 저장된 민감한 데이터를 검색하고 보호하는 데 도움이 되는 Amazon Macie와 같은 고급 관리형 보안 서비스를 사용하세요.
+ 명령행 인터페이스 또는 API를 통해 AWS에 액세스할 때 FIPS 140-3 검증된 암호화 모듈이 필요한 경우, FIPS 엔드포인트를 사용합니다. 사용 가능한 FIPS 엔드포인트에 대한 자세한 내용은 [Federal Information Processing Standard(FIPS) 140-3](https://aws.amazon.com/compliance/fips/)을 참조하세요.

고객의 이메일 주소와 같은 기밀 정보나 중요한 정보는 태그나 **이름** 필드와 같은 자유 양식 필드에 입력하지 않는 것이 좋습니다. 여기에는 콘솔, API, AWS CLI 또는 AWS SDK를 사용하여 API Gateway 또는 기타 AWS 서비스 서비스에서 작업하는 경우가 포함됩니다. 이름에 사용되는 태그 또는 자유 형식 텍스트 필드에 입력하는 모든 데이터는 청구 또는 진단 로그에 사용될 수 있습니다. 외부 서버로 URL을 제공할 때 해당 서버에 대한 요청을 검증하기 위해 자격 증명 정보를 URL에 포함해서는 안 됩니다.

# Amazon API Gateway에서의 데이터 암호화
<a name="data-protection-encryption"></a>

데이터 보호란 전송 중(API Gateway 안팎으로 데이터가 이동 중)과 유휴 시(에 데이터가 저장된 동안)에 데이터를 보호하는 것을 말합니다AWS

## Amazon API Gateway에서 저장된 데이터 암호화
<a name="data-protection-at-rest"></a>

REST API에 대한 캐싱을 활성화하도록 선택한 경우 캐시 암호화를 활성화할 수 있습니다. 자세한 내용은 [API Gateway의 REST API 캐시 설정](api-gateway-caching.md) 단원을 참조하십시오.

데이터 보호에 대한 자세한 내용은 *AWS 보안 블로그*의 [AWS 공동 책임 모델 및 GDPR](https://aws.amazon.com/blogs/security/the-aws-shared-responsibility-model-and-gdpr/) 블로그 게시물을 참조하세요.

### 인증서 프라이빗 키의 암호화 및 암호 해독
<a name="private-key"></a>

프라이빗 API에 대한 사용자 지정 도메인 이름을 생성하면 별칭 **aws/acm**가 있는 AWS 관리형 KMS 키를 사용하여 ACM 인증서와 프라이빗 키가 암호화됩니다. AWS KMS 콘솔의 **AWS 관리형 키**에서 이 별칭이 포함된 키 ID를 확인할 수 있습니다.

API Gateway는 ACM 리소스에 직접 액세스하지 않습니다. AWS TLS Connection Manager를 사용하여 인증서의 프라이빗 키를 보호하고 액세스합니다. ACM 인증서를 사용하여 프라이빗 API에 대한 API Gateway 사용자 지정 도메인 이름을 생성하면 API Gateway가 인증서를 AWS TLS Connection Manager와 연결합니다. 이렇게 하려면 접두사가 **aws/acm**인 AWS 관리형 키에 대한 권한 부여를 AWS KMS에 생성하면 됩니다. 권한 부여는 TLS 연결 관리자가 암호화 작업에서 KMS 키를 사용할 수 있도록 하는 정책 도구입니다. 권한 부여를 통해 피부여자 보안 주체(TLS 연결 관리자)는 KMS 키에 대해 지정된 권한 부여 작업을 호출해 인증서의 프라이빗 키를 해독할 수 있습니다. 그런 다음 TLS Connection Manager는 인증서와 해독된(일반 텍스트) 프라이빗 키를 사용하여 API Gateway 서비스의 클라이언트와 보안 연결(SSL/TLS 세션)을 설정합니다. 인증서가 프라이빗 API의 API Gateway 사용자 지정 도메인 이름에서 연결 해제되면 권한 부여는 사용 중지됩니다.

KMS 키에 대한 액세스 권한을 제거하려면 AWS CLI에서 AWS Management Console 또는 `update-service` 명령을 사용하여 서비스에서 인증서를 바꾸거나 삭제하는 것이 좋습니다.

### API Gateway의 암호화 컨텍스트
<a name="encryption-context"></a>

[암호화 컨텍스트](https://docs.aws.amazon.com/kms/latest/developerguide/encrypt_context.html)는 프라이빗 키의 사용 용도에 대한 컨텍스트 정보를 포함할 수 있는 선택적 키-값 페어 집합입니다. AWS KMS는 암호화 컨텍스트를 암호화된 데이터에 바인딩하고 이를 추가 인증 데이터로 사용하여 인증된 암호화를 지원합니다.

API Gateway와 TLS 연결 관리자에서 TLS 키를 사용하는 경우, 저장된 키를 암호화하는 데 사용되는 암호화 컨텍스트에 API Gateway 서비스의 이름이 포함됩니다. 다음 섹션과 같이 CloudTrail 로그의 암호화 컨텍스트를 보거나 ACM 콘솔의 **관련 리소스** 탭을 보면 인증서와 프라이빗 키가 사용되는 API Gateway 사용자 지정 도메인 이름을 확인할 수 있습니다.

데이터를 해독하기 위해 동일한 암호화 컨텍스트를 요청에 포함시킵니다. API Gateway는 모든 AWS KMS 암호화 작업에서 동일한 암호화 컨텍스트를 사용합니다. 여기서 키는 `aws:apigateway:arn`이고 값은 API Gateway `PrivateDomainName` 리소스의 Amazon 리소스 이름(ARN)입니다.

다음 예시에서는 작업(예: `CreateGrant`) 출력의 암호화 컨텍스트를 보여줍니다.

```
"constraints": {
"encryptionContextEquals": {
"aws:acm:arn": "arn:aws:acm:us-west-2:859412291086:certificate/9177097a-f0ae-4be1-93b1-19f911ea4f88",
"aws:apigateway:arn": "arn:aws:apigateway:us-west-2:859412291086:/domainnames/denytest-part1.pdx.sahig.people.aws.dev+cbaeumzjhg"
}
},
"operations": [
"Decrypt"
],
"granteePrincipal": "tlsconnectionmanager.amazonaws.com"
```

## Amazon API Gateway에서 전송 중 데이터 암호화
<a name="data-protection-in-transit"></a>

Amazon API Gateway를 통해 생성된 API는 HTTPS 엔드포인트만 제공합니다. API Gateway는 암호화되지 않은(HTTP) 엔드포인트를 지원하지 않습니다.

API Gateway는 기본 `execute-api` 엔드포인트의 인증서를 관리합니다. 사용자 지정 도메인 이름을 구성하는 경우 [도메인 이름에 대한 인증서를 지정](how-to-custom-domains.md#custom-domain-names-certificates)합니다. [인증서를 고정](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting-pinning.html)하지 않는 것이 좋습니다.

보안 강화를 위해 API Gateway 사용자 지정 도메인에 적용할 최소 전송 계층 보안(TLS) 프로토콜 버전을 선택할 수 있습니다. WebSocket API 및 HTTP API는 TLS 1.2만 지원합니다. 자세한 내용은 [API Gateway에서 사용자 지정 도메인에 대한 보안 정책 선택](apigateway-custom-domain-tls-version.md) 단원을 참조하십시오.

계정에서 사용자 정의 SSL 인증서를 사용하여 Amazon CloudFront 배포를 설정하고 리전 API를 통해 사용할 수 있습니다. 그런 다음 보안 및 규정 준수 사항에 따라 TLS 1.1 이상을 사용하는 CloudFront 배포에 대한 보안 정책을 구성할 수 있습니다.

데이터 보호에 대한 자세한 내용은 *AWS 보안 블로그*의 [API Gateway에서 REST API 보호](rest-api-protect.md) 및 [AWS 공동 책임 모델 및 GDPR](https://aws.amazon.com/blogs/security/the-aws-shared-responsibility-model-and-gdpr/) 블로그 게시물을 참조하세요.

# 인터네트워크 트래픽 개인 정보
<a name="security-traffic-privacy"></a>

Amazon API Gateway를 사용하면 Amazon Virtual Private Cloud(VPC)에서만 액세스할 수 있는 프라이빗 REST API를 생성할 수 있습니다. VPC는 VPC에서 생성하는 엔드포인트 네트워크 인터페이스인 [인터페이스 VPC 종단점](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html)를 사용합니다. 여러 AWS 계정은 물론 선택한 VPC 및 VPC 엔드포인트에서 API에 액세스하는 것을 [리소스 정책](apigateway-private-api-create.md#apigateway-private-api-set-up-resource-policy)으로 허용하거나 거부할 수 있습니다. 각 엔드포인트를 사용하여 여러 개의 프라이빗 API에 액세스할 수 있습니다. 또한 Direct Connect를 사용하여 온프레미스 네트워크에서 Amazon VPC에 연결한 다음 그 연결을 통해 프라이빗 API에 액세스할 수도 있습니다. 어떤 경우에든 프라이빗 API로 가는 트래픽은 안전한 연결을 사용하고, Amazon 네트워크를 벗어나지 않으며, 퍼블릭 인터넷과 격리됩니다. 자세한 내용은 [API Gateway의 프라이빗 REST API](apigateway-private-apis.md) 단원을 참조하십시오.