Usa reti dinamiche e PowerShell in Umbrella

Introduzione

In questo documento viene descritto come aggiornare l'indirizzo IP utilizzando PowerShell per le reti dinamiche in Cisco Umbrella.

Prerequisiti

Requisiti

Nessun requisito specifico previsto per questo documento.

Componenti usati

Le informazioni fornite in questo documento si basano su Cisco Umbrella.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Panoramica

Il presente articolo ha lo scopo di fornire una panoramica generale. Qui è disponibile un elenco delle opzioni supportate per l'aggiornamento di Umbrella con l'IP dinamico.

È possibile utilizzare qualsiasi metodo basato su script per aggiornare l'indirizzo IP utilizzando l'API.  In questo articolo viene illustrato come utilizzare PowerShell.

Prima di iniziare questo processo:

• Configurare il dashboard come descritto di seguito.
• Prendere nota del nome della rete dinamica in Umbrella Dashboard in Distribuzioni > Reti.

Utilizzare PowerShell per aggiornare l'IP dinamico (IP hardcoded)

1. Determinare l'indirizzo IP esterno corrente per la rete. Questa operazione deve essere eseguita da un computer della rete.  

$MyIp = Resolve-DnsName myip.opendns.com | Select -ExpandProperty IPAddress

2. Ottenere le credenziali. Si noti che questi utenti devono disporre di diritti amministrativi completi per il dashboard.

$MyCredential = Get-Credential

Verrà aperto un popup.

3. Inserisci l'indirizzo e-mail e la password. È quindi possibile utilizzare queste credenziali per inviare un aggiornamento utilizzando questo comando:

Invoke-RestMethod -Uri "https://updates.opendns.com/nic/update?hostname=biscuit&myip=$MyIP" -Credential $MyCredential

Metodo per consentire lo scripting dell'aggiornamento su IP dinamico

Questo metodo richiede la prearchiviazione delle credenziali per l'utilizzo automatico.

Attenzione: Questo metodo NON è sicuro e viene fornito solo come esempio. Questa funzionalità è stata testata solo in PowerShell 5.1.

1. Generare innanzitutto un file offuscato contenente la password. Questa operazione deve essere eseguita una sola volta. Immettere l'indirizzo di posta elettronica e la password di qualsiasi utente amministratore completo del dashboard.

(Get-Credential).Password | ConvertFrom-SecureString | Out-File "C:\MyPassword.txt"

2. È quindi possibile utilizzare questo file in uno script completo:

$UmbrellaNetwork = "your network name"
$User = "your admin email address"
$MyIp = Resolve-DnsName myip.opendns.com | Select -ExpandProperty IPAddress
$File = "C:\MyPassword.txt"
$MyCredential=New-Object -TypeName System.Management.Automation.PSCredential ` -ArgumentList $User, (Get-Content $File | ConvertTo-SecureString)
Invoke-RestMethod -Uri "https://updates.opendns.com/nic/update?hostname=$UmbrellaNetwork&myip=$MyIp" -Credential $MyCredential