Richten Sie die eingehende Autorisierung für Ihr Gateway ein

Bevor Sie Ihr Gateway erstellen, müssen Sie die eingehende Autorisierung einrichten. Bei der eingehenden Autorisierung werden Benutzer validiert, die versuchen, über Ihr Gateway auf Ziele zuzugreifen. AgentCore AgentCore unterstützt die folgenden Arten der eingehenden Autorisierung:

Wenn Sie nicht vorhaben, die standardmäßige Autorisierungskonfiguration mit Amazon Cognito zu verwenden, wählen Sie das Thema aus, das dem Autorisierungstyp entspricht, den Sie verwenden möchten, um zu erfahren, wie Sie ihn einrichten können:

IAM-based eingehende Autorisierung

IAM-based Bei der eingehenden Autorisierung können Sie die IAM-Anmeldeinformationen des Gateway-Aufrufers für die Autorisierung verwenden. Sie können diese Option verwenden, wenn Sie eine IAM-Identität erstellen möchten, über die Benutzer, die Ihr Gateway anrufen, authentifiziert werden können.

Um die Autorisierung für eingehenden Datenverkehr einzurichten IAM-based

Beispiel für eine Richtlinie

Das folgende Beispiel zeigt eine Richtlinie, die Sie an eine Identität anhängen könnten, damit sie ein Gateway mit der ID aufrufen kann my-gateway-12345

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowGatewayInvocation",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:InvokeGateway"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/my-gateway-12345"
      ]
    }
  ]
}

Ressourcen

Auf JSON Web Token (JWT) basierende eingehende Autorisierung

Ein JSON Web Token (JWT) ist ein sicheres und kompaktes Token, das für die Autorisierung verwendet wird. Sie können ein JWT mit einem unterstützten Identitätsanbieter erstellen. Nachdem Sie ein JWT erstellt haben, können Sie es abrufen und bei der Erstellung des Gateways als Autorisierungskonfiguration angeben.

Sie können die AgentCore CLI verwenden, um ein Standard-JWT einzurichten, oder eines manuell mit einem unterstützten Identitätsanbieter erstellen. Um mehr über die verschiedenen Methoden zum Einrichten eines JWT zu erfahren, wählen Sie eines der folgenden Themen aus:

Richten Sie ein Standard-JWT ein

Mit der AgentCore CLI können Sie mit Amazon Cognito auf einfache Weise eine Standardautorisierungskonfiguration erstellen, die Sie dann beim Erstellen eines Gateways verwenden können. Bei der Ausführung fordert Sie die CLI aufagentcore create, die eingehende Autorisierung zu konfigurieren, und kann automatisch einen Amazon Cognito Cognito-Benutzerpool für Sie einrichten.

agentcore create

Nach Abschluss des Befehls stellt die AgentCore CLI Authentifizierungs- und Autorisierungsinformationen bereit:

Richten Sie ein JWT manuell ein

Amazon Bedrock AgentCore unterstützt JWTs von allen Identitätsanbietern. Einige Beispiele finden Sie unter Einrichtung und Konfiguration des Anbieters.

Notieren Sie sich bei der Erstellung des JWT die folgenden Werte, die Sie CustomJWTAuthorizerConfigurationbei der Erstellung eines Gateways ausfüllen müssen, sofern sie für Ihren Anwendungsfall relevant sind:

Sie benötigen diese Werte, um Folgendes zu tun:

Umfang der Werbung bei Authentifizierungsherausforderungen

Wenn ein Client eine Anfrage ohne gültiges Zugriffstoken an ein JWT-authorized Gateway sendet, gibt das Gateway eine Fehlerantwort mit einem WWW-Authenticate Header zurück, der die erforderlichen OAuth-Bereiche ankündigt. Dies entspricht dem RFC 6750 Bearer Token Challenge-Format und ermöglicht es MCP-compliant Clients, automatisch die Bereiche zu ermitteln, die für den Token-Erwerb benötigt werden.

Das Gateway gibt je nach Fehler die folgenden Antworten zurück:

Der scope Wert enthält die durch Leerzeichen getrennten Bereiche, die in den Bereichen des Gateways als Zulässige Bereiche konfiguriert sind. CustomJWTAuthorizerConfiguration Der resource_metadata Wert verweist auf das Dokument OAuth Protected Resource Metadata des Gateways unter, das Clients abrufen können/.well-known/oauth-protected-resource, um den Autorisierungsserver und die unterstützten Bereiche zu ermitteln.

Verwenden Sie einen privaten () Identitätsanbieter VPC-hosted

AgentCore Gateway unterstützt JWT-based eingehende Autorisierung mit Identitätsanbietern, die in Ihrer VPC gehostet werden. Sie können eine privateEndpoint Option konfigurieren, customJWTAuthorizer um Ihre privaten OIDC-Discovery-, Token- und JWKS-Endpunkte AgentCore zu erreichen, ohne sie dem öffentlichen Internet zugänglich zu machen.

Ihr IAM-Prinzipal muss über die entsprechenden iam:CreateServiceLinkedRole Berechtigungen verfügenidentity-network.bedrock-agentcore.amazonaws.com, damit AgentCore Identity die AWSServiceRoleForBedrockAgentCoreIdentity serviceverknüpfte Rolle in Ihrem Namen erstellen kann, falls sie noch nicht vorhanden ist.

Das privateEndpoint gilt für die Domain in der. discoveryUrl Wenn Ihr Identitätsanbieter andere Domänen für andere Endpunkte verwendet (z. B. wird der Token- oder JWKS-Endpunkt in eine andere Domäne aufgelöst als die Discovery-URL), verwenden Sie diese Option, privateEndpointOverrides um für jede weitere Domäne eine separate private Endpunktkonfiguration anzugeben.

Im folgenden Beispiel wird mithilfe von Managed Lattice ein Gateway mit einem privaten Identitätsanbieter erstellt:

{
  "name": "my-private-idp-gateway",
  "protocolType": "MCP",
  "roleArn": "arn:aws:iam::123456789012:role/my-gateway-role",
  "authorizerType": "CUSTOM_JWT",
  "authorizerConfiguration": {
    "customJWTAuthorizer": {
      "allowedAudience": [
        "my-audience"
      ],
      "discoveryUrl": "https://my-idp.internal.example.com/.well-known/openid-configuration",
      "privateEndpoint": {
        "managedVpcResource": {
          "vpcIdentifier": "vpc-0abc123def456",
          "subnetIds": ["subnet-0abc123", "subnet-0def456"],
          "endpointIpAddressType": "IPV4",
          "securityGroupIds": ["sg-0abc123def"]
        }
      }
    }
  }
}

Wenn Ihre Token- oder JWKS-Endpunkte eine andere Domain als die Discovery-URL verwenden, fügen Sie für jede weitere Domain einen privateEndpointOverrides Eintrag hinzu. Derzeit privateEndpointOverrides wird nur mit selbstverwalteten Lattice-Ressourcen unterstützt:

{
  ...
  "authorizerConfiguration": {
    "customJWTAuthorizer": {
      "allowedAudience": ["my-audience"],
      "discoveryUrl": "https://my-idp.internal.example.com/.well-known/openid-configuration",
      "privateEndpoint": {
        "selfManagedLatticeResource": {
          "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-abc123"
        }
      },
      "privateEndpointOverrides": [
        {
          "domain": "my-token-server.internal.example.com",
          "privateEndpoint": {
            "selfManagedLatticeResource": {
              "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-def456"
            }
          }
        }
      ]
    }
  }
}

Informationen zu selbstverwaltetem Lattice, kontoübergreifenden Setups und erweiterten Konfigurationen finden Sie unter Connect zu privaten Ressourcen in Ihrer VPC mithilfe von VPC Lattice. Einen umfassenden Leitfaden, der sowohl eingehende als auch ausgehende private IdP-Szenarien behandelt, finden Sie unter Connect zu privaten Identitätsanbietern herstellen.

Ausgelagerte Autorisierung eingehender Nachrichten

Bei der ausgelagerten eingehenden Autorisierung trifft das Gateway keine eigene Autorisierungsentscheidung. Stattdessen verlagert es die Autorisierung auf eine andere Komponente:

AgentCore bietet zwei ausgelagerte Typen:

Bei beiden Typen entscheiden Sie, wo die Autorisierung tatsächlich durchgesetzt wird:

Authenticate-only Autorisierung

Bei der Authenticate-Only-Autorisierung (AUTHENTICATE_ONLY) verifiziert das Gateway die Signature Version 4 (Sigv4) -Signatur des Anrufers, um dessen Identität zu bestätigen, trifft jedoch keine eigene Autorisierungsentscheidung. Jeder authentifizierte IAM-Principal kann das Gateway unabhängig von seinen Berechtigungen aufrufen, und die Anfrage wird an das Ziel weitergeleitet. Die Autorisierung wird an den nachgeschalteten Zieldienst oder an eine an das Gateway angeschlossene Policy-Engine delegiert.

Keine Autorisierung

Sie können ein Gateway erstellen, das ohne Autorisierung konfiguriert ist, indem SieauthorizerType=NONE. Das Gateway führt keine Autorisierung für die eingehende Gateway-Anfrage durch und die Anfrage kann nicht authentifiziert werden.

Bewährte Methoden im Bereich Sicherheit

Integrieren Sie eine bestehende Runtime, ohne ihre Authentifizierung zu ändern

Wenn Sie einen ausgelagerten Eingangstyp mit einem passenden Autorisierungstyp für ausgehenden Datenverkehr kombinieren, der die Identität des Anrufers an die Runtime weiterleitet, kann das Onboarding in ein Gateway so einfach sein wie das Einstellen einer Endpunkt-Override auf Ihrem vorhandenen Client — es sind keine Authentifizierungsänderungen erforderlich: