Menyiapkan nama domain khusus untuk titik akhir Gateway

Secara default, titik akhir Gateway disediakan dengan nama domain AWS-managed dalam format. <gateway-id>.gateway.bedrock-agentcore.<region>.amazonaws.com Untuk lingkungan produksi atau untuk menciptakan pengalaman yang lebih ramah pengguna, Anda mungkin ingin menggunakan nama domain khusus untuk titik akhir gateway Anda. Bagian ini memandu Anda melalui pengaturan nama domain khusus menggunakan Amazon CloudFront sebagai proxy terbalik.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki:

Ikhtisar solusi

Solusinya melibatkan komponen berikut:

Langkah-langkah berikut akan memandu Anda melalui pengaturan komponen ini menggunakan AWS CDK.

Langkah-langkah implementasi

Langkah 1: Buat zona yang dihosting Route 53

Pertama, buat zona yang dihosting Route 53 untuk domain kustom Anda:

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

Langkah 2: Buat DNS-validated sertifikat

Selanjutnya, buat SSL/TLS sertifikat untuk domain kustom Anda menggunakan AWS Certificate Manager (ACM) dengan validasi 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);

Validasi DNS secara otomatis membuat catatan validasi yang diperlukan di zona host Route 53 Anda.

Langkah 3: Buat CloudFront distribusi

Buat CloudFront distribusi untuk bertindak sebagai proxy terbalik untuk titik akhir Gateway Anda:

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

Ganti <mymcpserver> dengan ID gateway Anda dan <region> dengan AWS Wilayah Anda (mis.,us-east-1).

Langkah 4: Buat catatan Route 53 A

Buat Route 53 Catatan yang mengarahkan domain kustom Anda ke CloudFront distribusi:

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

Ini membuat catatan alias yang memetakan domain kustom Anda ke CloudFront distribusi.

Langkah 5: Menyebarkan infrastruktur Anda

Terapkan tumpukan CDK Anda untuk membuat sumber daya:

cdk deploy

Proses penyebaran mungkin memakan waktu, terutama untuk validasi sertifikat dan pembuatan CloudFront distribusi.

Menguji domain kustom Anda

Setelah menerapkan infrastruktur Anda, verifikasi bahwa domain kustom Anda dikonfigurasi dengan benar:

Verifikasi resolusi DNS

Gunakan dig perintah untuk memverifikasi bahwa domain kustom Anda menyelesaikan distribusi: CloudFront

dig my.example.com

Output harus menunjukkan bahwa domain Anda menyelesaikan ke CloudFront alamat IP.

Verifikasi sertifikat SSL

Gunakan curl untuk memverifikasi bahwa sertifikat SSL dikonfigurasi dengan benar:

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

Output harus menunjukkan jabat tangan SSL yang berhasil tanpa kesalahan sertifikat.

Mengkonfigurasi klien MCP

Setelah domain kustom Anda disiapkan dan diverifikasi, Anda dapat mengonfigurasi klien MCP Anda untuk menggunakannya:

Konfigurasi kursor

Untuk Kursor, perbarui file konfigurasi Anda:

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

Klien MCP lainnya

Untuk klien MCP yang tidak mendukung HTTP yang dapat dirampingkan secara native:

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

Pertimbangan tambahan

Pemecahan masalah

Kesimpulan

Menyiapkan nama domain khusus untuk titik akhir Gateway meningkatkan tampilan profesional aplikasi Anda dan memberikan fleksibilitas dalam mengelola titik akhir API Anda. Dengan mengikuti langkah-langkah yang diuraikan dalam panduan ini, Anda dapat membuat konfigurasi domain kustom yang aman dan andal menggunakan CloudFront sebagai proxy terbalik.

Untuk informasi selengkapnya tentang fitur dan kemampuan Gateway, lihat Amazon Bedrock AgentCore Gateway: Menghubungkan alat dan sumber daya lainnya dengan aman ke Gateway Anda.