Overview
Conexiones de aplicaciones de MongoDB Atlas permite que las aplicaciones de terceros actúen en nombre de los usuarios de Atlas a través de un acceso delegado por el usuario. Como Organization Owner, usted controla si las aplicaciones pueden conectarse a su organización.
Esta página describe cómo:
Habilitar o deshabilitar las conexiones de aplicaciones de terceros para su organización.
Establezca la vida útil máxima del token de actualización para las aplicaciones autorizadas.
Ver las aplicaciones que los usuarios han han autorizado.
Comprenda qué tareas de limpieza siguen siendo su responsabilidad cuando deshabilita el acceso de una aplicación.
Cómo funciona el acceso delegado
Cuando un usuario autoriza una aplicación, la aplicación actúa en nombre de ese usuario. La aplicación recibe tokens que le permiten llamar a la Atlas Administration API con los mismos permisos que tiene el usuario en sus organizaciones y proyectos de Atlas. Si el usuario no puede realizar una acción, la aplicación tampoco puede realizarla en su nombre.
Porque el acceso se delega de los propios permisos del usuario:
Los permisos efectivos de la aplicación cambian automáticamente cuando cambian los roles del usuario.
Las operaciones contra su organización solo tienen éxito cuando su organización permite conexiones de aplicaciones de terceros y el usuario que autoriza tiene el rol necesario para la operación.
Las aplicaciones usan el OAuth 2.1 Flujo de código de autorización con clave de prueba para el intercambio de código (PKCE) para obtener acceso delegado. Para aprender cómo las aplicaciones se integran con este flujo, consulte Integre su aplicación con las conexiones de aplicaciones de Atlas.
Habilitar o deshabilitar conexiones de aplicaciones de terceros
Si las conexiones de aplicaciones de terceros están habilitadas por defecto depende de cuándo se creó su organización:
Las organizaciones existentes, y las organizaciones creadas antes del lanzamiento de Atlas App Connections, tienen las conexiones de aplicaciones de terceros deshabilitadas por defecto. Un Organization Owner debe habilitarlos.
Las nuevas organizaciones que un usuario crea cuando se registra en Atlas después de que se lanzara Atlas App Connections tienen las conexiones de aplicaciones de terceros habilitadas por defecto. Esto no se aplica a los usuarios que se unen a una organización existente.
Mientras las conexiones de aplicaciones de terceros están deshabilitadas, cualquier token de acceso delegado que obtenga una aplicación recibe una respuesta 403 Forbidden cuando llama a la Atlas Administration API de su organización.
Cuando deshabilita las conexiones de aplicaciones de terceros para una organización que las permitía anteriormente, el cambio surte efecto inmediatamente: al llamar a la Atlas Administration API con destino a su organización a través de la delegación de usuarios, se comienza a devolver 403 Forbidden.
Deshabilitar las conexiones de aplicaciones de terceros impide que las aplicaciones accedan al plano de control a través de la delegación de usuarios. No revoca otro acceso que una aplicación ya podría tener:
El acceso al plano de datos continúa. Los usuarios de base de datos y las cadenas de conexión creadas por una aplicación siguen funcionando, por lo que las sesiones existentes del driver de MongoDB o del pool de conexiones permanecen activas.
Otras credenciales del plano de control continúan. Si una aplicación creó cuentas de servicio o claves de API, estas conservan el acceso al plano de control hasta que las remueva.
Para remover completamente el acceso de una aplicación, debe limpiar estos recursos usted mismo. Consulte Limitaciones y responsabilidades.
Para permitir o restringir las conexiones de aplicaciones de terceros, siga los pasos siguientes:
La sección Third-Party Apps enumera las aplicaciones que pueden conectarse a su organización. Cada aplicación muestra una insignia ALLOWED o RESTRICTED que refleja la configuración actual. Cuando se permiten las conexiones, un botón View connections te lleva a las aplicaciones que los usuarios han autorizado.
Esta configuración controla el acceso para aplicaciones de terceros. Para aprender sobre la configuración independiente que controla el acceso a través del servidor Remote MCP, consulte Gestionar el acceso de clientes de IA a su organización.
Establecer la vida útil máxima del token de actualización
Las aplicaciones autorizadas utilizan refresh tokens para obtener nuevos access tokens sin solicitar al usuario que vuelva a autorizar. Como Organization Owner, puede establecer la vida útil máxima del token de actualización para las aplicaciones autorizadas en su organización.
Dos límites rigen los tokens de actualización:
La duración máxima es el período más largo que un token de actualización permanece válido. Cuando un token alcanza este límite, el usuario debe reautorizar la aplicación, independientemente de la actividad. El valor por defecto es de 30 días.
Vida útil en inactividad es el tiempo que un token de actualización permanece válido sin uso. Un token que no se utiliza en este período caduca. El valor por defecto es 7 días. La vida útil en inactividad nunca puede exceder la vida útil máxima.
En la Interfaz de Usuario de Atlas, un Organization Owner puede ajustar la vida útil máxima. Solo se puede personalizar el tiempo de inactividad a través de Atlas Administration API, no la Interfaz de Usuario de Atlas.
Nota
Los tiempos de vida por defecto se configuran para cada cliente OAuth, por lo que el valor por defecto que se aplica depende del cliente que se conecta.
Para establecer la vida útil máxima del token de actualización, siga los siguientes pasos:
Después de guardar, la sección muestra la vida útil máxima actual. Para cambiar el valor, haga clic en el icono de edición.
A diferencia de la configuración que permite o restringe las conexiones de aplicaciones de terceros, la duración máxima del token de actualización es una única configuración para toda la organización. Se aplica a cada conexión de aplicación en su organización, incluidos los clientes que se conectan a través del servidor Remote MCP. Para obtener más información sobre esos clientes, consulte Gestione el acceso de clientes de IA a su organización.
Borrar la duración máxima del token de actualización
Para remover la vida útil máxima del token de actualización que estableció para su organización, haga clic en el icono de borrar junto al valor actual, luego haga clic en Clear para confirmar. Después de borrar la configuración, la vida útil efectiva vuelve al valor por defecto para cada cliente.
Ver aplicaciones autorizadas
Puede revisar las aplicaciones de terceros que los usuarios de su organización han autorizado, con metadatos sobre cada conexión.
La página de conexiones de una aplicación enumera cada nodo conectado con los siguientes detalles:
Users: el Atlas user que autorizó la aplicación.
Last used: cuando la aplicación actuó más recientemente en nombre de ese usuario.
Last authorized: cuando el usuario autorizó la aplicación más recientemente.
Limitaciones y responsabilidades
Importante
Deshabilitar el acceso de una aplicación no remueve los recursos que la aplicación creó. Atlas no borra automáticamente usuarios de base de datos, cuentas de servicio, claves de API u otros recursos cuando desactiva el acceso. Limpiar estos recursos es su responsabilidad. Hasta que las remueva, estas credenciales permanecen activas en su cuenta de Atlas y pueden mantener acceso al plano de datos o al plano de control.
Cuando deshabilite el acceso de una aplicación, tenga en cuenta lo siguiente:
Atlas **no** borra automáticamente los usuarios de base de datos que una aplicación creó en nombre de sus usuarios. Estos usuarios de base de datos y sus cadenas de conexión siguen funcionando después de deshabilitar el acceso.
Atlas no borrar automáticamente las cuentas de servicio o las claves de API que una aplicación creó. Estas credenciales mantienen acceso al plano de control hasta que las remueva.
Atlas no borra automáticamente otros recursos que una aplicación creó, como clústeres o Proyectos.
Las conexiones existentes del plano de datos permanecen activas hasta que se cierren a través de los eventos normales del ciclo de vida de la conexión.
Para dar de baja completamente una aplicación, consulte Mejores prácticas de baja.
Mejores prácticas de desvinculación
Cuando dejas de usar una aplicación, deshabilitar su acceso es solo el primer paso. Para dar de baja completamente una aplicación y proteger sus datos, realice la siguiente limpieza:
Borre los usuarios de base de datos que la aplicación creó en nombre de sus usuarios si ninguna otra aplicación o carga de trabajo depende de ellos.
Antes de borrar un usuario de base de datos, confirme que su cadena de conexión no es compartida por otra aplicación o carga de trabajo que aún necesita acceso.
Borre cualquier cuenta de servicio o clave API que haya creado la aplicación, que de lo contrario conservarían el acceso al plano de control.
Revisión y remover cualquier clúster, Proyecto u otros recurso provisionamineto por la aplicación que ya no sean necesarios.