As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Pré-requisitos para pagamentos AgentCore

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

AWS conta e credenciais

Você precisa de uma AWS conta com as credenciais configuradas. Para configurar 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 Usando o IAM Identity Center para autenticar AWS SDK e 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 da Coinbase Developer Platform. https://docs.cdp.coinbase.com/api-reference/v2/authentication O AgentCore modelo Coinbase em GitHub fornece uma interface de referência para aumentar os 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 Privy Dashboard. https://docs.privy.io/authentication/overview#api-authentication O Privy AgentCore SDK on GitHub fornece uma interface de referência para aumentar os fundos e conceder permissões aos agentes.

Melhores práticas de segurança para credenciais Privy

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 política de recursos a seguir 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 do Privy 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 as a PaymentCredentialProvider. Para obter instruções, consulte Configurar provedores de credenciais de pagamento. Para ver o esquema completo de solicitação e resposta, consulte CreatePaymentCredentialProvider a Referência da API.

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

Se você planeja usar a autorização do 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 do IAM), configure o Amazon Cognito ou seu próprio provedor de identidade antes de criar o Gerenciador de pagamentos:

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

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