기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# GraphQL 및 실시간 API에 대한 사용자 지정 도메인 이름 구성
AWS AppSync를 사용하면 사용자 지정 도메인 이름을 사용하여 GraphQL 및 실시간 APIs 모두에서 작동하는 기억하기 쉬운 단일 도메인을 구성할 수 있습니다.
즉, 계정의 AWS AppSync APIs와 연결하는 사용자 지정 도메인 이름을 생성하여 선택한 도메인 이름이 있는 간단하고 기억하기 쉬운 엔드포인트 URLs을 활용할 수 있습니다.
AWS AppSync API를 구성하면 두 개의 엔드포인트가 프로비저닝됩니다.
**AWS AppSync GraphQL 엔드포인트:**
`https://example1234567890000.appsync-api.us-east-1.amazonaws.com/graphql`
**AWS AppSync 실시간 엔드포인트:**
`wss://example1234567890000.appsync-realtime-api.us-east-1.amazonaws.com/graphql`
사용자 지정 도메인 이름을 사용하면 하나의 도메인을 사용하여 두 엔드포인트와 모두 상호 작용할 수 있습니다. 예를 들어 `api.example.com`을 사용자 지정 도메인으로 구성하면 다음 URL을 사용하여 GraphQL 및 실시간 엔드포인트와 상호 작용할 수 있습니다.
**AWS AppSync 사용자 지정 도메인 GraphQL 엔드포인트:**
`https://api.example.com/graphql`
**AWS AppSync 사용자 지정 도메인 실시간 엔드포인트:**
`wss://api.example.com/graphql/realtime`
**참고**
AWS AppSync APIs 사용자 지정 도메인 이름에 대해 TLS 1.2 및 TLS 1.3만 지원합니다.
## 도메인 이름 등록 및 구성
AWS AppSync APIs에 대한 사용자 지정 도메인 이름을 설정하려면 등록된 인터넷 도메인 이름이 있어야 합니다. Amazon Route 53 domain registration 을 사용하거나 원하는 타사 도메인 등록부를 사용하여 인터넷 도메인을 등록할 수 있습니다. Route 53에 대한 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Amazon Route 53이란 무엇인가요?](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/)를 참조하세요.
API의 사용자 지정 도메인 이름은 하위 도메인의 이름이거나 등록된 인터넷 도메인의 루트 도메인(‘zone apex’라고도 함) 이름일 수 있습니다. AWS AppSync에서 사용자 지정 도메인 이름을 생성한 후에는 DNS 공급자의 리소스 레코드를 생성하거나 업데이트하여 API 엔드포인트에 매핑해야 합니다. 이 매핑이 없으면 사용자 지정 도메인 이름에 바인딩된 API 요청이 AWS AppSync에 도달할 수 없습니다.
## AWS AppSync에서 사용자 지정 도메인 이름 생성
AWS AppSync API에 대한 사용자 지정 도메인 이름을 생성하면 Amazon CloudFront 배포가 설정됩니다. 사용자 지정 도메인 이름을 CloudFront 배포 도메인 이름에 매핑하려면 DNS 레코드를 설정해야 합니다. 이 매핑은 매핑된 CloudFront 배포를 통해 사용자 지정 도메인 이름 AWS AppSync에 바인딩된 API 요청을 라우팅하는 데 필요합니다. 또한 사용자 지정 도메인 이름에 대한 인증서를 제출해야 합니다.
사용자 지정 도메인 이름을 설정하거나 인증서를 업데이트하려면 CloudFront 배포를 업데이트하고 사용하려는 AWS Certificate Manager (ACM) 인증서를 설명할 수 있는 권한이 있어야 합니다. 이러한 권한을 부여하려면 계정의 IAM 사용자, 그룹 또는 역할에 다음 AWS Identity and Access Management (IAM) 정책 설명을 연결합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowUpdateDistributionForAppSyncCustomDomainName",
"Effect": "Allow",
"Action": [
"cloudfront:updateDistribution"
],
"Resource": [
"*"
]
},
{
"Sid": "AllowDescribeCertificateForAppSyncCustomDomainName",
"Effect": "Allow",
"Action": "acm:DescribeCertificate",
"Resource": "arn:aws:acm:us-east-1:111122223333:certificate/certificate-id"
}
]
}
```
------
AWS AppSync는 CloudFront 배포에서 서버 이름 표시(SNI)를 활용하여 사용자 지정 도메인 이름을 지원합니다. 필요한 인증서 형식 및 최대 인증서 키 길이를 포함하여 CloudFront 배포에서 사용자 지정 도메인 이름을 사용하는 방법에 대한 자세한 내용은 *Amazon CloudFront 개발자 안내서*의 [CloudFront에서 HTTPS 사용](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https.html)을 참조하세요.
사용자 지정 도메인 이름을 API의 호스트 이름으로 설정하려면 API 소유자가 사용자 지정 도메인 이름을 포함하는 `us-east-1` *AWS 리전(미국 동부(버지니아 북부))*에서 퍼블릭 또는 가져온 ACM 인증서를 제공해야 합니다. ACM에 대한 자세한 내용은 *AWS Certificate Manager 사용 설명서*에서 [AWS Certificate Manager이란 무엇인가요?](https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html)를 참조하세요.
## AWS AppSync의 와일드카드 사용자 지정 도메인 이름
AWS AppSync는 와일드카드 사용자 지정 도메인 이름을 지원합니다. 와일드카드 사용자 지정 도메인 이름을 구성하려면 와일드카드 문자(`*`)를 사용자 지정 도메인의 첫 번째 하위 도메인으로 지정하세요. 이는 루트 도메인의 가능한 모든 하위 도메인을 나타냅니다. 예를 들어 `*.example.com`을 와일드카드 사용자 지정 도메인 이름으로 사용하면 `a.example.com`, `b.example.com` 및 `c.example.com` 등이 하위 도메인이 됩니다. 이러한 모든 하위 도메인은 동일한 도메인으로 라우팅됩니다.
AWS AppSync에서 와일드카드 사용자 지정 도메인 이름을 사용하려면 동일한 도메인의 여러 사이트를 보호할 수 있는 와일드카드 이름이 포함된 ACM에서 발급한 인증서를 제공해야 합니다. 자세한 내용은 *AWS Certificate Manager 사용 설명서*의 [ACM 인증서 특성](https://docs.aws.amazon.com/acm/latest/userguide/acm-certificate.html)을 참조하세요.