Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo, aprenderá a usar el acceso delegado con el módulo Microsoft Entra PowerShell. El acceso delegado permite a una aplicación realizar acciones en nombre de un usuario que ha iniciado sesión actualmente.
Este escenario es ideal para tareas y entornos de administración única que requieren inicio de sesión manual, como los que usan la autenticación multifactor (MFA). También facilita la prueba de scripts, aprendizaje y administración de tareas espontáneamente sin necesidad de configurar entidades de servicio u otros métodos de autenticación de solo aplicación que no impliquen la interacción del usuario.
Aunque el método de acceso delegado de autenticación es el método de inicio de sesión recomendado, también puede usar otros métodos de autenticación interactivos, como:
- Flujo del código de autorización
- Flujo de código de dispositivo
- Token de acceso
En este artículo, aprenderá las distintas formas de iniciar sesión en Microsoft Entra PowerShell para administrar los recursos de Microsoft Entra.
Prerrequisitos
Para conectarse a Microsoft Entra PowerShell con acceso delegado, necesita lo siguiente:
- Una cuenta de Microsoft Entra ID. Si aún no tiene una, puede crear una cuenta de forma gratuita.
- Uno de los siguientes roles:
- Módulo de PowerShell de Microsoft Entra instalado. Siga la guía de instalación para instalar el módulo.
Uso del acceso delegado con una aplicación personalizada (recomendado)
En esta sección, aprenderá a usar el acceso delegado con una aplicación personalizada para conectarse al módulo. Puede adaptar la aplicación personalizada a sus necesidades específicas para aislar y limitar los permisos concedidos para el uso del módulo.
Ejecute el siguiente comando para conectarse al módulo con acceso delegado mediante una aplicación personalizada. Debe iniciar sesión con al menos un rol de administrador de aplicaciones en la nube.
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -ClientId <your-custom-app-id>
Para obtener el -ClientId valor, denominado your-custom-app-id en el ejemplo, siga los pasos descritos en la guía Creación de una aplicación personalizada .
Otros métodos de inicio de sesión
En esta sección, aprenderá a usar otros métodos de inicio de sesión para conectarse a Microsoft Entra PowerShell.
Uso del flujo de código de autorización
El método de autenticación de inicio de sesión predeterminado del módulo usa un explorador web y un token de acceso para iniciar sesión. Para iniciar sesión de forma interactiva, use el cmdlet Connect-Entra , que usa una solicitud de inicio de sesión interactiva basada en explorador de forma predeterminada.
Connect-Entra
Abre el navegador predeterminado e inicia el flujo de código de autorización para cargar la página de inicio de sesión de Microsoft Entra.
Por ejemplo, para obtener los detalles de un usuario, agregue el -Scopes parámetro para proporcionar una lista de permisos necesarios.
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All'
Use el método de autenticación de flujo de código del dispositivo
El flujo de código del dispositivo le indica que abra una página del explorador en microsoft.com/devicelogin y escriba el código que se muestra en la sesión de PowerShell.
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -UseDeviceCode
Uso del token de acceso
En el ejemplo siguiente se supone que ya tiene un token de acceso. Consulta Cómo obtener un token de acceso desde el punto de conexión de tokens.
$accessToken = '{my-securely-acquired-token}'
$secureString = ConvertTo-SecureString -String $accessToken -AsPlainText -Force
Connect-Entra -AccessToken $secureString
Uso de la autenticación sin contraseña
La autenticación sin contraseña es un método para comprobar la identidad de un usuario sin usar una contraseña. Las contraseñas son un vector de ataque principal y la autenticación sin contraseña es una estrategia para mitigar los ataques en los que los actores incorrectos usan la ingeniería social, la suplantación de identidad y los ataques de difusión para poner en peligro las contraseñas.
Microsoft Entra PowerShell admite los siguientes métodos de autenticación sin contraseña:
- Windows Hello para empresas
- Fast ID Online v2.0 (FIDO2)
- Aplicación Microsoft Authenticator
- Autenticación basada en certificados (CBA)
Note
La opción de claves de seguridad FIDO2 solo se admite en PowerShell 7 y versiones posteriores.
Para obtener más información, consulte Opciones de autenticación sin contraseña para Microsoft Entra ID.
Sugerencias comunes sobre errores y solución de problemas
Entre los errores de autenticación comunes se incluyen:
- "Privilegios insuficientes para completar la operación": el error se produce si las credenciales son incorrectas o carece de los permisos necesarios para acceder al recurso de Microsoft Entra.
- "El término "nombre del cmdlet" no se reconoce como el nombre de un cmdlet: el error indica que el módulo de PowerShell Microsoft Entra no está instalado ni cargado. Asegúrese de instalar y cargar el módulo correcto para el cmdlet que desea usar.
Para obtener una guía detallada sobre cómo solucionar errores comunes, consulte la guía de solución de problemas.