Configuración de nombres de dominio personalizados para los puntos finales de Gateway

De forma predeterminada, los puntos de enlace de Gateway se proporcionan con un nombre de dominio AWS administrado en este formato. <gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com Para los entornos de producción o para crear una experiencia más fácil de usar, es posible que desee utilizar un nombre de dominio personalizado para el punto de enlace de su puerta de enlace. Esta sección lo guía a través de la configuración de un nombre de dominio personalizado utilizando Amazon CloudFront como proxy inverso.

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

Información general de la solución

La solución implica los siguientes componentes:

Los siguientes pasos le guiarán en la configuración de estos componentes mediante AWS CDK.

Pasos para la implementación

Paso 1: Crear una zona alojada en Route 53

En primer lugar, cree una zona alojada de Route 53 para su dominio 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);

Paso 2: Crea un DNS-validated certificado

A continuación, cree un SSL/TLS certificado para su dominio personalizado mediante AWS Certificate Manager (ACM) con validación 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);

La validación de DNS crea automáticamente los registros de validación necesarios en la zona alojada de Route 53.

Paso 3: Crear una CloudFront distribución

Cree una CloudFront distribución que actúe como proxy inverso para su punto final de 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>Sustitúyalo por el ID de tu puerta <region> de enlace y por tu AWS región (p. ej.,us-east-1).

Paso 4: Crear un registro de Route 53 A

Cree un registro de Route 53 A que dirija su dominio personalizado a la CloudFront distribución:

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

Esto crea un registro de alias que asigna tu dominio personalizado a la CloudFront distribución.

Paso 5: Implemente su infraestructura

Implemente su pila de CDK para crear los recursos:

cdk deploy

El proceso de implementación puede llevar algún tiempo, especialmente para la validación del certificado y la creación de la CloudFront distribución.

Probar tu dominio personalizado

Tras implementar la infraestructura, compruebe que el dominio personalizado esté configurado correctamente:

Verifica la resolución del DNS

Usa el dig comando para comprobar que tu dominio personalizado se resuelve en la CloudFront distribución:

dig my.example.com

El resultado debería mostrar que tu dominio se resuelve en las direcciones IP. CloudFront

Verifica el certificado SSL

curlÚselo para comprobar que el certificado SSL está configurado correctamente:

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

El resultado debería mostrar un protocolo de enlace SSL correcto sin errores de certificado.

Configuración de clientes MCP

Una vez que haya configurado y verificado su dominio personalizado, puede configurar sus clientes MCP para que lo usen:

Configuración del cursor

Para Cursor, actualice el archivo de configuración:

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

Otros clientes MCP

Para los clientes MCP que no admiten HTTP transmisible de forma nativa:

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

Consideraciones adicionales

Resolución de problemas

Conclusión

La configuración de un nombre de dominio personalizado para el punto de conexión de Gateway mejora el aspecto profesional de la aplicación y proporciona flexibilidad a la hora de gestionar los puntos de enlace de la API. Si sigue los pasos descritos en esta guía, puede crear una configuración de dominio personalizada segura y fiable utilizando CloudFront un proxy inverso.

Para obtener más información sobre las funciones y capacidades de Gateway, consulte Amazon Bedrock AgentCore Gateway: conecte herramientas y otros recursos de forma segura a su puerta de enlace.