Configurando nomes de domínio personalizados para endpoints do Gateway

Por padrão, os endpoints do Gateway são fornecidos com um nome AWS de domínio gerenciado no formato. <gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com Para ambientes de produção ou para criar uma experiência mais fácil de usar, talvez você queira usar um nome de domínio personalizado para o endpoint do gateway. Esta seção orienta você na configuração de um nome de domínio personalizado usando a Amazon CloudFront como proxy reverso.

Pré-requisitos

Antes de começar, verifique se você tem:

Visão geral da solução

A solução envolve os componentes abaixo:

As etapas a seguir guiarão você na configuração desses componentes usando o AWS CDK.

Etapas de implementação

Etapa 1: criar uma zona hospedada do Route 53

Primeiro, crie uma zona hospedada do Route 53 para seu domínio personalizado:

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);

Etapa 2: criar um DNS-validated certificado

Em seguida, crie um SSL/TLS certificado para seu domínio personalizado usando o AWS Certificate Manager (ACM) com validação de DNS:

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);

A validação de DNS cria automaticamente os registros de validação necessários na sua zona hospedada do Route 53.

Etapa 3: criar uma CloudFront distribuição

Crie uma CloudFront distribuição para atuar como um proxy reverso para seu endpoint do Gateway:

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>Substitua por seu ID de gateway e <region> por sua AWS região (por exemplo,us-east-1).

Etapa 4: criar um registro do Route 53 A

Crie um registro do Route 53 A que direcione seu domínio personalizado para a CloudFront distribuição:

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
});

Isso cria um registro de alias que mapeia seu domínio personalizado para a CloudFront distribuição.

Etapa 5: implantar sua infraestrutura

Implante sua pilha de CDK para criar os recursos:

cdk deploy

O processo de implantação pode levar algum tempo, especialmente para a validação do certificado e a criação da CloudFront distribuição.

Testando seu domínio personalizado

Depois de implantar sua infraestrutura, verifique se seu domínio personalizado está configurado corretamente:

Verifique a resolução do DNS

Use o dig comando para verificar se seu domínio personalizado está resolvido para a CloudFront distribuição:

dig my.example.com

A saída deve mostrar que seu domínio resolve para CloudFront endereços IP.

Verifique o certificado SSL

Use curl para verificar se o certificado SSL está configurado corretamente:

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

A saída deve mostrar um handshake SSL bem-sucedido sem erros de certificado.

Configurando clientes MCP

Depois que seu domínio personalizado for configurado e verificado, você poderá configurar seus clientes MCP para usá-lo:

Configuração do cursor

Para Cursor, atualize seu arquivo de configuração:

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

Outros clientes MCP

Para clientes MCP que não oferecem suporte nativo a HTTP simplificável:

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

Considerações adicionais

Solução de problemas

Conclusão

A configuração de um nome de domínio personalizado para seu endpoint do Gateway aprimora a aparência profissional do seu aplicativo e fornece flexibilidade no gerenciamento de seus endpoints de API. Seguindo as etapas descritas neste guia, você pode criar uma configuração de domínio personalizada segura e confiável usando CloudFront como proxy reverso.

Para obter mais informações sobre os recursos e capacidades do Gateway, consulte Amazon Bedrock AgentCore Gateway: conecte ferramentas e outros recursos com segurança ao seu Gateway.