View a markdown version of this page

Salesforce - Amazon Bedrock AgentCore
Saída

Salesforce

O Salesforce pode ser configurado como um provedor de credenciais de AgentCore identidade para acesso externo a recursos. Isso permite que seus agentes autentiquem usuários por meio do serviço OAuth2 da Salesforce e obtenham tokens de acesso aos recursos da API do Salesforce.

Saída

nota

AgentCore A identidade emite uma URL exclusiva de retorno de chamada do OAuth2 para cada provedor de credenciais que você cria. O URL de retorno de chamada exclusivo permite a vinculação de sessão, o que protege a troca do código de autorização do OAuth2 contra repetições e CSRF-style ataques entre provedores, garantindo que uma resposta de autorização só possa ser resgatada contra o provedor de credenciais específico que a iniciou. Como o URL é exclusivo por provedor, você não o saberá até depois de ligarCreateOauth2CredentialProvider. Crie seu cliente Salesforce OAuth2 primeiro e depois retorne ao console do desenvolvedor do Salesforce para registrar o URL de retorno de chamada depois que o Identity o emitir. AgentCore

Etapa 1: criar o cliente Salesforce OAuth2

Use o procedimento a seguir para configurar um aplicativo Salesforce OAuth2 e obter as credenciais de cliente necessárias para o Identity. AgentCore Você registrará o URI de redirecionamento na Etapa 3, depois que o AgentCore Identity emitir o URL de retorno de chamada exclusivo.

Para configurar um aplicativo Salesforce OAuth2

  1. No portal do desenvolvedor do Salesforce, crie um aplicativo conectado e insira o nome e outras informações solicitadas específicas do seu aplicativo.

  2. Ative e defina as configurações de OAuth para o aplicativo. Deixe o campo URL de retorno de chamada vazio por enquanto — você adicionará o URL de retorno de chamada exclusivo na Etapa 3.

  3. Escolha os escopos e as permissões necessários que seu aplicativo precisará.

  4. Escolha a extensão Exigir chave de prova para troca de código (PKCE) para fluxos de autorização compatíveis.

  5. Escolha Exigir segredo para o fluxo do servidor Web.

  6. Escolha Ativar código de autorização e fluxo de credenciais.

  7. Se você quiser usar o Salesforce como ClientCredentials/M2M provedor, escolha Ativar fluxo de credenciais do cliente e siga as instruções.

  8. Salve seu aplicativo e copie o ID do cliente e o segredo do cliente emitidos para o aplicativo. Você precisará deles para configurar o Salesforce no AgentCore Identity.

Para obter mais detalhes, consulte a documentação da Salesforce Define an OpenID Connect Provider.

Etapa 2: criar o provedor de credenciais de AgentCore identidade

Para configurar o provedor de recursos de saída do Salesforce, use o seguinte:

{
        "name": "NAME",
        "credentialProviderVendor": "SalesforceOauth2",
        "oauth2ProviderConfigInput": {
            "SalesforceOauth2ProviderConfigInput": {
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
            }
        },
    }

A CreateOauth2CredentialProviderresposta inclui um callbackUrl campo. Esse URL é exclusivo desse provedor de credenciais e se parece com:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Salve esse valor para a próxima etapa.

Etapa 3: registrar o URL de retorno de chamada exclusivo com o Salesforce

Retorne ao console do desenvolvedor do Salesforce e adicione o URL de retorno de chamada exclusivo à lista de URI de redirecionamento do seu aplicativo OAuth2.

  1. Faça login no console do desenvolvedor do Salesforce e abra o aplicativo OAuth2 que você criou na Etapa 1.

  2. Adicione o callbackUrl valor retornado por CreateOauth2CredentialProvider à configuração do URI de redirecionamento do aplicativo.

  3. Salve as alterações.