Overview
Algunas funcionalidades de Atlas, como Data Federation, requieren acceso a recursos en tu entorno de almacenamiento de blobs de Azure. Para conceder acceso de manera segura, cree o actualice un <span class=\" \">Azure <a class=\" \" target=\" \" href=\" \"> Service Principal <svg class=\" \" height=\" \" width=\" \" role=\" \" aria-hidden=\" \" alt=\" \" viewbox=\" \"><path d=\" \" fill=\" \"> <path d=\" \" fill=\" \"> con una política de acceso.
Acceso requerido
Para configurar el acceso de la entidad de servicio de Azure, debe tener acceso Project Owner al Proyecto.
Requisitos previos
Una cuenta de Atlas.
El Azure PowerShell o el CLI de Azure.
Configurar el acceso del Principal del servicio de Azure
Puede configurar un principal de servicio de Azure con la política de acceso para su Proyecto de Atlas desde la Atlas Administration API o la Interfaz de Usuario de Atlas. Seleccione su opción preferida:
Importante
Principal de servicio frente a registro de aplicación
No es necesario crear un nuevo registro de aplicación de Microsoft Entra ID. Atlas utiliza una aplicación multiinquilino existente registrada en la plataforma de identidad de Microsoft.
Utiliza el siguiente proceso para:
Crea un principal de servicio para la aplicación multitenant existente de Atlas en tu tenant.
Asignar los permisos adecuados a este principal de servicio en tu entorno de Azure.
No cree un nuevo registro de aplicación ni una aplicación personalizada de Microsoft Entra ID.
La interfaz de usuario de Atlas muestra el ID de la Aplicación (AppID) para la aplicación multiinquilino pre-registrada de MongoDB. Crea un principal de servicio para esta aplicación existente en tu inquilino Azure.
Puede usar Azure PowerShell o CLI para configurar el Service Principal.
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En Atlas, diríjase a la página Project Integrations.
Haz clic en la pestaña Integrations.
La página de Integraciones del proyecto se muestra.
Asigne a Atlas una relación con su cuenta de Azure.
La sección Add Atlas to your Azure Service Principal muestra los AppId que puedes utilizar con tu comando para crear uno nuevo o agregarlo a un Principal de Servicio existente para Atlas.
Nota
El AppId mostrado identifica la aplicación existente multinquilino de Microsoft Entra ID de Atlas. No necesita crear una nueva aplicación. Los siguientes comandos crean un principal de servicio para esta aplicación Atlas existente dentro de su inquilino de Azure.
Puede usar Azure PowerShell o CLI para crear o actualizar el Service Principal. Para crear un nuevo principal de servicio, siga los pasos de la ventana Authorize Azure Service Principal.
Abra una terminal de PowerShell y obtenga el ID del inquilino utilizando los comandos que se muestran en la Interfaz de Usuario.
Ingrese el ID de su directorio de Azure Active Directory en el campo de texto de la Interfaz de Usuario.
Copia y ejecuta el comando de PowerShell que aparece en la interfaz de usuario en tu PowerShell para crear un nuevo Service Principal para Atlas.
Atlas utiliza automáticamente el AppId mostrado en la sección Add Atlas to your Azure Service Principal como el valor de la opción
-AppId.Ingrese el ID del principal de servicio que creó.
El ID principal de servicio es el valor del campo
ObjectIden la salida de tu comando de PowerShell.
Ejecute el comando que se muestra para obtener su Azure Active directorio ID de inquilino. Introduzca el ID de inquilino en el campo de texto en la Interfaz de Usuario.
Copia y ejecuta el comando mostrado en la CLI Azure para crear un nuevo Director de Servicio para Atlas.
Atlas utiliza automáticamente el AppId mostrado en la sección Add Atlas to your Azure Service Principal como el valor de la opción
--id.Ingrese el ID del principal de servicio que creó.
El ID del principal de servicio es el valor del campo
iden la salida del comando.
Para crear una entidad de servicio de Azure con directiva de acceso para su proyecto de Atlas mediante la API, envíe solicitudes POST al punto de conexión cloudProviderAccess, primero con el ID del proyecto para el que desea crear una entidad de servicio y, a continuación, con el ID del proyecto y la entidad de servicio para los que configura el acceso. Para obtener más información sobre la ruta de la solicitud y los parámetros del cuerpo, consulte Crear un rol de acceso de proveedor de nube y Autorizar un rol de acceso de proveedor de nube.
Ver los Principales de Servicio Autorizados de Azure
Puedes ver todos los Azure service principals para el proyecto Atlas desde la API de administración de Atlas o la interfaz de usuario de Atlas.
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En Atlas, diríjase a la página Project Integrations.
Haz clic en la pestaña Integrations.
La página de Integraciones del proyecto se muestra.
Vea las entidades de servicio de Azure autorizadas.
Se muestra la página Azure Service Principal Access. La página muestra la lista de principales de servicios configurados para su proyecto. Para cada principal de servicio, la página muestra lo siguiente:
Nombre de campo | Descripción |
|---|---|
Service Principal | El ID del principal de servicio. |
Created Date | La fecha en que creaste y asociaste el principal del servicio con Atlas. |
Actions |
Para ver todas las entidades de servicio de Azure con directiva de acceso para su proyecto de Atlas a través de la API, envíe una solicitud GET al punto de conexión cloudProviderAccess con el ID del proyecto. Para obtener más información sobre la sintaxis y los parámetros que debe incluir en la solicitud, consulte Devolver todos los roles de acceso del proveedor de la nube.
Ver detalles del principal de servicio de Azure autorizado
Puede ver los detalles de un Azure Service Principal autorizado desde la API de administración de Atlas o la Interfaz de Usuario de Atlas.
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En Atlas, diríjase a la página Project Integrations.
Haz clic en la pestaña Integrations.
La página de Integraciones del proyecto se muestra.
Haga clic en los puntos suspensivos ( ) para el principal de servicio y seleccione View Service Principal Details en el menú desplegable.
Atlas muestra la ventana Service Principal Details. Se puede ver y copiar la información siguiente sobre el Principal de servicio autorizado:
Nombre de campo | Descripción |
|---|---|
Atlas Azure AppID | El ID de la aplicación Atlas Azure. |
Tenant ID | El ID de su directorio de Azure Active Directory. |
Service Principal ID | El ID del principal de servicio. |
Para ver una entidad de servicio de Azure con directiva de acceso para su proyecto de Atlas a través de la API, envíe una solicitud GET al punto de conexión cloudProviderAccess con el ID del proyecto. Para obtener más información sobre la sintaxis y los parámetros que debe incluir en la solicitud, consulte Devolver el rol de acceso del proveedor de la nube especificado.
Remover el principal de servicio autorizado de Azure
No puedes remover un Service Principal que esté en uso actualmente. Puedes remover los consulte Azure Principales de servicio de Azure no utilizados desde la API de administración de Atlas o desde la Interfaz de Usuario de Atlas.
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En Atlas, diríjase a la página Project Integrations.
Haz clic en la pestaña Integrations.
La página de Integraciones del proyecto se muestra.
Para eliminar una entidad de servicio de Azure con directiva de acceso para su proyecto de Atlas mediante la API, envíe una solicitud DELETE al punto de conexión cloudProviderAccess con el ID del proyecto, el nombre del proveedor de nube y el ID de la entidad de servicio que desea eliminar. Para obtener más información sobre la sintaxis y los parámetros que debe incluir en la solicitud, consulte Desautorizar un rol de acceso de proveedor de nube.