Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verbindung zu privat gehosteten Tools herstellen

Übersicht über private Verbindungen

AWS DevOps Der Agent kann mit benutzerdefinierten Model Context Protocol (MCP) -Tools und anderen Integrationen erweitert werden, die dem Agenten Zugriff auf interne Systeme wie private Paketregister, selbst gehostete Observability-Plattformen, interne Dokumentation APIs und Quellcodeverwaltungsinstanzen gewähren (siehe:). Funktionen für den AWS DevOps Agenten konfigurieren Diese Dienste werden häufig in einer Amazon Virtual Private Cloud (Amazon VPC) mit eingeschränktem oder keinem öffentlichen Internetzugang ausgeführt, was bedeutet, dass der AWS DevOps Agent sie standardmäßig nicht erreichen kann.

Private Verbindungen für AWS DevOps Agenten ermöglichen es Ihnen, Ihren Agent Space sicher mit Diensten zu verbinden, die in Ihrer VPC ausgeführt werden, ohne sie dem öffentlichen Internet auszusetzen. Private Verbindungen funktionieren mit jeder Integration, die einen privaten Endpunkt erreichen muss, einschließlich MCP-Servern, selbst gehosteten Grafana- oder Splunk-Instanzen und Quellcodeverwaltungssystemen wie GitHub Enterprise Server und Self-Managed. GitLab

Wie funktionieren private Verbindungen

Eine private Verbindung erstellt einen sicheren Netzwerkpfad zwischen dem AWS DevOps Agenten und einer Zielressource in Ihrer VPC. Unter der Haube verwendet AWS DevOps Agent Amazon VPC Lattice, um diesen sicheren privaten Konnektivitätspfad einzurichten. VPC Lattice ist ein Anwendungsnetzwerkdienst, mit dem Sie die Kommunikation zwischen Anwendungen über Konten und Rechnertypen hinweg verbinden VPCs, sichern und überwachen können, ohne die zugrunde liegende Netzwerkinfrastruktur verwalten zu müssen.

Wenn Sie eine private Verbindung herstellen, passiert Folgendes:

Das Ressourcen-Gateway wird vollständig vom AWS DevOps Agenten verwaltet und erscheint als schreibgeschützte Ressource in Ihrem Konto (benanntaidevops-{your-private-connection-name}). Sie müssen es nicht konfigurieren oder verwalten. Die einzigen Ressourcen, die in Ihrer VPC erstellt werden, befinden sich ENIs in den von Ihnen angegebenen Subnetzen. Diese ENIs dienen als Einstiegspunkt für privaten Datenverkehr und werden vollständig vom Service verwaltet. Sie akzeptieren keine eingehenden Verbindungen aus dem Internet, und Sie behalten über Ihre eigenen Sicherheitsgruppen die volle Kontrolle über ihren Datenverkehr.

Sicherheit

Private Verbindungen sind mit mehreren Sicherheitsebenen konzipiert:

Architektur

Das folgende Diagramm zeigt den Netzwerkpfad für eine private Verbindung.

In dieser Architektur:

Erstellen Sie eine private Verbindung

Sie können mit der AWS Management Console oder der AWS CLI eine private Verbindung herstellen.

Voraussetzungen

Bevor Sie eine private Verbindung herstellen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Private Verbindungen sind Ressourcen auf Kontoebene. Nachdem Sie eine private Verbindung erstellt haben, können Sie sie für mehrere Integrationen und Agent Spaces wiederverwenden, die denselben Host erreichen müssen.

Erstellen Sie mithilfe der Konsole eine private Verbindung

Der Verbindungsstatus ändert sich zu Create in progress. Dieser Vorgang kann bis zu 10 Minuten dauern. Wenn der Status auf Aktiv wechselt, ist der Netzwerkpfad bereit.

Wenn sich der Status in Create failed ändert, überprüfen Sie Folgendes:

Erstellen Sie eine private Verbindung mit der AWS CLI

Führen Sie den folgenden Befehl aus, um eine private Verbindung herzustellen. Ersetzen Sie die Platzhalterwerte durch Ihre eigenen.

aws devops-agent create-private-connection \
    --name my-mcp-tool-connection \
    --mode '{
        "serviceManaged": {
            "hostAddress": "mcp.internal.example.com",
            "vpcId": "vpc-0123456789abcdef0",
            "subnetIds": [
                "subnet-0123456789abcdef0",
                "subnet-0123456789abcdef1"
            ],
            "securityGroupIds": [
                "sg-0123456789abcdef0"
            ],
            "portRanges": ["443"]
        }
    }'

Die Antwort enthält den Verbindungsnamen und den folgenden Status: CREATE_IN_PROGRESS

{
    "name": "my-mcp-tool-connection",
    "status": "CREATE_IN_PROGRESS",
    "resourceGatewayId": "rgw-0123456789abcdef0",
    "hostAddress": "mcp.internal.example.com",
    "vpcId": "vpc-0123456789abcdef0"
}

Verwenden Sie den folgenden describe-private-connection Befehl, um den Verbindungsstatus zu überprüfen:

aws devops-agent describe-private-connection \
    --name my-mcp-tool-connection

Wenn der Status lautetACTIVE, ist Ihre private Verbindung einsatzbereit.

Verwenden Sie eine private Verbindung mit einem Capability Provider

Um eine private Verbindung zu verwenden, können Sie bei der Registrierung eines Capability Providers eine Verbindung zu dieser herstellen. Zu den unterstützten Funktionen, die mit privaten Verbindungen verwendet werden könnenGitHub, gehören:GitLab,MCP Server, undGrafana. Sie können diesen Schritt mit der AWS Management Console oder der AWS CLI ausführen.

Verwenden Sie über die Konsole eine private Verbindung mit einem Capability Provider

In der AWS DevOps Agentenkonsole können private Verbindungen während der Registrierung mit einer Funktion verknüpft werden, indem die Option „Über eine private Verbindung mit Endpunkt Connect“ ausgewählt wird.

Verwenden Sie mithilfe der AWS CLI eine private Verbindung mit einem Capability Provider

Sie können Capabilities mit einer privaten Verbindung registrieren, indem Sie das private-connection-name Argument angeben. Im Folgenden finden Sie ein Beispiel für die Registrierung eines MCP-Servers mit API-Schlüsselautorisierung über die my-mcp-tool-connection private Verbindung. Ersetzen Sie die Platzhalterwerte durch Ihre eigenen.

aws devops-agent register-service \
    --service mcpserver \
    --private-connection-name my-mcp-tool-connection \
    --service-details '{
        "mcpserver": {
            "name": "my-mcp-tool",
            "endpoint": "https://mcp.internal.example.com",
            "authorizationConfig": {
                "apiKey": {
                    "apiKeyName": "api-key",
                    "apiKeyValue": "secret-value",
                    "apiKeyHeader": "x-api-key"
                }
            }
        }
    }' \
    --region us-east-1

Überprüfen Sie eine private Verbindung

Nachdem die private Verbindung den Status Aktiv erreicht hat und von einem Capability Provider genutzt wurde, stellen Sie sicher, dass der AWS DevOps Agent Ihren Zieldienst erreichen kann:

Wenn die Verbindung fehlschlägt, überprüfen Sie Folgendes:

Löschen Sie eine private Verbindung

Sie können ungenutzte private Verbindungen mit der AWS Management Console oder der AWS CLI löschen.

Löschen Sie eine private Verbindung mithilfe der Konsole

Die private Verbindung wird mit dem Status „Verbindung wird entfernt“ angezeigt, während der AWS DevOps Agent das verwaltete Ressourcen-Gateway und ENIs aus Ihrer VPC entfernt. Nach Abschluss des Löschvorgangs erscheint die Verbindung nicht mehr in Ihrer Liste der privaten Verbindungen.

Löschen Sie eine private Verbindung mit der AWS CLI

aws devops-agent delete-private-connection \
    --name my-mcp-tool-connection

Die Antwort gibt den Status von zurückDELETE_IN_PROGRESS. AWS DevOps Der Agent entfernt das verwaltete Ressourcen-Gateway und ENIs aus Ihrer VPC. Nach Abschluss des Löschvorgangs erscheint die Verbindung nicht mehr in Ihrer Liste der privaten Verbindungen.

Erweitertes Setup unter Verwendung vorhandener VPC-Lattice-Ressourcen

Wenn Ihre Organisation bereits Amazon VPC Lattice verwendet und Ihre eigenen Ressourcenkonfigurationen verwaltet, können Sie im selbstverwalteten Modus eine private Verbindung erstellen. Anstatt den AWS DevOps Agenten ein Ressourcen-Gateway für Sie erstellen zu lassen, geben Sie den Amazon-Ressourcennamen (ARN) einer vorhandenen Ressourcenkonfiguration an, die auf Ihren Zielservice verweist.

Dieser Ansatz ist nützlich, wenn Sie:

So erstellen Sie eine selbstverwaltete private Verbindung mit der AWS CLI:

aws devops-agent create-private-connection \
    --name my-advanced-connection \
    --mode '{
        "selfManaged": {
            "resourceConfigurationId": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-0123456789abcdef0"
        }
    }'

Weitere Informationen zur Einrichtung von VPC Lattice-Ressourcen-Gateways und Ressourcenkonfigurationen finden Sie im Amazon VPC Lattice-Benutzerhandbuch.

Verwandte Themen