Usar autenticação delegada

Neste artigo, você aprenderá a usar o acesso delegado com o módulo Microsoft Entra PowerShell. O acesso delegado permite que um aplicativo execute ações em nome de um usuário que está conectado no momento.

Esse cenário é ideal para tarefas de gerenciamento único e ambientes que exigem entrada manual, como aqueles que usam autenticação multifator (MFA). Também facilita o teste de scripts, aprendizado e gerenciamento de tarefas espontaneamente sem a necessidade de configurar entidades de serviço ou outros métodos de autenticação somente de aplicativo que não envolvam interação do usuário.

Embora o método de autenticação de acesso delegado seja o método de entrada recomendado, você também pode usar outros métodos de autenticação interativa, como:

  • Fluxo do código de autorização
  • Fluxo de código do dispositivo
  • Token de acesso

Neste artigo, você aprenderá as várias maneiras de entrar no Microsoft Entra PowerShell para gerenciar seus recursos de Microsoft Entra.

Prerequisites

Para se conectar ao Microsoft Entra PowerShell com acesso delegado, você precisa:

Nesta seção, você aprenderá a usar o acesso delegado com um aplicativo personalizado para se conectar ao módulo. Você pode adaptar o aplicativo personalizado às suas necessidades específicas para isolar e limitar as permissões concedidas para o uso do módulo.

Execute o comando a seguir para se conectar ao módulo com acesso delegado usando um aplicativo personalizado. Você precisa entrar com pelo menos uma função de Administrador de Aplicativos na Nuvem .

Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -ClientId <your-custom-app-id>

Para obter o -ClientId valor, conhecido como your-custom-app-id no exemplo, siga as etapas no guia Criar um aplicativo personalizado .

Outros métodos de entrada

Nesta seção, você aprenderá a usar outros métodos de entrada para se conectar ao Microsoft Entra PowerShell.

Usar o fluxo de código de autorização

O método de autenticação de entrada padrão do módulo usa um navegador da Web e um token de acesso para entrar. Para entrar interativamente, use o cmdlet Connect-Entra , que usa um prompt de entrada interativo baseado em navegador por padrão.

Connect-Entra

Abre seu navegador padrão e inicia o fluxo de código de autorização para carregar a página de entrada do Microsoft Entra.

Por exemplo, para obter os detalhes de um usuário, adicione o -Scopes parâmetro para fornecer uma lista de permissões necessárias.

Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All'

Use o método de autenticação por fluxo de código de dispositivo

O fluxo de código do dispositivo instrui você a abrir uma página do navegador em microsoft.com/devicelogin e inserir o código exibido na sessão do PowerShell.

Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -UseDeviceCode

Use seu token de acesso

O próximo exemplo pressupõe que você já tenha um token de acesso. Consulte Como obter o token de acesso do ponto de extremidade do token.

$accessToken = '{my-securely-acquired-token}'
$secureString = ConvertTo-SecureString -String $accessToken -AsPlainText -Force
Connect-Entra -AccessToken $secureString

Usar a autenticação sem senha

A autenticação sem senha é um método de verificação da identidade de um usuário sem o uso de uma senha. As senhas são um vetor de ataque primário e a autenticação sem senha é uma estratégia para atenuar ataques em que os maus atores usam engenharia social, phishing e ataques de pulverização para comprometer senhas.

Microsoft Entra PowerShell dá suporte aos seguintes métodos de autenticação sem senha:

  • Windows Hello para Empresas
  • Fast ID Online v2.0 (FIDO2)
  • Aplicativo Microsoft Authenticator
  • Autenticação baseada em certificado (CBA)

Note

A opção de chaves de segurança FIDO2 só tem suporte no PowerShell 7 e superior.

Para obter mais informações, veja Opções de autenticação sem palavra-passe para Microsoft Entra ID.

Erros comuns e dicas de solução de problemas

Os erros comuns de autenticação incluem:

  • "Privilégios insuficientes para concluir a operação" – o erro ocorre se suas credenciais estiverem incorretas ou se você não tiver as permissões necessárias para acessar o 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. Verifique se você instala e carrega o módulo correto para o cmdlet que deseja usar.

Para obter um guia detalhado sobre como solucionar erros comuns, consulte o guia de solução de problemas.