Conditions préalables aux paiements AgentCore

Remplissez les conditions requises sur cette page avant d'utiliser AgentCore les paiements.

AWS compte et informations d'identification

Vous avez besoin d'un AWS compte avec des informations d'identification configurées. Pour configurer les informations d'identification, installez et utilisez l'interface de ligne de AWS commande en suivant les étapes décrites dans Getting started with the AWS CLI.

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

Python et AWS Kit SDK

Pour accéder à vos AWS informations d'identification et les configurer pour les utiliser avec les SDK, suivez les étapes de la section Utilisation d'IAM Identity Center pour authentifier le AWS SDK et les outils. Si vous envisagez d'utiliser le SDK AWS Python (Boto3) pour interagir avec AgentCore les paiements de manière programmatique :

Pour plus d'informations sur la configuration et l'utilisation du AWS SDK, consultez AWS Builder Tools.

Informations d'identification du fournisseur de paiement

AgentCore payments se connecte à des fournisseurs de paiement externes pour les opérations de portefeuille de cryptomonnaies. Vous devez obtenir des informations d'identification auprès d'au moins un fournisseur pris en charge avant de créer un PaymentConnector.

Informations d'identification Coinbase CDP

Si vous envisagez d'utiliser Coinbase CDP comme fournisseur de paiement pour les portefeuilles gérés par des développeurs, obtenez les informations d'identification suivantes auprès de la plateforme de développement Coinbase. Le AgentCore modèle Coinbase GitHub fournit une interface de référence pour la collecte de fonds et l'octroi d'autorisations aux agents.

Informations d'identification privées

Si vous envisagez d'utiliser Privy pour les flux de portefeuille intégrés appartenant à l'utilisateur, obtenez les informations d'identification suivantes sur le Privy Dashboard. Le AgentCore SDK Privy GitHub fournit une interface de référence pour collecter des fonds et accorder des autorisations aux agents.

Bonnes pratiques de sécurité pour les informations d'identification privées

Créez une application Privy dédiée pour AgentCore

Créez une application Privy distincte utilisée exclusivement pour les AgentCore paiements. Cela réduit la portée des informations d'identification et simplifie l'audit des opérations du portefeuille.

Restreindre l'accès secret aux AgentCore services

Lorsque vous stockez vos données privées App Secret dans AgentCore Identity as a PaymentCredentialProvider, assurez-vous que seul le service de AgentCore paiement peut récupérer le secret. N'accordez l'accès au secret sous-jacent dans AWS Secrets Manager à aucun autre administrateur IAM. La politique de ressources suivante concernant le secret restreint l'accès au rôle de AgentCore service :

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

Faites régulièrement alterner les secrets

Modifiez régulièrement vos informations d'identification privées afin de réduire la période d'exposition à tout secret compromis.

Pour alterner les informations d'identification :

Après avoir obtenu les informations d'identification de votre fournisseur, vous les stockez dans AgentCore Identity en tant que PaymentCredentialProvider. Pour obtenir des instructions, voir Configurer les fournisseurs d'informations de paiement. Pour le schéma complet de demande et de réponse, reportez-vous CreatePaymentCredentialProviderà la référence de l'API.

(Facultatif) Fournisseur d'identité pour l'autorisation JWT

Si vous envisagez d'utiliser l'autorisation JWT pour l'accès entrant à votre gestionnaire de paiements (afin de permettre aux consommateurs d'accéder au gestionnaire de paiements en utilisant des identités autres que celles d'IAM), configurez Amazon Cognito ou votre propre fournisseur d'identité avant de créer le gestionnaire de paiements :

Vous pouvez également choisir de créer rapidement des configurations avec Cognito lors de la création de Payment Manager, et AgentCore Payments crée les configurations d'autorisation en votre nom.

Pour obtenir des instructions détaillées, voir Configurer l'autorisateur JWT entrant.