Prerequisiti per i pagamenti AgentCore

Completa i prerequisiti in questa pagina prima di utilizzare AgentCore i pagamenti.

AWS account e credenziali

È necessario un AWS account con credenziali configurate. Per configurare le credenziali, installa e utilizza l'interfaccia a riga di AWS comando seguendo la procedura descritta in Guida introduttiva alla AWS CLI.

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

Python e AWS SDK

Per accedere alle tue AWS credenziali e configurarle per l'uso con gli SDK, segui i passaggi descritti in Utilizzo di IAM Identity Center per autenticare AWS SDK e strumenti. Se prevedi di utilizzare AWS Python SDK (Boto3) per interagire con i pagamenti a livello di codice: AgentCore

Per ulteriori informazioni su come configurare e utilizzare l' AWS SDK, consulta AWS Builder Tools.

Credenziali del fornitore di servizi di pagamento

AgentCore payments si collega a fornitori di servizi di pagamento esterni per le operazioni di portafoglio di criptovalute. È necessario ottenere le credenziali da almeno un provider supportato prima di creare un PaymentConnector.

Credenziali Coinbase CDP

Se prevedi di utilizzare Coinbase CDP come provider di pagamento per i portafogli gestiti dagli sviluppatori, ottieni le seguenti credenziali dalla Coinbase Developer Platform. Il AgentCore modello Coinbase GitHub fornisce un frontend di riferimento per aumentare i fondi e concedere le autorizzazioni agli agenti.

Credenziali private

Se prevedi di utilizzare Privy per flussi di portafogli incorporati di proprietà dell'utente, ottieni le seguenti credenziali dalla Privy Dashboard. Privy AgentCore SDK on GitHub fornisce un frontend di riferimento per aumentare i fondi e concedere le autorizzazioni agli agenti.

Migliori pratiche di sicurezza per le credenziali Privy

Crea un'app Privy dedicata per AgentCore

Crea un'app Privy separata da utilizzare esclusivamente per i AgentCore pagamenti. Ciò riduce l'ambito delle credenziali e semplifica il controllo delle operazioni del portafoglio.

Limita l'accesso segreto ai servizi AgentCore

Quando memorizzi Privy App Secret in AgentCore Identity come utente PaymentCredentialProvider, assicurati che solo il ruolo del servizio di AgentCore pagamento possa recuperare il segreto. Non concedere l'accesso al segreto sottostante in AWS Secrets Manager a nessun altro responsabile IAM. La seguente politica delle risorse relativa al segreto limita l'accesso al ruolo di AgentCore servizio:

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

Ruota i segreti regolarmente

Modifica regolarmente le tue credenziali Privy per ridurre la finestra di visibilità di eventuali segreti compromessi.

Per ruotare le credenziali:

Dopo aver ottenuto le credenziali dal provider, le memorizzi in AgentCore Identity as a. PaymentCredentialProvider Per istruzioni, consulta Configurare i fornitori di credenziali di pagamento. Per lo schema completo di richiesta e risposta, consulta CreatePaymentCredentialProviderl'API Reference.

(Facoltativo) Provider di identità per l'autorizzazione JWT

Se prevedi di utilizzare l'autorizzazione JWT per l'accesso in entrata al tuo Payment Manager (per consentire ai consumatori di accedere al Payment Manager utilizzando identità non IAM), configura Amazon Cognito o il tuo provider di identità prima di creare il Payment Manager:

In alternativa, puoi scegliere Creazione rapida di configurazioni con Cognito durante la creazione di Payment Manager AgentCore e Payments creerà le configurazioni di autorizzazione per tuo conto.

Per istruzioni dettagliate, consulta Configurare l'autorizzatore JWT in entrata.