게이트웨이 엔드포인트에 대한 사용자 지정 도메인 이름 설정

기본적으로 게이트웨이 엔드포인트에는 형식으로 AWS관리형 도메인 이름이 제공됩니다<gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com. 프로덕션 환경의 경우 또는 보다 사용자 친화적인 환경을 만들기 위해 게이트웨이 엔드포인트에 사용자 지정 도메인 이름을 사용할 수 있습니다. 이 섹션에서는 Amazon CloudFront를 역방향 프록시로 사용하여 사용자 지정 도메인 이름을 설정하는 방법을 안내합니다.

사전 조건

시작하기 전에 다음을 갖추었는지 확인하세요.

솔루션 개요

이 솔루션에는 다음 구성 요소가 포함됩니다.

다음 단계는 AWS CDK를 사용하여 이러한 구성 요소를 설정하는 방법을 안내합니다.

구현 단계

1단계: Route 53 호스팅 영역 생성

먼저 사용자 지정 도메인에 대한 Route 53 호스팅 영역을 생성합니다.

import { RemovalPolicy } from 'aws-cdk-lib';
import { PublicHostedZone } from 'aws-cdk-lib/aws-route53';

const domainName = 'my.example.com';

const hostedZone = new PublicHostedZone(this, 'HostedZone', {
    zoneName: domainName,
});
this.hostedZone.applyRemovalPolicy(RemovalPolicy.RETAIN);

2단계: DNS 검증 인증서 생성

그런 다음 DNS 검증과 함께 Certificate Manager(ACM)를 사용하여 사용자 지정 도메인에 대한 SSL/TLS AWS 인증서를 생성합니다.

import { RemovalPolicy } from 'aws-cdk-lib';
import { Certificate, CertificateValidation } from 'aws-cdk-lib/aws-certificatemanager';

const certificate = new Certificate(this, 'SSLCertificate', {
    domainName: domainName, // route53 hosted zone domain name from step 1
    validation: CertificateValidation.fromDns(hostedZone), // route53 hosted zone from step 1
});
this.certificate.applyRemovalPolicy(RemovalPolicy.RETAIN);

DNS 검증은 Route 53 호스팅 영역에 필요한 검증 레코드를 자동으로 생성합니다.

3단계: CloudFront 배포 생성

CloudFront 배포를 생성하여 게이트웨이 엔드포인트에 대한 역방향 프록시 역할을 합니다.

import {
  AllowedMethods,
  CachePolicy,
  Distribution,
  OriginProtocolPolicy,
  ViewerProtocolPolicy
} from 'aws-cdk-lib/aws-cloudfront';
import { HttpOrigin } from 'aws-cdk-lib/aws-cloudfront-origins';

const bedrockAgentCoreGatewayHostName = '<mymcpserver>.gateway.bedrock-agentcore.<region>.amazonaws.com'
const bedrockAgentCoreGatewayPath = '/mcp' // can also be left undefined, depending on your requirement

const distribution = new Distribution(this, 'Distribution', {
    defaultBehavior: {
        origin: new HttpOrigin(bedrockAgentCoreGatewayHostName, {
            protocolPolicy: OriginProtocolPolicy.HTTPS_ONLY,
            originPath: bedrockAgentCoreGatewayPath,
        }),
        viewerProtocolPolicy: ViewerProtocolPolicy.HTTPS_ONLY,
        cachePolicy: CachePolicy.CACHING_DISABLED, // important since caching is enabled by default and hence is not suitable for a reverse proxy
        allowedMethods: AllowedMethods.ALLOW_ALL,
    },
    domainNames: [domainName], // route53 hosted zone domain name from step 1
    certificate: certificate, // ssl certificate for the route53 domain from step 2
});

<mymcpserver>를 게이트웨이 ID로 바꾸고를 AWS 리전(예: us-east-1 )<region>으로 바꿉니다.

4단계: Route 53 A 레코드 생성

Route 53 사용자 지정 도메인이 CloudFront 배포를 가리키는 레코드를 생성합니다.

import { ARecord, RecordTarget } from 'aws-cdk-lib/aws-route53';
import { CloudFrontTarget } from 'aws-cdk-lib/aws-route53-targets';

const aRecord = new ARecord(this, 'AliasRecord', {
    zone: hostedZone, // route53 hosted zone from step 1
    recordName: domainName, // route53 hosted zone domain name from step 1
    target: RecordTarget.fromAlias(new CloudFrontTarget(distribution)), // cloudfront distribution from step 3
});

이렇게 하면 사용자 지정 도메인을 CloudFront 배포에 매핑하는 별칭 레코드가 생성됩니다.

5단계: 인프라 배포

CDK 스택을 배포하여 리소스를 생성합니다.

cdk deploy

배포 프로세스는 특히 인증서 검증 및 CloudFront 배포 생성에 다소 시간이 걸릴 수 있습니다.

사용자 지정 도메인 테스트

인프라를 배포한 후 사용자 지정 도메인이 올바르게 구성되었는지 확인합니다.

DNS 확인 확인

dig 명령을 사용하여 사용자 지정 도메인이 CloudFront 배포로 확인되는지 확인합니다.

dig my.example.com

출력에는 도메인이 CloudFront의 IP 주소로 확인되는 것으로 표시되어야 합니다.

SSL 인증서 확인

curl를 사용하여 SSL 인증서가 올바르게 구성되었는지 확인합니다.

curl -v https://my.example.com

출력에는 인증서 오류 없이 성공적인 SSL 핸드셰이크가 표시되어야 합니다.

MCP 클라이언트 구성

사용자 지정 도메인이 설정 및 확인되면 이를 사용하도록 MCP 클라이언트를 구성할 수 있습니다.

커서 구성

커서에서 구성 파일을 업데이트합니다.

{
  "mcpServers": {
    "my-mcp-server": {
      "url": "https://my.example.com"
    }
  }
}

기타 MCP 클라이언트

기본적으로 스트리밍 가능한 HTTP를 지원하지 않는 MCP 클라이언트의 경우:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/path/to/uvx",
        "args": [
            "mcp-proxy",
            "--transport",
            "streamablehttp",
            "https://my.example.com"
        ]
    }
  }
}

추가 고려 사항

문제 해결

결론

Gateway 엔드포인트에 대한 사용자 지정 도메인 이름을 설정하면 애플리케이션의 전문적인 모양이 향상되고 API 엔드포인트를 유연하게 관리할 수 있습니다. 이 가이드에 설명된 단계에 따라 CloudFront를 역방향 프록시로 사용하여 안전하고 신뢰할 수 있는 사용자 지정 도메인 구성을 생성할 수 있습니다.

게이트웨이 기능에 대한 자세한 내용은 Amazon Bedrock AgentCore Gateway: 게이트웨이에 도구 및 기타 리소스를 안전하게 연결을 참조하세요.