Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 il tuo 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 passaggi seguenti ti guideranno nella configurazione di questi componenti tramite AWS CDK.

Passaggi dell’implementazione

Fase 1: Creare una zona ospitata su Route 53

Innanzitutto, crea una zona ospitata su 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

Quindi, 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 di Route 53.

Fase 3: Creare una distribuzione CloudFront

Crea una CloudFront distribuzione che funga da proxy inverso 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 esempious-east-1).

Fase 4: Creare un record Route 53 A

Crea un record Route 53 A che indirizzi 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 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 del certificato e la creazione della distribuzione. CloudFront

Testare il dominio personalizzato

Dopo aver implementato 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 si risolva nella distribuzione: CloudFront

dig my.example.com

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

Verifica il certificato SSL

Utilizzalo 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 l'HTTP in streaming:

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

Ulteriori considerazioni

Risoluzione dei problemi

Conclusioni

L'impostazione 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, puoi creare una configurazione di dominio personalizzata sicura e affidabile utilizzando CloudFront un proxy inverso.

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