Pré-requisitos para pagamentos AgentCore

Preencha os pré-requisitos nesta página antes de usar os pagamentos. AgentCore

AWS conta e credenciais

Você precisa de uma AWS conta com credenciais configuradas. Para configurar as credenciais, instale e use a interface de linha de AWS comando seguindo as etapas em Introdução à AWS CLI.

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

Python e AWS SDK

Para acessar suas AWS credenciais e configurá-las para uso com SDKs, siga as etapas em Como usar o IAM Identity Center para autenticar o AWS SDK e as ferramentas. Se você planeja usar o SDK do AWS Python (Boto3) para interagir com pagamentos de forma programática: AgentCore

Para obter mais informações sobre como configurar e usar o AWS SDK, consulte AWS Builder Tools.

Credenciais do provedor de pagamento

AgentCore os pagamentos se conectam a provedores de pagamento externos para operações de carteira de criptomoedas. Você deve obter credenciais de pelo menos um provedor compatível antes de criar um PaymentConnector.

Credenciais do Coinbase CDP

Se você planeja usar o Coinbase CDP como seu provedor de pagamento para carteiras gerenciadas por desenvolvedores, obtenha as seguintes credenciais na Coinbase Developer Platform. O AgentCore modelo da Coinbase GitHub fornece uma interface de referência para aumentar fundos e conceder permissões aos agentes.

Credenciais privadas

Se você planeja usar o Privy para fluxos de carteira incorporados de propriedade do usuário, obtenha as seguintes credenciais no Painel do Privy. O Privy AgentCore SDK on GitHub fornece uma interface de referência para aumentar fundos e conceder permissões aos agentes.

Melhores práticas de segurança para credenciais privadas

Crie um aplicativo Privy dedicado para AgentCore

Crie um aplicativo Privy separado que seja usado exclusivamente para AgentCore pagamentos. Isso reduz o escopo das credenciais e simplifica a auditoria das operações da carteira.

Restrinja o acesso secreto aos AgentCore serviços

Ao armazenar seu Privy App Secret in AgentCore Identity como um PaymentCredentialProvider, certifique-se de que somente a função do serviço de AgentCore pagamentos possa recuperar o segredo. Não conceda acesso ao segredo subjacente no AWS Secrets Manager a nenhum outro diretor do IAM. A seguinte política de recursos sobre o segredo restringe o acesso à função AgentCore de serviço:

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

Alterne os segredos regularmente

Alterne suas credenciais privadas regularmente para reduzir a janela de exposição de qualquer segredo comprometido.

Para alternar as credenciais:

Depois de obter as credenciais do seu provedor, você as armazena no AgentCore Identity como a. PaymentCredentialProvider Para obter instruções, consulte Configurar provedores de credenciais de pagamento. Para ver o esquema completo de solicitações e respostas, consulte CreatePaymentCredentialProvidera Referência da API.

(Opcional) Provedor de identidade para autorização do JWT

Se você planeja usar a autorização da JWT para acesso de entrada ao seu Gerenciador de Pagamentos (para permitir que os consumidores acessem o Gerenciador de Pagamentos usando identidades que não sejam IAM), configure o Amazon Cognito ou seu próprio provedor de identidade antes de criar o Gerenciador de Pagamentos:

Como alternativa, você pode escolher a Criação rápida de configurações com o Cognito durante a criação do Payment Manager, AgentCore e o Payments cria as configurações de autorização em seu nome.

Para obter instruções detalhadas, consulte Configurar o autorizador JWT de entrada.