View a markdown version of this page

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

Zoom

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

Saída

nota

Você só pode configurar um aplicativo Zoom OAuth2 como federação de usuários ou cliente M2M OAuth2, mas não ambos.

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 Zoom OAuth2 primeiro e depois retorne ao console do desenvolvedor do Zoom para registrar a URL de retorno de chamada depois que a AgentCore Identity a emitir.

Etapa 1: criar o cliente Zoom OAuth2

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

Para configurar um aplicativo Zoom OAuth2

  1. Faça login no Zoom App Marketplace.

  2. Escolha Desenvolver>Criar aplicação.

  3. Para um aplicativo de federação de usuários, selecione Aplicativo geral e escolha Criar.

    • Na página de detalhes do aplicativo, adicione um nome para seu aplicativo e selecione como ele será gerenciado.

    • Na seção Informações do OAuth, deixe o URL de redirecionamento do OAuth e as listas de permissões do OAuth vazios por enquanto — você adicionará o URL exclusivo de retorno de chamada na Etapa 3.

  4. Para um aplicativo M2M, selecione Aplicativo OAuth de servidor para servidor e escolha Criar.

    • Adicione um nome para seu aplicativo.

    • Na página de detalhes do aplicativo, escolha Escopos e adicione os escopos necessários para seu aplicativo.

    • Abra as informações e forneça o nome da empresa e as informações de contato do desenvolvedor.

  5. Registre o ID do cliente e o segredo do cliente que foram gerados para seu aplicativo. Você precisará desses valores para configurar o provedor de credenciais do Zoom em AgentCore Identity.

Para obter mais detalhes, consulte a documentação de integração do Zoom.

Etapa 2: criar o provedor de credenciais de AgentCore identidade

Para configurar o Zoom como um provedor de recursos de saída, use o seguinte:

{
  "name": "Zoom",
  "credentialProviderVendor": "ZoomOauth2",
  "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 Zoom

Retorne ao console do desenvolvedor do Zoom 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 Zoom 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.