View a markdown version of this page

Sicherheit bei Zahlungen mit Amazon Bedrock AgentCore - Amazon Grundgestein AgentCore
Präventive KontrollenDetektivische Kontrollen

Sicherheit bei Zahlungen mit Amazon Bedrock AgentCore

Die folgenden bewährten Methoden können Ihnen helfen, Sicherheitsvorfälle bei der Verwendung von Amazon AgentCore Bedrock-Zahlungen zu verhindern. Präventive Kontrollen verhindern unsichere Aktionen, bevor sie passieren. Detective Controls deckt unerwartete Aktivitäten auf, sodass Sie darauf reagieren können.

Präventive Kontrollen

Verwenden Sie diese Kontrollen, um die Möglichkeiten Ihres Agenten einzuschränken und vertrauliches Material außerhalb seiner Reichweite zu halten.

Erzwingen Sie mit dem IAM-Muster mit vier Rollen die geringsten Rechte

AgentCore Payments trennt die Steuerungsebene von der Datenebene, indem unterschiedliche IAM-Rollen verwendet werden. Richten Sie IAM-Berechtigungen auf der Grundlage der Persona ein, die jeder Rolle entspricht. Bei diesem Muster kann keine einzelne Rolle gleichzeitig ein Budget aufbringen und dafür Geld ausgeben.

# Rolle Zweck

1

ControlPlaneRole

Verwaltet den Dienst.

2

ManagementRole

Konfiguriert Sitzungen. Diese Rolle wurde ausdrücklich verweigertProcessPayment.

3

ProcessPaymentRole

Führt Zahlungen aus.

4

ResourceRetrievalRole

Service-assumed. Ruft den Status der Sitzung und der Anmeldeinformationen ab.

Weitere Informationen finden Sie unter IAM-Rollen für Zahlungen. AgentCore

Speichern Sie Anmeldeinformationen in Identity AgentCore

Betten Sie niemals Anmeldeinformationen eines Wallet-Anbieters in Agentencode oder Umgebungsvariablen ein.

  • Speichern Sie Coinbase CDP- oder Stripe (Privy) -Anmeldeinformationen als PaymentCredentialProvider in Identity. AgentCore

  • Der Dienst ruft sie zur Laufzeit ab, indem er ResourceRetrievalRole

  • Wechseln Sie die Anmeldeinformationen nach dem vom Wallet-Anbieter empfohlenen Zeitplan ab. Wenn ein Berechtigungsnachweis kompromittiert wurde, widerrufe ihn sofort.

Weitere Informationen finden Sie unter AgentCore -Identität.

Stellen Sie den Header richtig UserId ein

Bei einem Zahlungsmanager für IAM-configured eingehende Autorisierungen bestätigt Ihr Backend den X-Amzn-Bedrock-AgentCore-Payments-User-Id Header, und AgentCore Payments verifiziert ihn nicht. Sie sind dafür verantwortlich, diesen Wert korrekt einzustellen.

AgentCore payments verifiziert den IAM-Aufrufer und das JWT (bei Verwendung von OAuth), aber die Richtigkeit des UserId Headers bei API-Aufrufen liegt in Ihrer Verantwortung. Lassen Sie nicht zu, dass Endbenutzer oder Agenten diesen Header direkt beeinflussen.

Sichere Bereitstellungen mit mehreren Mandanten

Verwenden Sie für Mehrmandantenbereitstellungen, die mehrere Endbenutzer bedienen, den Autorisierungstyp CUSTOM_JWT (OAuth) im Zahlungsmanager. Dadurch erhält der Dienst eine verifizierte Endbenutzeridentität. Mit dem IAM-configured Zahlungsmanager überprüft AgentCore Payments nicht die Identität des Endbenutzers.

Bei Finanzierung und Delegierung handelt es sich um zwei separate Entscheidungen der Endnutzer, und beide Entscheidungen werden außerhalb der Bandbreite des Agenten getroffen:

  • Finanzierung — Der Endnutzer zahlt Geld über das Portal des Wallet-Anbieters ein. Der Agent hat keinen API-Zugriff auf Finanzierungen und darf niemals danach fragen oder sie automatisch initiieren.

  • Delegierung — Der Endbenutzer erteilt die Erlaubnis über Coinbase Spend Permissions oder Privy Delegated Actions. Gehen Sie nicht davon aus, dass die Delegierung dauerhaft ist, da Benutzer sie jederzeit widerrufen können. Gehen Sie mit der widerrufenen Delegierung vorsichtig um.

Halten Sie den Agenten von Zahlungsinstrumenten fern

Der Agent darf niemals auf Kartennummern, CVV-Werte, Bankdaten oder private Wallet-Schlüssel zugreifen. Die Ansicht des Agenten endet bei „einer Erlaubnis, Geld aus einer Wallet des Benutzers auszugeben“.

  • Wallet-Schlüssel werden vom Anbieter selbst verwahrt — nicht vom Entwickler oder vom Entwickler. AWS

  • Geben Sie Informationen zu Zahlungsinstrumenten niemals über Eingabeaufforderungen, Tooleingaben oder Kontextfenster weiter.

Umfassen Sie den Zugriff auf Tools mit eingeschalteter Richtlinie AgentCore

Stellen Sie für die Autorisierung auf Tool-Ebene kostenpflichtige Endgeräte über Amazon Bedrock Gateway zur Verfügung. AgentCore Jeder Anruf über das Gateway wird von Policy In abgefangen AgentCore, einer Cedar-based Engine, die die Anfrage — einschließlich der Identität des Agenten, des Tool-Namens und der Parameter — bewertet und entscheidet, ob sie zugelassen werden soll.

In den Richtlinien- und Zahlungssitzungen werden unterschiedliche Entscheidungen getroffen:

  • Die Richtlinie legt fest, wer welches Tool mit welchen Parametern aufruft.

  • Bei Zahlungssitzungen wird festgelegt, wie viel und für wie lange ausgegeben werden kann.

Zusammen bieten sie Ihnen orthogonale Hebel für den Zugriff auf Tools und die Höhe der Ausgaben.

  • Schreiben Sie Cedar-Richtlinien, die sich nach Agentenidentität, Benutzergruppe und Anforderungsparametern richten.

  • Verweigern Sie Agenten, die diese nicht benötigen, den Zugriff auf teure Tools.

  • Überprüfen und überprüfen Sie die Richtlinien regelmäßig, wenn sich Ihr Toolkatalog ändert.

Weitere Informationen finden Sie unter Richtlinie in AgentCore.

Verwenden Sie Zahlungssitzungen mit Budgetlimits und TTL

Jede Zahlung erfolgt innerhalb einer Zahlungssitzung mit einem maximalen Ausgabenbetrag und einer Ablaufzeit. Die Infrastrukturebene erzwingt diese Grenzwerte, sodass eine schnelle Injektion und der Nichtdeterminismus des Modells sie nicht außer Kraft setzen können.

  • Stellen Sie maxSpendAmount das für die Aufgabe erforderliche Minimum ein und legen Sie eine kurze TTL fest.

  • Beginnen Sie mit konservativen Budgets und erhöhen Sie diese nur, wenn sich der Agent als zuverlässig erweist.

  • Fehlgeschlagene Unterschriften machen Budgetabzüge automatisch rückgängig.

Weitere Informationen finden Sie unter Eine Zahlungssitzung erstellen.

PayTo-Adressen validieren und einschränken

Die payTo Adresse gibt die Brieftasche des Empfängers an. AgentCore Payments erzwingt serverseitig keine payTo Einschränkungen, sodass Ihre Anwendung die Adresse überprüfen muss, bevor sie die ProcessPayment API aufruft.

  • Pflegen Sie eine Zulassungsliste mit vorab verifizierten Händleradressen und lehnen Sie unbekannte Adressen ab.

  • Lassen Sie das Modell niemals PayTo-Adressen generieren. Sie müssen aus einer vertrauenswürdigen Quelle stammen, z. B. aus einer x402-Zahlungsanforderung oder einer verifizierten Registrierung.

  • Prüfen Sie bei der Bearbeitung von x402-Antworten anhand des erwarteten Händlers.

  • Bevorzugen Sie AgentCore Gateway für die Endpunkterkennung, da es verifizierte payTo Adressen über den x402-Bazaar bereitstellt.

  • Wenden Sie die Richtlinien von Cedar an, um einzuschränken, welche Adressen ein Agent bezahlen kann.

  • Zwischenspeichern Sie Adressen nicht sitzungsübergreifend. Verwenden Sie immer die aktuelle vom Händler angegebene Adresse, die anhand Ihrer Zulassungsliste validiert wurde.

Sicherer Netzwerkzugriff

  • Verwenden Sie VPC-Endpunkte, um den Datenverkehr vom öffentlichen Internet fernzuhalten.

  • Wenden Sie Endpunktrichtlinien und IAM-Bedingungen (aws:sourceVpc,aws:sourceVpce) an, um die Herkunft einzuschränken.

  • Aktivieren Sie AWS CloudTrail diese Option für alle API-Aufrufe für AgentCore Zahlungen.

Design für Zahlungsfehler und Rollback

  • Implementieren Sie Idempotenz, um doppelte Zahlungen bei Wiederholungsversuchen zu verhindern.

  • Behandeln Sie Zahlungsausfälle mit klarem Fallback-Verhalten. Versuchen Sie es nicht auf unbestimmte Zeit erneut.

  • Achten Sie auf Teilausfälle und implementieren Sie Ausgleichstransaktionen.

Detektivische Kontrollen

Verwenden Sie diese Kontrollen, um die Zahlungsaktivität zu beobachten und Anomalien aufzudecken, damit Sie darauf reagieren können.

Aktivieren Sie die Beobachtbarkeit und die Auditprotokollierung

AgentCore Payments bietet automatische Beobachtbarkeit über Amazon CloudWatch:

  • Versandprotokolle — Jeder Anruf auf der Datenebene wird protokolliert (wer, was, wie viel und an wen).

  • Lieferfristen — Vollständige Nachverfolgungen des Zahlungslebenszyklus sind in verfügbar. AWS X-Ray

  • Richten Sie Alarme für ungewöhnliche Ausgabenmuster ein, z. B. Zahlungen an Adressen, die nicht in der Liste aufgeführt sind, eine ungewöhnlich große Anzahl unterschiedlicher Empfänger oder plötzliche Adressänderungen bei bekannten Händlern.

  • Bewahren Sie die Protokolle gemäß Ihren Compliance-Anforderungen auf.

  • Verlassen Sie sich nicht auf Agentencode, um eigene Aktionen zu protokollieren.

Weitere Informationen finden Sie unter Observability with Amazon CloudWatch.

Überprüfen Sie die Konfigurationen regelmäßig

  • Prüfen Sie Budgets und reduzieren Sie die Limits für Agenten, die zu wenig ausgeben.

  • Überprüfen Sie vierteljährlich die Richtlinien und IAM-Rollen von Cedar.

  • Überwachen Sie die Dashboards der Wallet-Anbieter auf unerwartete Delegierungs- oder Finanzierungsaktivitäten.