Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Neste artigo, aprende a usar o acesso delegado com o módulo PowerShell da Microsoft Entra. O acesso delegado permite a uma aplicação realizar ações em nome de um utilizador com sessão atualmente iniciada.
Este cenário é ideal para tarefas de gestão única e ambientes que requerem login manual, como os que utilizam autenticação multifator (MFA). Também facilita testar scripts, aprender e gerir tarefas de forma espontânea, sem necessidade de configurar princípios de serviço ou outros métodos de autenticação exclusivos de aplicações que não envolvam interação do utilizador.
Embora o método de acesso delegado de autenticação seja o método de início de sessão recomendado, também pode usar outros métodos interativos de autenticação, tais como:
- Fluxo do código de autorização
- Fluxo de código do dispositivo
- Token de acesso
Neste artigo, aprende as várias formas de iniciar sessão no Microsoft Entra PowerShell para gerir os seus recursos Microsoft Entra.
Pré-requisitos
Para se ligar ao Microsoft Entra PowerShell com acesso delegado, precisa de:
- Uma conta Microsoft Entra ID. Se ainda não tiveres uma, podes Criar uma conta gratuitamente.
- Uma das seguintes funções:
- Módulo PowerShell Microsoft Entra instalado. Siga o guia de Instalação para instalar o módulo.
Use acesso delegado com uma aplicação personalizada (Recomendado)
Nesta secção, aprende como usar acesso delegado com uma aplicação personalizada para se ligar ao módulo. Pode adaptar a aplicação personalizada às suas necessidades específicas para isolar e limitar as permissões concedidas para o uso do módulo.
Execute o seguinte comando para se ligar ao módulo com acesso delegado usando uma aplicação personalizada. Precisa de iniciar sessão com pelo menos uma função de Administrador de Aplicações Cloud .
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -ClientId <your-custom-app-id>
Para obter o valor -ClientId, designado por your-custom-app-id no exemplo, siga os passos descritos no guia Criar uma aplicação personalizada.
Outros métodos de entrada
Nesta secção, aprende como usar outros métodos de início de sessão para se ligar ao Microsoft Entra PowerShell.
Utilizar o fluxo de código de autorização
O método padrão de autenticação de início de sessão do módulo utiliza um navegador web e um token de acesso para iniciar sessão. Para iniciar sessão de forma interativa, use o cmdlet Connect-Entra , que utiliza por defeito um prompt interativo de login baseado no navegador.
Connect-Entra
Abre o seu navegador predefinido e inicia o fluxo de código de autorização para carregar a página de início de sessão do Microsoft Entra.
Por exemplo, para obter os dados de um utilizador, adiciona o -Scopes parâmetro para fornecer uma lista de permissões necessárias.
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All'
Utilizar o método de autenticação por fluxo de código de dispositivo
O fluxo de código do dispositivo instrui-lo a abrir uma página do navegador no microsoft.com/devicelogin e inserir o código apresentado na sua sessão PowerShell.
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -UseDeviceCode
Use o seu token de acesso
O próximo exemplo assume que já tens um token de acesso. Veja Como obter o token de acesso a partir do endpoint do token.
$accessToken = '{my-securely-acquired-token}'
$secureString = ConvertTo-SecureString -String $accessToken -AsPlainText -Force
Connect-Entra -AccessToken $secureString
Use autenticação sem palavra-passe
A autenticação sem palavra-passe é um método para verificar a identidade de um utilizador sem o uso de palavra-passe. As palavras-passe são um vetor de ataque primário e a autenticação sem palavra-passe é uma estratégia para mitigar ataques onde agentes maliciosos usam engenharia social, phishing e ataques de spray para comprometer palavras-passe.
O Microsoft Entra PowerShell suporta os seguintes métodos de autenticação sem palavra-passe:
- Windows Hello para empresas
- Fast ID Online v2.0 (FIDO2)
- Aplicação Microsoft Authenticator
- Autenticação baseada em certificado (CBA)
Note
A opção de chaves de segurança do FIDO2 só é suportada no PowerShell 7 e superiores.
Para mais informações, consulte Opções de autenticação sem palavra-passe para o Microsoft Entra ID.
Erros comuns e dicas de resolução de problemas
Erros comuns de autenticação incluem:
- "Privilégios insuficientes para completar a operação" - O erro ocorre se as suas credenciais estiverem incorretas ou se não tiver as permissões necessárias para aceder ao recurso Microsoft Entra.
- "O termo 'nome do cmdlet' não é reconhecido como o nome de um cmdlet" - O erro indica que o módulo Microsoft Entra PowerShell não está instalado ou carregado. Certifique-se de instalar e carregar o módulo correto para o cmdlet que pretende usar.
Para um guia detalhado sobre a resolução de erros comuns, consulte o guia de resolução de problemas.