Einrichtung benutzerdefinierter Domainnamen für Gateway-Endpunkte

Standardmäßig werden Gateway-Endpunkte mit einem AWS-verwalteten Domänennamen im folgenden Format bereitgestellt. <gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com Für Produktionsumgebungen oder um ein benutzerfreundlicheres Erlebnis zu schaffen, möchten Sie möglicherweise einen benutzerdefinierten Domainnamen für Ihren Gateway-Endpunkt verwenden. Dieser Abschnitt führt Sie durch die Einrichtung eines benutzerdefinierten Domainnamens mit Amazon CloudFront als Reverse-Proxy.

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

Übersicht über die Lösung

Die Lösung umfasst die folgenden Komponenten:

Die folgenden Schritte führen Sie durch die Einrichtung dieser Komponenten mithilfe von AWS CDK.

Implementierungsschritte

Schritt 1: Erstellen Sie eine Route 53 53-Hosting-Zone

Erstellen Sie zunächst eine Route 53 53-Hosting-Zone für Ihre benutzerdefinierte Domain:

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

Schritt 2: Erstellen Sie ein DNS-validated Zertifikat

Erstellen Sie als Nächstes mithilfe des SSL/TLS Certificate Manager (ACM) mit DNS-Validierung ein AWS Zertifikat für Ihre benutzerdefinierte Domain:

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

Die DNS-Validierung erstellt automatisch die erforderlichen Validierungsdatensätze in Ihrer Route 53 53-Hosting-Zone.

Schritt 3: Erstellen Sie eine CloudFront Distribution

Erstellen Sie eine CloudFront Verteilung, die als Reverse-Proxy für Ihren Gateway-Endpunkt fungiert:

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>Ersetzen Sie es durch Ihre Gateway-ID und <region> durch Ihre AWS Region (z. B.us-east-1).

Schritt 4: Erstellen Sie einen Route 53 A-Datensatz

Erstellen Sie einen Route 53 A-Datensatz, der Ihre benutzerdefinierte Domain auf die CloudFront Verteilung verweist:

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

Dadurch wird ein Alias-Datensatz erstellt, der Ihre benutzerdefinierte Domain der CloudFront Distribution zuordnet.

Schritt 5: Stellen Sie Ihre Infrastruktur bereit

Stellen Sie Ihren CDK-Stack bereit, um die Ressourcen zu erstellen:

cdk deploy

Der Bereitstellungsprozess kann einige Zeit in Anspruch nehmen, insbesondere für die Zertifikatsvalidierung und die Erstellung der CloudFront Verteilung.

Testen Sie Ihre benutzerdefinierte Domain

Stellen Sie nach der Bereitstellung Ihrer Infrastruktur sicher, dass Ihre benutzerdefinierte Domain ordnungsgemäß konfiguriert ist:

Überprüfen Sie die DNS-Auflösung

Verwenden Sie den dig Befehl, um zu überprüfen, ob Ihre benutzerdefinierte Domain in die CloudFront Distribution aufgelöst wird:

dig my.example.com

Die Ausgabe sollte zeigen, dass Ihre Domain in die IP-Adressen aufgelöst CloudFront wird.

Überprüfen Sie das SSL-Zertifikat

Verwenden Sie diese Option, curl um zu überprüfen, ob das SSL-Zertifikat ordnungsgemäß konfiguriert ist:

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

Die Ausgabe sollte einen erfolgreichen SSL-Handshake ohne Zertifikatsfehler anzeigen.

Konfiguration von MCP-Clients

Sobald Ihre benutzerdefinierte Domain eingerichtet und verifiziert ist, können Sie Ihre MCP-Clients so konfigurieren, dass sie sie verwenden:

Cursor-Konfiguration

Aktualisieren Sie für Cursor Ihre Konfigurationsdatei:

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

Andere MCP-Clients

Für MCP-Clients, die streambares HTTP nicht nativ unterstützen:

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

Weitere Überlegungen

Fehlerbehebung

Schlussfolgerung

Die Einrichtung eines benutzerdefinierten Domainnamens für Ihren Gateway-Endpunkt verbessert das professionelle Erscheinungsbild Ihrer Anwendung und bietet Flexibilität bei der Verwaltung Ihrer API-Endpunkte. Wenn Sie die in diesem Handbuch beschriebenen Schritte befolgen, können Sie eine sichere und zuverlässige benutzerdefinierte Domänenkonfiguration CloudFront als Reverse-Proxy erstellen.

Weitere Informationen zu den Funktionen und Fähigkeiten von Gateway finden Sie unter Amazon Bedrock AgentCore Gateway: Sicheres Verbinden von Tools und anderen Ressourcen mit Ihrem Gateway.