Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Configurar roles personalizados de bases de datos

Puedes crear roles personalizados en Atlas cuando los roles predefinidos no incluyen el conjunto de privilegios que deseas. Atlas aplica los roles personalizados de cada usuario de la base de datos junto con:

Puedes asignar varios roles personalizados a cada usuario de base de datos.

Nota

Limitaciones de clústeres libres y Flex

Los cambios en los roles personalizados pueden tardar hasta 30 segundos en implementarse en los clústeres Free y Flex.

Las acciones de privilegio disponibles para roles personalizados y el API de roles personalizados representan un subconjunto de las acciones de privilegio disponibles para roles integrados.

Para revisar la lista de privilegios de roles personalizados, consulta la referencia de API.

Importante

Debes utilizar el Atlas CLI, la API de Administración de Atlas, la IU de Atlas o una integración compatible para añadir, modificar o borrar roles de base de datos en los clústeres de Atlas. De lo contrario, Atlas revierte cualquier modificación de rol.

  • Usted puede asignar hasta 20 roles personalizados a un único usuario de base de datos

  • Puede crear hasta 100 roles personalizados por proyecto por defecto. IMPORTANTE: si se requieren más roles personalizados por proyecto, se puede aumentar el número de roles personalizados hasta un máximo de 1400 a través de la API de Administración de Atlas usando el endpoint Set One Project Limit.

  • Atlas audita la creación, la eliminación y las actualizaciones de roles personalizados de MongoDB en la fuente de actividad del proyecto.

  • Si asignas varios roles a un usuario y esos roles otorgan permisos en conflicto para un objeto, Atlas respetará los permisos más altos dentro de cualquier rol.

    Por ejemplo:

    Cree dos roles personalizados y asigne ambos al Usuario A:

    • El primer rol personalizado solo concede privilegios read en la base de datos. También concede bypassDocumentValidation en la base de datos.

    • El segundo rol otorga privilegios dbAdmin en su base de datos. No concede bypassDocumentValidation, lo que implica una denegación implícita de permisos de omisión.

    El usuario A tendría todos los privilegios de dbAdmin para la base de datos, ya que dbAdmin es el permiso de acceso a la base de datos más alto. El usuario A también tendría bypassDocumentValidation, ya que bypassDocumentValidation es el permiso de omisión más alto.

Para configurar roles personalizados en bases de datos, debes tener Organization Owner, Project Owner o Project Database Access Admin acceso a Atlas.

Para crear un rol de base de datos personalizado para su proyecto usando la Atlas CLI, ejecutar el siguiente comando:

atlas customDbRoles create <roleName> [options]

Para aprender más sobre la sintaxis y los parámetros de comandos, consulta la documentación de Atlas CLI para atlas customDbRoles create.

Para listar todos los roles personalizados de la base de datos para el proyecto usando la Atlas CLI, ejecutar el siguiente comando:

atlas customDbRoles list [options]

Para obtener los detalles de un único rol de base de datos personalizado en el proyecto que especificas mediante el Atlas CLI, ejecuta el siguiente comando:

atlas customDbRoles describe <roleName> [options]

Para obtener más información sobre la sintaxis y los parámetros de los comandos anteriores, consulta la documentación de Atlas CLI para atlas customDbRoles list y atlas customDbRoles describe.

Tip

Consulte: Enlaces relacionados

Para actualizar un rol personalizado de base de datos para el proyecto usando el Atlas CLI, se debe ejecutar el siguiente comando:

atlas customDbRoles update <roleName> [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consulta la documentación de Atlas CLI para atlas customDbRoles actualizar.

Para borrar un rol personalizado de base de datos del proyecto usando Atlas CLI, se debe ejecutar el siguiente comando:

atlas customDbRoles delete <roleName> [options]

Para obtener más información sobre la sintaxis y los parámetros del comando, consultar la documentación de Atlas CLI para atlas customDbRoles borrar.

No puedes borrar un rol personalizado en las siguientes situaciones:

  • Al borrar el rol, se dejarían uno o más roles secundarios sin roles principales ni acciones.

  • Al borrar el rol, se dejaría a uno o más usuarios de base de datos sin roles.

Pueden asignarse roles personalizados en la interfaz de usuario de Atlas cuando se agregue un usuario de base de datos o modifique un usuario de base de datos. Para asignar roles personalizados a través de la API de administración de Atlas, consultar Crear un usuario de base de datos o Actualizar un usuario de base de datos.