Configurazione di nomi di dominio personalizzati per gli endpoint Gateway

Per impostazione predefinita, agli endpoint Gateway viene fornito un nome AWS di dominio gestito nel formato. <gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com Per gli ambienti di produzione o per creare un'esperienza più intuitiva, potresti voler utilizzare un nome di dominio personalizzato per l'endpoint gateway. Questa sezione ti guida nella configurazione di un nome di dominio personalizzato utilizzando Amazon CloudFront come proxy inverso.

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

Panoramica della soluzione

La soluzione prevede i seguenti componenti:

I seguenti passaggi ti guideranno nella configurazione di questi componenti utilizzando AWS CDK.

Passaggi dell’implementazione

Fase 1: Creare una zona ospitata sulla Route 53

Innanzitutto, crea una zona ospitata Route 53 per il tuo dominio personalizzato:

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

Fase 2: Creare un certificato DNS-validated

Successivamente, crea un SSL/TLS certificato per il tuo dominio personalizzato utilizzando AWS Certificate Manager (ACM) con convalida 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 convalida DNS crea automaticamente i record di convalida necessari nella zona ospitata da Route 53.

Fase 3: Creare una distribuzione CloudFront

Crea una CloudFront distribuzione che funga da reverse proxy per il tuo endpoint 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
});

Sostituiscilo <mymcpserver> con il tuo ID gateway e <region> con la tua AWS regione (ad es.us-east-1).

Fase 4: Creare un record Route 53 A

Crea un record Route 53 A che indirizza il tuo dominio personalizzato alla CloudFront distribuzione:

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

Questo crea un record di alias che associa il tuo dominio personalizzato alla CloudFront distribuzione.

Fase 5: Implementa la tua infrastruttura

Implementa il tuo stack CDK per creare le risorse:

cdk deploy

Il processo di distribuzione potrebbe richiedere del tempo, in particolare per la convalida dei certificati e la creazione della distribuzione. CloudFront

Verifica del tuo dominio personalizzato

Dopo aver distribuito l'infrastruttura, verifica che il dominio personalizzato sia configurato correttamente:

Verifica la risoluzione DNS

Usa il dig comando per verificare che il tuo dominio personalizzato corrisponda alla distribuzione: CloudFront

dig my.example.com

L'output dovrebbe mostrare che il tuo dominio si risolve negli indirizzi IP. CloudFront

Verifica il certificato SSL

Utilizza curl per verificare che il certificato SSL sia configurato correttamente:

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

L'output dovrebbe mostrare un handshake SSL riuscito senza errori di certificato.

Configurazione dei client MCP

Una volta impostato e verificato il dominio personalizzato, puoi configurare i tuoi client MCP per utilizzarlo:

Configurazione del cursore

Per Cursor, aggiorna il file di configurazione:

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

Altri client MCP

Per i client MCP che non supportano nativamente lo streaming HTTP:

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

Ulteriori considerazioni

Risoluzione dei problemi

Conclusioni

La configurazione di un nome di dominio personalizzato per l'endpoint Gateway migliora l'aspetto professionale dell'applicazione e offre flessibilità nella gestione degli endpoint API. Seguendo i passaggi descritti in questa guida, è possibile creare una configurazione di dominio personalizzata sicura e affidabile utilizzando CloudFront come proxy inverso.

Per ulteriori informazioni sulle caratteristiche e funzionalità del gateway, consulta Amazon Bedrock AgentCore Gateway: collega in modo sicuro strumenti e altre risorse al tuo gateway.