Analizza i log di accesso ed evidenzia connessioni da paesi non presenti in una whitelist definita.
Lo script recupera i log di accesso delle ultime N ore da Microsoft Graph e li confronta con un elenco di paesi attesi (dove l’azienda opera normalmente), segnalando ogni accesso riuscito proveniente da un paese non incluso in quella lista.
Come si usa
Scarica il file, apri PowerShell nella cartella in cui l’hai salvato ed eseguilo: tutti i parametri hanno un valore predefinito, quindi basta il nome dello script.
.\Report-AccessiPaesiInsoliti.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-AccessiPaesiInsoliti.ps1 -PaesiAttesi @("IT") -OreIndietro 24 -PercorsoCSV "C:\Report\AccessiInsoliti.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PaesiAttesi | elenco di testi | no | @("IT") | — |
-OreIndietro | numero intero | no | 24 | — |
-PercorsoCSV | testo | no | C:\Report\AccessiInsoliti.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\AccessiInsoliti.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Utente,Paese,Citta,IP,Orario. - A video, un riepilogo a colori: rosso per errori e problemi, verde quando l’esito è positivo.
Requisiti
- Microsoft Graph PowerShell SDK:
Install-Module Microsoft.Graph -Scope CurrentUser(oppure solo i sottomoduli usati dallo script). - Permessi Microsoft Graph richiesti all’accesso:
AuditLog.Read.All. La prima volta Microsoft Entra ID chiede il consenso, che per questi permessi di solito deve concedere un amministratore. - La cartella di destinazione (
C:\Report) deve già esistere: lo script non la crea. - Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Report-AccessiPaesiInsoliti.ps1.
I comandi usati dallo script
Connect-MgGraph: apre la sessione con Microsoft Graph chiedendo i permessi (scope) indicati.Get-MgAuditLogSignIn: legge i log di accesso di Entra ID, con indirizzo IP, posizione ed esito.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (26 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Analizza i log di accesso ed evidenzia connessioni da paesi non abituali.
#>
param(
[string[]]$PaesiAttesi = @("IT"),
[int]$OreIndietro = 24,
[string]$PercorsoCSV = "C:\Report\AccessiInsoliti.csv"
)
Import-Module Microsoft.Graph.Reports
Connect-MgGraph -Scopes "AuditLog.Read.All" -NoWelcome
$dataLimite = (Get-Date).AddHours(-$OreIndietro).ToString("yyyy-MM-ddTHH:mm:ssZ")
$accessi = Get-MgAuditLogSignIn -Filter "createdDateTime ge $dataLimite and status/errorCode eq 0" -All
$risultati = $accessi | Where-Object { $_.Location.CountryOrRegion -notin $PaesiAttesi } |
Select-Object @{N="Utente";E={$_.UserPrincipalName}},
@{N="Paese";E={$_.Location.CountryOrRegion}},
@{N="Citta";E={$_.Location.City}},
@{N="IP";E={$_.IPAddress}},
@{N="Orario";E={$_.CreatedDateTime}}
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) accessi da paesi non attesi nelle ultime $OreIndietro ore." -ForegroundColor $(if($risultati.Count -gt 0){"Red"}else{"Green"})
Approfondimenti
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Microsoft 365
- Gli altri script Microsoft 365