Voraussetzungen für AgentCore Zahlungen

Erfüllen Sie die Voraussetzungen auf dieser Seite, bevor Sie AgentCore Zahlungen verwenden.

AWS Konto und Anmeldeinformationen

Sie benötigen ein AWS Konto mit konfigurierten Anmeldeinformationen. Um Anmeldeinformationen zu konfigurieren, installieren und verwenden Sie die AWS Befehlszeilenschnittstelle, indem Sie die Schritte unter Erste Schritte mit der AWS CLI ausführen.

# Verify installation
aws --version  # Should show version 2.x

Python und AWS SDK

Um auf Ihre AWS Anmeldeinformationen zuzugreifen und sie für die Verwendung mit SDKs zu konfigurieren, folgen Sie den Schritten unter Verwenden von IAM Identity Center zur Authentifizierung von AWS SDK und Tools. Wenn Sie das AWS Python-SDK (Boto3) verwenden möchten, um programmgesteuert mit AgentCore Zahlungen zu interagieren:

Weitere Informationen zur Einrichtung und Verwendung des AWS SDK finden Sie unter AWS Builder-Tools.

Anmeldeinformationen des Zahlungsanbieters

AgentCore Payments stellt eine Verbindung zu externen Zahlungsanbietern für den Betrieb von Kryptowährungs-Wallets her. Sie müssen Anmeldeinformationen von mindestens einem unterstützten Anbieter erhalten, bevor Sie einen erstellen können PaymentConnector.

Coinbase CDP-Anmeldeinformationen

Wenn Sie Coinbase CDP als Ihren Zahlungsanbieter für von Entwicklern verwaltete Wallets verwenden möchten, holen Sie sich die folgenden Anmeldeinformationen von der Coinbase Developer Platform. Die AgentCore Coinbase-Vorlage GitHub bietet ein Referenz-Frontend für die Verwaltung von Geldern und die Erteilung von Agentenberechtigungen.

Geheime Anmeldeinformationen

Wenn Sie Privy für benutzereigene eingebettete Wallet-Flows verwenden möchten, rufen Sie die folgenden Anmeldeinformationen aus dem Privy-Dashboard ab. Das Privy AgentCore SDK on GitHub bietet ein Referenz-Frontend für die Verwaltung von Geldern und die Erteilung von Agentenberechtigungen.

Bewährte Sicherheitsmethoden für Privy-Anmeldeinformationen

Erstellen Sie eine spezielle Privy-App für AgentCore

Erstellen Sie eine separate Privy-App, die ausschließlich für AgentCore Zahlungen verwendet wird. Dies reduziert den Umfang der Anmeldeinformationen und vereinfacht die Prüfung von Wallet-Vorgängen.

Beschränken Sie den geheimen Zugriff auf AgentCore Dienste

Wenn Sie Ihr Privy App Secret in AgentCore Identity als speichern, stellen Sie sicher PaymentCredentialProvider, dass nur die Rolle des AgentCore Zahlungsdienstleisters das Geheimnis abrufen kann. Gewähren Sie keinen anderen IAM-Prinzipalen Zugriff auf das zugrundeliegende Geheimnis in AWS Secrets Manager. Die folgende Ressourcenrichtlinie für den geheimen Schlüssel schränkt den Zugriff auf die Servicerolle ein: AgentCore

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "secretsmanager:GetSecretValue",
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "aws:PrincipalArn": "arn:aws:iam::111122223333:role/AgentCorePaymentsResourceRetrievalRole"
                }
            }
        }
    ]
}

Wechseln Sie die Geheimnisse regelmäßig

Wechseln Sie Ihre Privy-Zugangsdaten regelmäßig, um das Zeitfenster zu verkürzen, in dem ein kompromittiertes Geheimnis entdeckt wird.

Um Anmeldeinformationen zu rotieren:

Nachdem Sie die Anmeldeinformationen von Ihrem Anbieter erhalten haben, speichern Sie sie in AgentCore Identity as PaymentCredentialProvider a. Anweisungen finden Sie unter Anbieter für Zahlungsnachweise konfigurieren. Das vollständige Anfrage- und Antwortschema finden Sie CreatePaymentCredentialProviderin der API-Referenz.

(Optional) Identitätsanbieter für die JWT-Autorisierung

Wenn Sie beabsichtigen, die JWT-Autorisierung für den eingehenden Zugriff auf Ihren Payment Manager zu verwenden (damit Verbraucher mit Nicht-IAM-Identitäten auf den Payment Manager zugreifen können), richten Sie Amazon Cognito oder Ihren eigenen Identitätsanbieter ein, bevor Sie den Payment Manager erstellen:

Alternativ können Sie bei der Erstellung von Payment Manager Quick Create Configurations with Cognito auswählen, und AgentCore Payments erstellt die Autorisierungskonfigurationen in Ihrem Namen.

Eine ausführliche Anleitung finden Sie unter JWT-Autorisierer für eingehende Nachrichten konfigurieren.