HowTo: script PowerShell per la configurazione dei collegamenti sicuri in M365

Script di PowerShell per la configurazione dei collegamenti sicuri in Microsoft 365

Panoramica

Questo script PowerShell configura Microsoft 365 per garantire che le email di simulazione di phishing di CyberHoot vengano recapitate correttamente, mantenendo al contempo tutte le protezioni di sicurezza reali completamente attive.

Risponde a due configurazioni richieste:

1. Consegna anticipata
   Consente alle e-mail di simulazione di phishing di CyberHoot di aggirare i filtri antispam e antiphishing.
2. Collegamenti sicuri
   Impedisce a Microsoft Defender di riscrivere o di fare clic in anticipo sugli URL di simulazione, eliminando i report sui clic falsi positivi.

Prerequisiti

Requisiti di sistema

• PowerShell
  • Windows PowerShell 5.1 o versione successiva

Permessi

• Ruolo di amministratore di Exchange Online

Modulo PowerShell

• GestioneScambioOnline
  Lo script installa automaticamente questo modulo se mancante.

Quick Start

Passaggio 1: Scarica e salva lo script

1. Apri il file di script
   CyberHoot-M365.txt
   https://cyberhoot.com/wp-content/uploads/2026/02/CyberHoot-M365.txt
2. Copia l'intero contenuto
   • Ctrl + A, poi Ctrl + C
3. Apri un editor di testo
   • Notepad
4. Incolla lo script nell'editor.
5. Salvare il file come CyberHoot-M365.ps1
   File → Salva con nome
   Nome del file: “CyberHoot-M365.ps1”
   Salva come tipo: Tutti i file

Passaggio 2: esegui lo script

Windows

1. Apri PowerShell come amministratore
2. Passare alla cartella in cui è stato salvato lo script:

3. cd C:\Utenti\Il tuo nome utente\Download

1. Esegui lo script:

5. .\CyberHoot-M365.ps1 -Modalità Applica -Verbose

Passaggio 3: autenticazione

Quando richiesto:

1. Inserisci l'indirizzo email dell'amministratore di Microsoft 365
   Esempio: admin@company.onmicrosoft.com
2. Accedi tramite la finestra del browser
3. Completare l'MFA se richiesto

Tempo stimato: da due a cinque minuti

Passaggio 4: verifica della configurazione

Verifica la consegna anticipata

1. Vai su https://security.microsoft.com
2. Accedere a
   E-mail e collaborazione → Criteri e regole → Criteri sulle minacce → Consegna avanzata
3. Seleziona il Simulazione di phishing linguetta
4. Conferma quanto segue:
   • Cinque domini CyberHoot presenti
   • Sono presenti quattro indirizzi IP CyberHoot

Verifica i link sicuri

1. In Microsoft Defender, vai a
   E-mail e collaborazione → Criteri e regole → Criteri sulle minacce → Collegamenti sicuri
2. Apri Esclusioni dei link sicuri di CyberHoot
3. Confermare Non riscrivere i seguenti URL nelle e-mail mostra cinque domini CyberHoot

Modalità di script

Modalità Applica (predefinita)

Applica la configurazione CyberHoot al tenant:

.\CyberHoot-M365.ps1 -Modalità Applica -Verbose

Modalità di convalida

Esegue un controllo di sola lettura e segnala la configurazione mancante:

.\CyberHoot-M365.ps1 -Modalità di convalida -Verbose

Output di esempio:

Rapporto di convalida:

Consegna anticipata:

Esiste una regola: Falso

Domini mancanti: 5

Intervalli IP mancanti: 4

Link sicuri:

Esiste una politica: Falso

DoNotRewriteUrls mancanti: 5

Modalità di rollback

Rimuove tutte le configurazioni relative a CyberHoot:

.\CyberHoot-M365.ps1 -Modalità Rollback -Verbose

Note Importanti

• Sicuro per più fornitori, unisce senza sovrascrivere i fornitori di simulazione di phishing esistenti
• Idempotente, sicuro da eseguire più volte
• Configurazione a livello di tenant, nessuna configurazione richiesta per utente
• La propagazione completa può richiedere fino a ventiquattro ore, in genere immediata

Domande frequenti

Ciò inciderà sulle attuali politiche di sicurezza?
No. Vengono aggiunte solo le voci CyberHoot. Tutte le protezioni rimangono attive.

Lo script può essere eseguito più volte?
Sì. Non vengono create voci duplicate.

Questo vale per utente?
No. La configurazione si applica a tutto il tenant.

Licenze Microsoft richieste?
Microsoft Defender per Office 365 Piano 1 o Piano 2, incluso con:

• Microsoft 365 E5
• Microsoft 365 E3 con Defender per Office 365
• Microsoft 365 Business Premium

Come faccio a rimuovere tutto in seguito?
Esegui la modalità Rollback:

.\CyberHoot-M365.ps1 -Modalità di rollback

Documentazione aggiuntiva

📘 Guida completa alla configurazione
https://cyberhoot.com/wp-content/uploads/2026/02/CyberHoot-M365-Setup-Instructions.txt

Ultimo aggiornamento: 2 Febbraio 2025
Versione dello script: 2.0