Conectar-se aos serviços de Assessment de Confiança Zero

Conecte a Avaliação de Confiança Zero aos serviços de Microsoft 365 e Azure que você deseja avaliar. Use login interativo para uma avaliação executada pelo usuário ou autenticação por certificado para acesso somente ao aplicativo sem armazenar as credenciais do usuário. Prepare o módulo e as permissões de serviço antes de se conectar.

Estas instruções descrevem o conector de desenvolvimento. As opções de conexão e o suporte exclusivo para aplicativo podem ser diferentes entre os pacotes publicados.

Prerequisites

Conectar-se interativamente

Escolha o tenant explicitamente para reduzir o risco de avaliar a organização errada.

  1. Ative funções elegíveis por meio de Microsoft Entra Privileged Identity Management antes de se conectar. Organize o consentimento separadamente das funções de runtime do usuário de avaliação.

  2. Conecte-se ao locatário que você deseja avaliar, substituindo o domínio de exemplo:

    Connect-ZtAssessment -Tenant contoso.onmicrosoft.com
    
  3. Conclua os prompts de serviço e examine as mensagens de status da conexão. Os serviços se autenticam separadamente, mas sessões armazenadas em cache e logon único podem reduzir os prompts. A autenticação interativa do SharePoint usa o navegador do sistema.

  4. Reconecte-se depois de alterar o acesso ou o contexto. Use -Force quando precisar atualizar as conexões existentes.

-Tenant é um alias para -TenantId e aceita um GUID de locatário ou um nome de domínio verificado para entrada interativa. Se você não incluir esse parâmetro, Microsoft Graph usará um contexto de organizações e derivará o tenant do login.

O consentimento é solicitado quando o aplicativo não tem as concessões necessárias. Novos escopos podem exigir consentimento novamente.

Selecionar serviços e opções de conexão

Por padrão, Connect-ZtAssessment conecta-se a todos os serviços disponíveis. Selecione os serviços somente depois de considerar o efeito na cobertura da avaliação.

  1. Identifique os serviços que você deseja avaliar:

    Seletor de serviço Comando subjacente
    Graph Connect-MgGraph.
    Azure Connect-AzAccount.
    AipService Connect-AipService.
    SharePointOnline Connect-SPOService.
    ExchangeOnline Connect-ExchangeOnline.
    SecurityCompliance Connect-IPPSSession.
  2. Use -Service para selecionar serviços. Por exemplo, Connect-ZtAssessment -Tenant contoso.onmicrosoft.com -Service Graph,Azure seleciona Graph e Azure. O conector adicionará o Graph primeiro se ele ainda não estiver conectado.

  3. Examine os resultados da conexão antes de executar a avaliação. Ignorar Azure limita a cobertura de infraestrutura, rede e operações de segurança (SecOps), não apenas auditoria e verificações de exportação de logs de entrada.

Use estas opções adicionais quando necessário:

Option Finalidade ou restrição
-Force Atualize as conexões existentes após o acesso ou alterações de contexto.
-SharePointAdminUrl Forneça a URL do administrador do locatário se o conector não puder inferi-la.
-UserPrincipalName Forneça a identidade do usuário para Security & Compliance.
-Environment, -ExchangeEnvironmentName Selecione ambientes de nuvem. Use os valores documentados por Get-Help Connect-ZtAssessment -Full.
-UseDeviceCode Não é um modo sem supervisão para todos os serviços. Segurança e Conformidade não dá suporte a esse fluxo neste conector. SharePoint e Proteção de Informações do Azure (AIP) têm seu próprio comportamento de autenticação.

Conectar-se com um certificado de aplicativo

Autorize a identidade do aplicativo em cada serviço, não apenas a da pessoa que o configura.

  1. Registre um aplicativo no locatário de destino. Registre a ID do aplicativo/cliente e o GUID do locatário.

  2. Configure e conceda consentimento para as permissões somente do aplicativo. Atribua funções de carga de trabalho e funções de recurso do Azure à entidade de serviço.

  3. Carregue a chave pública do certificado no registro do aplicativo. Instale o certificado correspondente e a chave privada no repositório de certificados do usuário local no computador de avaliação. Para Exchange, siga os requisitos do provedor de certificados no guia de autenticação somente do aplicativo.

  4. Se estiver se conectando a SharePoint, forneça uma chave privada exportável. O conector atual passa um arquivo de certificado temporário para sua sessão de compatibilidade Windows PowerShell. Proteja a chave e observe qualquer aviso de limpeza de arquivo temporário.

  5. Conecte-se com a ID do cliente, o GUID do locatário e a impressão digital do certificado. Substitua os espaços reservados pelos seus valores:

    Connect-ZtAssessment -ClientId '<application-id>' -TenantId '<tenant-guid>' -Certificate '<certificate-thumbprint>' -Service All
    
  6. Examine o status da conexão de cada serviço e os erros de autorização antes de executar a avaliação.

Ambos -ClientId e -TenantId são necessários com -Certificate. Não combine a autenticação de certificado com -UseDeviceCode. Para conexões somente de aplicativo entre serviços, use o GUID do locatário em vez de supondo que cada serviço aceite um nome de domínio. O conector resolve o domínio inicial para Exchange e Segurança & Conformidade.

A cobertura somente de aplicativo depende do pacote, das versões de dependência, das permissões e dos comandos usados por verificações individuais. Conexões ausentes produzem saltos relacionados ao serviço; outros erros de autorização podem aparecer no diagnóstico de teste. Examine esses resultados antes de tratar uma execução não assistida como concluída.

Próxima etapa