Usar redes dinâmicas e PowerShell no Umbrella

Introdução

Este documento descreve como atualizar seu endereço IP usando o PowerShell para redes dinâmicas no Cisco Umbrella.

Pré-requisitos

Requisitos

Não existem requisitos específicos para este documento.

Componentes Utilizados

As informações neste documento são baseadas no Cisco Umbrella.

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Overview

O objetivo deste artigo é servir como uma visão geral. Uma lista de opções suportadas para atualizar o Umbrella com seu IP dinâmico está disponível aqui.

Você pode usar qualquer método com script para atualizar seu endereço IP usando a API.  Este artigo demonstra como o PowerShell pode ser usado.

Antes de iniciar este processo:

• Configure seu painel conforme detalhado aqui.
• Anote o nome da sua rede dinâmica no Umbrella Dashboard em Implantações > Redes.

Use o PowerShell para atualizar o IP dinâmico (IP codificado)

1. Determine o endereço IP externo atual para esta rede. Isso deve ser feito de uma máquina nesta rede.  

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

2. Obtenha as credenciais. Observe que eles devem ter direitos de administrador completos em seu Painel.

$MyCredential = Get-Credential

Isso abre um pop-up.

3. Digite seu endereço de e-mail e senha. Você pode usar essas credenciais para postar uma atualização usando este comando:

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

Método para permitir script de atualização para IP dinâmico

Este método requer o pré-armazenamento das credenciais para uso autônomo.

Caution: Este método NÃO é seguro e é fornecido apenas como exemplo. Isso foi testado somente no PowerShell 5.1.

1. Primeiro, gere um arquivo ofuscado contendo a senha. Isso só precisa ser executado uma vez. Insira o endereço de e-mail e a senha de qualquer usuário administrador completo do painel.

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

2. Você poderá então usar este arquivo em um 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