View a markdown version of this page

Zoom - Amazon Bedrock AgentCore
Saída

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 uma federação de usuários ou cliente M2M OAuth2, mas não ambos.

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 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 de retorno de chamada exclusivo.

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 seu aplicativo 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 de retorno de chamada exclusivo 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 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 Zoom

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