View a markdown version of this page

Dropbox - Base da Amazônia AgentCore
Saída

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á.

Dropbox

O Dropbox 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 do Dropbox e obtenham tokens de acesso aos recursos da API do Dropbox.

nota

O Dropbox não suporta o fluxo de M2M/Client credenciais.

Saída

nota

AgentCore O Identity emite um URL exclusivo de retorno de chamada do OAuth2 para cada provedor de credenciais que você cria. O URL exclusivo de retorno de chamada permite a vinculação de sessão, o que protege a troca de 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ê só saberá depois de ligarCreateOauth2CredentialProvider. Crie seu cliente OAuth2 do Dropbox primeiro e depois retorne ao console de desenvolvedores do Dropbox para registrar a URL de retorno de chamada assim AgentCore que a Identity a emitir.

Etapa 1: criar o cliente OAuth2 do Dropbox

Use o procedimento a seguir para configurar um aplicativo OAuth2 do Dropbox 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 exclusivo de retorno de chamada.

Para configurar um aplicativo OAuth2 do Dropbox

  1. Abra o console de aplicativos para desenvolvedores do Dropbox.

  2. Escolha Criar aplicação.

  3. Escolha Acesso com escopo.

  4. Para o tipo de acesso, escolha o tipo de acesso apropriado para seu aplicativo.

  5. Forneça um nome para seu aplicativo.

  6. Escolha Criar aplicação.

  7. Na página de visão geral do aplicativo, abra a seção OAuth2. Deixe a lista de URI de redirecionamento vazia por enquanto — você adicionará o URL exclusivo de retorno de chamada na Etapa 3.

  8. Na mesma seção, escolha a lista suspensa abaixo de Permitir clientes públicos (concessão implícita e PKCE) e escolha Não permitir nas opções.

  9. Registre a chave do aplicativo e o segredo do aplicativo, pois você precisará das informações para configurar o provedor de recursos do Dropbox no AgentCore Identity.

  10. Na guia Permissões do aplicativo, selecione os escopos necessários para seu aplicativo.

Para obter mais detalhes, consulte o guia de implementação do OAuth do Dropbox.

Etapa 2: criar o provedor de credenciais de AgentCore identidade

Para configurar o Dropbox como um provedor de recursos externos, use o seguinte:

{
  "name": "DropBox",
  "credentialProviderVendor": "DropboxOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}

A CreateOauth2CredentialProvider resposta inclui um callbackUrl campo. Esse URL é exclusivo para esse 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: registre o URL exclusivo de retorno de chamada com o Dropbox

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

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

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

  3. Salve as alterações.