Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Conecte um aplicativo à sua conta do Atlas

Você pode permitir que aplicativos de terceiros acessem sua conta do MongoDB Atlas. Ao conectar um aplicativo, ele se conecta ao Atlas por meio de Conexões de Aplicativo do Atlas, a plataforma OAuth 2.1 do Atlas. Em vez de pedir que você crie e cole credenciais, o aplicativo solicita que você faça login no Atlas e autorize-o a agir em seu nome.

Esta página descreve o que acontece quando você conecta um aplicativo de terceiros à sua conta do Atlas, incluindo:

  • O que significa acesso delegado e o que "agir em seu nome" permite.

  • Como funciona o fluxo de conexão, desde a escolha do Atlas até o retorno ao aplicativo.

  • Como revisar as permissões que você concede na tela de consentimento.

  • Onde visualizar os aplicativos que você conectou.

  • Como revogar o acesso e o que a revogação faz e não faz.

Ao conectar sua conta do Atlas a um aplicativo de terceiros:

  • Seus dados permanecem em sua conta Atlas. Conectar um aplicativo não move a origem dos seus dados nem torna esse aplicativo o sistema de registro. Seus cluster, dados e outros recurso do Atlas permanecem em sua própria conta Atlas e sob seu controle.

  • O aplicativo atua em seu nome por meio de acesso delegado. O Atlas emite os tokens OAuth do aplicativo que permitem que ele execute ações do Atlas com suas permissões. See Consulte como funciona o acesso delegado.

  • Você é cobrado pelos recursos que o aplicativo usa. Qualquer uso de recursos do Atlas que um aplicativo provisiona ou opera em seu nome é cobrado em sua própria conta do Atlas.

Quando você autoriza um aplicativo, ele age em seu nome. O Atlas emite os tokens de aplicativo que permitem que ele chame a Atlas Administration API com as mesmas permissões que você possui em suas organizações e projetos do Atlas. Se você não puder realizar uma ação no Atlas, o aplicativo também não poderá realizá-la em seu nome.

Como o acesso é delegado a partir de suas próprias permissões:

  • O acesso do aplicativo muda automaticamente quando suas funções mudam. Se o seu acesso ao Atlas for reduzido ou removido, o acesso do aplicativo irá atualizar para corresponder.

  • O aplicativo só pode atuar em organizações que permitem conexões de aplicativos de terceiros. Organization Owner controlam essa configuração. Mesmo depois de autorizar um aplicativo, ele não pode operar em uma organização que não tenha habilitado conexões de aplicativos de terceiros.

Atualmente, o acesso delegado não é limitado a organizações, projetos ou operações específicas: um aplicativo pode agir em qualquer lugar que suas permissões do Atlas permitirem. Como um aplicativo atua com suas permissões completas do Atlas, autorize apenas aplicativos em que você confia.

Você inicia a conexão a partir do aplicativo, não do Atlas. A redação exata e as telas variam de acordo com o aplicativo, mas a parte do fluxo referente ao Atlas é a mesma para todos os aplicativos.

1

No aplicativo, escolha o MongoDB Atlas como seu banco de dados ou inicie a opção para conectar sua conta do Atlas. O aplicativo redireciona você para o Atlas para fazer login.

2

Faça login com sua conta Atlas. Se você já estiver conectado, o Atlas poderá pular esta etapa. Se você não tiver uma conta Atlas, poderá criar uma para continuar.

3

O Atlas exibe uma tela de consentimento que lista as permissões que o aplicativo está solicitando. Revisar as permissões e, em seguida, selecione Authorize para conceder acesso ou Decline para cancelar. Para obter detalhes sobre o que a tela de consentimento mostra, consulte Revisar permissões e consentimento.

4

Depois de selecionar Authorize, o Atlas retorna você ao aplicativo, que conclui a conexão. O aplicativo agora pode agir em seu nome com suas permissões do Atlas.

Antes de autorizar um aplicativo, o Atlas exibe uma tela de consentimento que resume o acesso que o aplicativo está solicitando: a capacidade de ver quais recursos do Atlas você pode acessar e agir em seu nome, com as mesmas permissões que você possui, em organizações que permitem conexões de aplicativos de terceiros.

Se você selecionar Authorize, o Atlas concede ao aplicativo acesso delegado e retorna você ao aplicativo. Se você selecionar Decline, o Atlas cancela a conexão e o aplicativo não recebe acesso.

Você pode revisar os aplicativos que autorizou a agir em seu nome nas configurações da sua conta Atlas. Em Atlas Settings, selecione App Connections.

Organization Owner visualizam todos os aplicativo autorizados em uma organização a partir de Organization Settings; consulte Visualizar aplicativos autorizados.

Você pode revogar o acesso de um aplicativo a qualquer momento do mesmo local onde você visualiza seus aplicativos conectados.

1

Em Atlas Settings, selecione App Connections.

2

Encontre o aplicativo e selecione Revoke. O Atlas lhe pede para confirmar. Selecione Revoke para continuar ou Cancel para manter a conexão.

Depois de revogar o acesso, o aplicativo não poderá mais agir em seu nome em nenhuma organização e deverá ser reautorizado antes de poder se conectar novamente. As alterações podem levar até 10 minutos para entrar em vigor.

Organization Owner também podem desativar conexões de aplicativos de terceiros para toda a organização; consulte Ativar ou desativar conexões de aplicativos de terceiros.

Ao revogar o acesso, o aplicativo não poderá mais realizar ações em seu nome.

Importante

A revogação do acesso não exclui os recursos que o aplicativo criou para você, como usuários de banco de dados, clusters ou projetos. Esses recursos, e quaisquer credenciais que o aplicativo criou, permanecem ativos até que você ou seu Organization Owner os removam.

Se você não usa mais um aplicativo, peça ao seu Organization Owner para revisar e remover quaisquer recursos que ele tenha criado. Para etapas de gerenciamento e offboarding em nível de organização, consulte Gerenciar o acesso de aplicativos de terceiros ao Atlas.