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.

Gerenciar o acesso de aplicativos de terceiros ao Atlas

As conexões de aplicativos do MongoDB Atlas permitem que aplicativos de terceiros ajam em nome dos usuários do Atlas por meio de acesso delegado pelo usuário. Como um Organization Owner, você controla se os aplicativos podem se conectar à sua organização.

Esta página descreve como:

  • Habilite ou desabilite conexões de aplicativos de terceiros para sua organização.

  • Defina o tempo de vida máximo do token de atualização para aplicativos autorizados.

  • Veja os aplicativos que os usuários autorizaram.

  • Entenda qual limpeza permanece sob sua responsabilidade ao desativar o acesso de um aplicativo.

Quando um usuário autoriza um aplicativo, o aplicativo age em nome desse usuário. O aplicativo recebe tokens que permitem chamar a Atlas Administration API com as mesmas permissões que o usuário possui em suas organizações e projetos do Atlas. Se o usuário não puder realizar uma ação, o aplicativo também não poderá realizá-la em seu nome.

Como o acesso é delegado a partir das próprias permissões do usuário:

  • As permissões efetivas do aplicativo mudam automaticamente quando as funções do usuário mudam.

  • As operações em sua organização só são bem-sucedidas quando sua organização permite conexões de aplicativos de terceiros e o usuário autorizador possui a função necessária para a operação.

Os aplicativos usam o OAuth 2.1 fluxo de código de autorização com Proof Key for Code Exchange (PKCE) para obter acesso delegado. Para aprender como os aplicativos se integram a esse fluxo, consulte Integrar seu aplicativo com conexões de aplicativo do Atlas.

Se as conexões de aplicativos de terceiros estão habilitadas por padrão depende de quando sua organização foi criada:

  • Organizações existentes, e organizações criadas antes do lançamento do Atlas App Connections, têm conexões de aplicativos de terceiros desativadas por padrão. Um Organization Owner deve habilitá-las.

  • Novas organizações que um usuário cria ao se cadastrar no Atlas após o lançamento do Atlas aplicativo Connections têm conexões de aplicativos de terceiros habilitadas por padrão. Isso não se aplica a usuários que ingressam em uma organização existente.

Enquanto as conexões de aplicativos de terceiros estiverem desativadas, qualquer token de acesso delegado que um aplicativo obtiver receberá uma resposta 403 Forbidden ao chamar a Atlas Administration API para sua organização.

Ao desativar conexões de aplicativos de terceiros para uma organização que as permitia anteriormente, a alteração entra em vigor imediatamente: as chamadas da Atlas Administration API que visam sua organização por meio de delegação de usuário começam a retornar 403 Forbidden.

Desativar conexões de aplicativos de terceiros impede que os aplicativos acessem o plano de controle por meio de delegação de usuário. Isso não revoga outros acessos que um aplicativo já possa ter:

  • O acesso ao Data plane continua. Os usuários de banco de dados e as strings de conexão criados por um aplicativo continuam funcionando, portanto, as sessões existentes do driver do MongoDB ou do pool de conexões permanecem ativas.

  • Outras credenciais do plano de controle continuam. Se um aplicativo criou contas de serviço ou chaves de API, elas manterão o acesso ao plano de controle até que você as remova.

Para remover totalmente o acesso de um aplicativo, você deve limpar esses recursos por conta própria. Consulte Limitações e Responsabilidades.

Para permitir ou restringir conexões de aplicativos de terceiros, siga estas etapas:

1

Na IU do Atlas, abra as configurações da sua organização e selecione a aba App Connections.

2

Na seção Third-Party Apps, ative ou desative Allow users to connect third-party apps.

3

O Atlas solicita que você confirme. Para permitir conexões, clique em Allow. Para restringi-las, clique em Restrict.

A seção Third-Party Apps lista os aplicativos que podem se conectar à sua organização. Cada aplicativo mostra um selo ALLOWED ou RESTRICTED que reflete a configuração atual. Quando as conexões são permitidas, um botão View connections leva você aos aplicativos que os usuários autorizaram.

Essa configuração controla o acesso de aplicativos de terceiros. Para aprender sobre a configuração separada que controla o acesso por meio do Remote MCP servidor, consulte Gerenciar o acesso do cliente de IA à sua organização.

Aplicativos autorizados usam tokens de atualização para obter novos tokens de acesso sem solicitar ao usuário que reautorize. Como um Organization Owner, você pode definir o tempo de vida máximo do token de atualização para aplicativos autorizados em sua organização.

Dois limites regem os tokens de atualização:

  • Tempo de vida máximo é o período mais longo que um token de atualização permanece válido. Quando um token atinge esse limite, o usuário deve reautorizar o aplicativo, independentemente da atividade. O padrão é 30 dias.

  • Tempo de inatividade é quanto tempo um token de atualização permanece válido sem uso. Um token que não é usado dentro desse período expira. O padrão é 7 dias. O tempo de vida ocioso nunca pode exceder o tempo de vida máximo.

Na IU do Atlas, um Organization Owner pode ajustar o tempo de vida máximo. Você pode personalizar o tempo de vida ocioso apenas por meio da Atlas Administration API, não da IU do Atlas.

Observação

Os tempos de vida padrão são configurados por cliente OAuth, portanto, o padrão que se aplica depende do cliente que se conecta.

Para definir o tempo máximo de vida útil do token de atualização, conclua as seguintes etapas:

1

Na IU do Atlas, abra as configurações da sua organização e selecione a aba App Connections.

2

Na seção Maximum refresh token lifetime, clique em Set max lifetime.

3

Selecione um dos valores predefinidos: 8 hours, 12 hours, 24 hours, 3 days, 7 days ou 30 days. Para inserir um valor diferente, selecione Custom, digite um número e selecione HOUR(S) ou DAY(S). Um valor personalizado deve ser de 365 dias ou menos.

4

Após salvar, a seção exibe o tempo de vida máximo atual. Para alterar o valor, clique no ícone de edição.

Ao contrário da configuração que permite ou restringe conexões de aplicativos de terceiros, o tempo máximo de vida útil do token de atualização é uma configuração única para toda a organização. Isso se aplica a todas as conexões de aplicativos em sua organização, incluindo clientes que se conectam por meio do Remote MCP servidor. Para saber mais sobre esses clientes, consulte Gerenciar o acesso de clientes de IA à sua organização.

Para remover o tempo de vida máximo do token de atualização que você definiu para sua organização, clique no ícone de excluir ao lado do valor atual e, em seguida, clique em Clear para confirmar. Depois de limpar a configuração, a vida útil efetiva retorna ao padrão para cada cliente.

Você pode revisar os aplicativos de terceiros que os usuários da sua organização autorizaram, com metadados sobre cada conexão.

1

Na IU do Atlas, clique em Applications em Identity & Access.

2

Selecione a guia Connected Apps.

3

A seção Connected Third-Party Apps lista cada aplicativo autorizado, seu editor e quantos membros da organização se conectaram a ele.

4

Clique em View all ao lado de um aplicativo para abrir sua página de conexões.

A página de conexões de um aplicativo lista cada nó conectado com os seguintes detalhes:

  • Users: o Atlas user que autorizou o aplicativo.

  • Last used: quando o aplicativo agiu mais recentemente em nome desse usuário.

  • Last authorized: quando o usuário autorizou o aplicativo mais recentemente.

Importante

Desativar o acesso de um aplicativo não remove os recursos que o aplicativo criou. O Atlas não exclui automaticamente usuários de banco de dados, contas de serviço, chaves de API ou outros recursos quando você desativa o acesso. A limpeza desses recursos é de sua responsabilidade. Até que você os remova, essas credenciais permanecem ativas em sua conta do Atlas e podem manter o acesso ao plano de dados ou ao plano de controle.

Ao desativar o acesso de um aplicativo, esteja ciente do seguinte:

  • O Atlas não exclui automaticamente os usuários de banco de dados que um aplicativo criou em nome de seus usuários. Esses usuários de banco de dados e suas string de conexão continuam funcionando depois que você desativa o acesso.

  • O Atlas não exclui automaticamente contas de serviço ou chaves de API criadas por um aplicativo. Essas credenciais mantêm o acesso ao plano de controle até que você as remova.

  • O Atlas não exclui automaticamente outros recursos que um aplicativo criou, como clusters ou projetos.

  • As conexões existentes do plano de dados permanecem ativas até serem encerradas por meio de eventos normais do ciclo de vida da conexão.

Para realizar o offboarding completo de um aplicativo, consulte Melhores práticas de offboarding.

Quando você para de usar um aplicativo, desabilitar seu acesso é apenas o primeiro passo. Para remover totalmente um aplicativo e proteger seus dados, conclua a seguinte limpeza:

  • Exclua quaisquer usuários de banco de dados que o aplicativo criou em nome de seus usuários, se nenhum outro aplicativo ou carga de trabalho depender deles.

  • Antes de excluir um usuários de banco de dados, confirme se sua string de conexão não é compartilhada por outro aplicativo ou carga de trabalho que ainda precise de acesso.

  • Exclua todas as contas de serviço ou chaves de API que o aplicativo criou, que, de outra forma, manteriam o acesso ao plano de controle.

  • Revise e remova quaisquer cluster, projeto ou outro recurso que o aplicativo tenha provisionado e que não sejam mais necessários.