Tutorial: Script do PowerShell para configurar links seguros no Microsoft 365

Script do PowerShell para configuração de links seguros no Microsoft 365

Visão geral

Este script do PowerShell configura o Microsoft 365 para garantir que os e-mails de simulação de phishing do CyberHoot sejam entregues corretamente, mantendo todas as proteções de segurança reais totalmente ativadas.

Aborda duas configurações necessárias:

1. Entrega Avançada
   Permite que os e-mails de simulação de phishing do CyberHoot ignorem os filtros de spam e phishing.
2. Links seguros
   Impede que o Microsoft Defender reescreva ou clique antecipadamente em URLs de simulação, eliminando falsos positivos nos relatórios de cliques.

Pré-requisitos

Requerimentos do sistema

• PowerShell
  • Windows PowerShell 5.1 ou posterior

Permissões

• Função de Administrador do Exchange Online

Módulo PowerShell

• ExchangeOnlineManagement
  O script instala automaticamente este módulo caso ele esteja faltando.

Início Rápido

Passo 1: Baixe e salve o script

1. Abra o arquivo de script.
   CyberHoot-M365.txt
   https://cyberhoot.com/wp-content/uploads/2026/02/CyberHoot-M365.txt
2. Copie todo o conteúdo.
   • Ctrl + A, depois Ctrl + C
3. Abra um editor de texto
   • Bloco de notas
4. Cole o script no editor.
5. Salve o arquivo como CyberHoot-M365.ps1
   Arquivo → Salvar como
   Nome do arquivo: “CyberHoot-M365.ps1”
   Salvar como tipo: Todos os arquivos

Etapa 2: execute o script

Windows

1. Abra PowerShell como administrador
2. Navegue até a pasta onde o script foi salvo:

3. cd C:\Users\SeuNomeDeUsuário\Downloads

1. Execute o script:

5. .\CyberHoot-M365.ps1 -Modo Aplicar -Verbose

Etapa 3: Autenticação

Quando solicitado:

1. Insira o e-mail do administrador do Microsoft 365.
   Exemplo: admin@company.onmicrosoft.com
2. Faça login através da janela do navegador.
3. Preencha a MFA, se necessário.

Tempo estimado: dois a cinco minutos

Etapa 4: Verificar a configuração

Verificar entrega antecipada

1. Acesse https://security.microsoft.com
2. Acessar
   E-mail e colaboração → Políticas e regras → Políticas contra ameaças → Entrega avançada
3. Selecione os Simulação de phishing aba
4. Confirme o seguinte:
   • Cinco domínios CyberHoot presentes
   • Quatro endereços IP da CyberHoot presentes.

Verifique se os links são seguros.

1. No Microsoft Defender, navegue até
   E-mail e colaboração → Políticas e regras → Políticas contra ameaças → Links seguros
2. Abra Exclusões de links seguros do CyberHoot
3. Confirmar Não reescreva os seguintes URLs no e-mail. Mostra cinco domínios CyberHoot

Modos de script

Aplicar Modo (Padrão)

Aplica a configuração do CyberHoot ao locatário:

.\CyberHoot-M365.ps1 -Modo Aplicar -Verbose

Modo de validação

Executa uma verificação somente leitura e reporta configurações ausentes:

.\CyberHoot-M365.ps1 -Modo Validar -Verbose

Saída de amostra:

Relatório de validação:

Entrega antecipada:

Regra existe: Falsa

Domínios ausentes: 5

Intervalos de IP ausentes: 4

Links seguros:

Política existe: Falsa

URLs DoNotRewrite ausentes: 5

Modo de reversão

Remove todas as configurações relacionadas ao CyberHoot:

.\CyberHoot-M365.ps1 -Modo Rollback -Verbose

Anotações importantes

• Compatível com múltiplos fornecedores, mescla sem sobrescrever os fornecedores de simulação de phishing existentes.
• Idempotente, seguro para executar várias vezes.
• Configuração para todo o locatário, sem necessidade de configuração por usuário.
• A propagação completa pode levar até vinte e quatro horas, geralmente imediata.

Perguntas frequentes

Isso afetará as políticas de segurança existentes?
Não. Apenas as entradas do CyberHoot são adicionadas. Todas as proteções permanecem ativas.

O script pode ser executado várias vezes?
Sim. Não são criadas entradas duplicadas.

Isso é por usuário?
Não. A configuração se aplica a todos os locatários.

São necessárias licenças da Microsoft?
Microsoft Defender para Office 365 Plano 1 ou Plano 2, incluído em:

• Microsoft 365 E5
• Microsoft 365 E3 com Defender para Office 365
• Microsoft 365 Empresas Premium

Como faço para remover tudo depois?
Executar o modo Rollback:

.\CyberHoot-M365.ps1 -Modo Rollback

Documentação Adicional

📘 Guia de configuração completo
https://cyberhoot.com/wp-content/uploads/2026/02/CyberHoot-M365-Setup-Instructions.txt

Última Atualização: 2 de fevereiro de 2025
Versão do script: 2.0