View a markdown version of this page

Sicurezza nei pagamenti con Amazon Bedrock AgentCore - Amazon Bedrock AgentCore
Controlli preventiviControlli di rilevamento

Sicurezza nei pagamenti con Amazon Bedrock AgentCore

Le seguenti best practice possono aiutarti a prevenire incidenti di sicurezza quando utilizzi i pagamenti Amazon Bedrock AgentCore . I controlli preventivi bloccano le azioni non sicure prima che si verifichino. Detective controlla le attività inaspettate in superficie in modo che tu possa reagire ad esse.

Controlli preventivi

Usa questi controlli per limitare ciò che il tuo agente può fare e per tenere il materiale sensibile fuori dalla sua portata.

Applica il privilegio minimo con il modello IAM a quattro ruoli

AgentCore payments separa il piano di controllo dal piano dati utilizzando ruoli IAM distinti. Imposta le autorizzazioni IAM in base alla persona che corrisponde a ciascun ruolo. Con questo modello, nessun ruolo può raccogliere un budget e allo stesso tempo spendere per finanziarlo.

# Ruolo Scopo

1

ControlPlaneRole

Amministra il servizio.

2

ManagementRole

Configura le sessioni. Questo ruolo è negato esplicitamente. ProcessPayment

3

ProcessPaymentRole

Esegue i pagamenti.

4

ResourceRetrievalRole

Service-assumed. Recupera lo stato della sessione e delle credenziali.

Per ulteriori informazioni, consulta Ruoli IAM per AgentCore i pagamenti.

Archivia le credenziali in Identity AgentCore

Non incorporare mai le credenziali del provider di portafogli nel codice dell'agente o nelle variabili di ambiente.

  • Memorizza le credenziali di Coinbase CDP o Stripe (Privy) come in Identity. PaymentCredentialProvider AgentCore

  • Il servizio le recupera in fase di esecuzione utilizzando. ResourceRetrievalRole

  • Ruota le credenziali secondo la pianificazione consigliata dal fornitore del portafoglio. Se una credenziale è compromessa, revocala immediatamente.

Per ulteriori informazioni, consulta la pagina relativa alle identità di AgentCore .

Imposta l'intestazione correttamente UserId

In un gestore dei pagamenti con autorizzazione IAM-configured in entrata, il backend afferma l'X-Amzn-Bedrock-AgentCore-Payments-User-Idintestazione e AgentCore Payments non la verifica. L'utente è responsabile dell'impostazione corretta di questo valore.

AgentCore payments verifica il chiamante IAM e il JWT (quando si utilizza OAuth), ma la correttezza dell'UserIdintestazione sulle chiamate API è responsabilità dell'utente. Non lasciate che utenti finali o agenti influenzino direttamente questa intestazione.

Implementazioni multi-tenant sicure

Per le implementazioni multi-tenant che servono più utenti finali, utilizza il tipo di autorizzazione CUSTOM_JWT (OAuth) nel gestore dei pagamenti. Ciò fornisce al servizio un'identità verificata dell'utente finale. Con il IAM-configured gestore dei AgentCore pagamenti, Payments non verifica l'identità dell'utente finale.

Il finanziamento e la delega sono due decisioni distinte che spettano all'utente finale, ed entrambe vengono prese separatamente dall'agente:

  • Finanziamento: l'utente finale deposita fondi tramite il portale del fornitore del portafoglio. L'agente non ha accesso tramite API ai finanziamenti e non deve mai richiederli o avviarli automaticamente.

  • Delega: l'utente finale concede l'autorizzazione tramite Coinbase Spend Permissions o Privy Delegated Actions. Non date per scontato che la delega sia permanente, perché gli utenti possono revocarla in qualsiasi momento. Gestisci la delega revocata con garbo.

Mantieni l'agente isolato dagli strumenti di pagamento

L'agente non deve mai accedere ai numeri delle carte, ai valori CVV, ai dati bancari o alle chiavi private del portafoglio. L'opinione dell'agente si limita a «un'autorizzazione a spendere da un portafoglio di proprietà dell'utente».

  • Le chiavi del portafoglio sono custodite in autonomia dal provider, non dallo sviluppatore o dallo sviluppatore. AWS

  • Non comunicate mai i dettagli dello strumento di pagamento tramite istruzioni, input di strumenti o finestre contestuali.

Ambita l'accesso allo strumento con Policy in AgentCore

Per l'autorizzazione a livello di strumento, esponi gli endpoint a pagamento tramite Amazon Bedrock Gateway. AgentCore Ogni chiamata tramite il Gateway viene intercettata da Policy in AgentCore, un Cedar-based motore che valuta la richiesta, inclusa l'identità dell'agente, il nome dello strumento e i parametri, e decide se consentirla.

Le sessioni relative alle politiche e ai pagamenti riguardano decisioni diverse:

  • Le policy controllano chi chiama quale strumento e con quali parametri.

  • Le sessioni di pagamento controllano quanto può essere speso e per quanto tempo.

Insieme, offrono leve ortogonali per l'accesso agli utensili e l'importo della spesa.

  • Scrivi politiche Cedar basate sull'identità dell'agente, sul gruppo di utenti e sui parametri di richiesta.

  • Negate l'accesso a strumenti ad alto costo agli agenti che non li richiedono.

  • Rivedi e verifica regolarmente le politiche man mano che il catalogo degli strumenti cambia.

Per ulteriori informazioni, vedete Policy in AgentCore.

Utilizza sessioni di pagamento con limiti di budget e TTL

Ogni pagamento viene eseguito all'interno di una sessione di pagamento con un importo massimo di spesa e un tempo di scadenza. Il livello dell'infrastruttura impone questi limiti, quindi un'iniezione tempestiva e il non determinismo del modello non possono annullarli.

  • Imposta maxSpendAmount il valore minimo necessario per l'attività e imposta un TTL breve.

  • Inizia con budget conservativi e aumentali solo quando l'agente si dimostra affidabile.

  • Le firme non riuscite annullano automaticamente le detrazioni sul budget.

Per ulteriori informazioni, consulta Creare una sessione di pagamento.

Convalida e limita gli indirizzi PayTo

L'payToindirizzo specifica il portafoglio del destinatario. AgentCore payments non impone payTo restrizioni lato server, quindi l'applicazione deve convalidare l'indirizzo prima di chiamare l'API. ProcessPayment

  • Mantieni un elenco consentito di indirizzi commerciali pre-verificati e rifiuta gli indirizzi sconosciuti.

  • Non lasciare mai che il modello generi indirizzi PayTo. Devono provenire da una fonte attendibile, ad esempio una richiesta di pagamento x402 o un registro verificato.

  • Effettua la convalida rispetto al venditore previsto durante l'elaborazione delle risposte x402.

  • Preferisci AgentCore Gateway per l'individuazione degli endpoint, perché fornisce payTo indirizzi verificati tramite x402 Bazaar.

  • Applica le policy Cedar per stabilire gli indirizzi che un agente può pagare.

  • Non memorizzate nella cache gli indirizzi tra le sessioni. Utilizza sempre l'indirizzo corrente fornito dal venditore, convalidato in base alla tua lista consentita.

Accesso sicuro alla rete

  • Usa gli endpoint VPC per mantenere il traffico lontano dalla rete Internet pubblica.

  • Applica le policy degli endpoint e le condizioni IAM (aws:sourceVpc,aws:sourceVpce) per limitare le origini.

  • Abilita AWS CloudTrail per tutte le chiamate API di AgentCore pagamento.

Progettazione per il mancato pagamento e il rollback

  • Implementa l'idempotenza per evitare pagamenti duplicati in caso di nuovi tentativi.

  • Gestisci i mancati pagamenti con un comportamento di riserva chiaro. Non riprovare all'infinito.

  • Monitora eventuali errori parziali e implementa transazioni di compensazione.

Controlli di rilevamento

Utilizza questi controlli per osservare l'attività di pagamento e rilevare eventuali anomalie in modo da potervi rispondere.

Abilita l'osservabilità e la registrazione degli audit

AgentCore i pagamenti forniscono l'osservabilità automatica tramite Amazon CloudWatch:

  • Registri forniti: viene registrata ogni chiamata sul piano dati (chi, cosa, quanto e a chi).

  • Periodi di vendita: le tracce complete del ciclo di vita dei pagamenti sono disponibili in. AWS X-Ray

  • Imposta allarmi in caso di modelli di spesa anomali, ad esempio pagamenti a indirizzi non elencati, un numero insolitamente elevato di destinatari distinti o cambiamenti improvvisi di indirizzo per commercianti noti.

  • Conserva i log in base ai requisiti di conformità.

  • Non fare affidamento sul codice dell'agente per registrare le proprie azioni.

Per ulteriori informazioni, consulta Observability with Amazon CloudWatch.

Controlla regolarmente le configurazioni

  • Controlla i budget e riduci i limiti per gli agenti che spendono meno.

  • Rivedi trimestralmente le politiche Cedar e i ruoli IAM.

  • Monitora le dashboard dei provider di portafogli per rilevare eventuali attività di delega o finanziamento impreviste.