Entender a instalação da linha de comando e a referência de RMM para o módulo Umbrella

Introdução

Este documento descreve a instalação da linha de comando e a referência RMM no módulo Cisco Secure Client Umbrella.

Propósito

Este artigo serve de guia para qualquer pessoa que queira automatizar a instalação do módulo Umbrella para o Cisco Secure Client. Ele fornece o contexto e os comandos que podem ser usados para criar seus próprios scripts para automatizar a implantação do Cisco Secure Client.

Upgrades e migração

Para clientes que estão migrando de um Cisco AnyConnect ou Umbrella Roaming Client mais antigo, não é obrigatório remover o software antigo antes da atualização. O software Umbrella antigo é detectado e removido automaticamente durante a instalação.

É essencial garantir que todas as tarefas de instalação automatizada do AnyConnect ou do Umbrella Roaming Client sejam desabilitadas para impedir a reinstalação do software mais antigo.

Componentes e abordagem

Se você estiver instalando a partir da GUI ou de qualquer outro método, uma instalação bem-sucedida exigirá:

• Instalação do Cisco Secure Client 
• Instalação do módulo Umbrella
• Perfil Umbrella (OrgInfo.plist no Mac e OrgInfo.json no Windows)
• Instalação da ferramenta de diagnóstico DART (recomendada)

A Cisco fornece documentação precisa sobre como criar os comandos para instalar isso. Para obter a documentação completa sobre isso, consulte o guia de pré-implantação abaixo:

Pré-implantaçãoCisco Secure ClientModules como aplicativos autônomos

Instalação do perfil

Uma consideração importante ao implantar o Umbrella é a instalação do seu perfil exclusivo da empresa (OrgInfo.json).  Esse perfil identifica exclusivamente sua empresa Umbrella e permite que o cliente se registre na nuvem Umbrella.  Você pode fazer o download em seu painel navegando até Implantações > Identidades principais > Computadores móveis > Cliente de roaming e clicando em Download no canto superior direito e selecionando Download Module Profile.

Esta etapa é obrigatória para que o módulo Umbrella funcione.

• Perfil do pacote - O perfil (OrgInfo.json) é incluído no pacote de instalação antes da instalação.  Consulte Tutorial de pré-implantação (Windows) e tutorial de pré-implantação (OSX) para obter exemplos.
• Copiar perfil - O perfil (OrgInfo.json) é copiado para um local no ponto final após a instalação

Se você optar por copiar o perfil para o endpoint, ele deverá ser implantado nestes locais de forma programática:

  C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\OrgInfo.json (Windows)  /opt/cisco/secureclient/umbrella/OrgInfo.json (OSX)

Exemplos de linha de comando - Windows

Esses comandos demonstram como implantar os módulos Secure Client, Umbrella e DART no Windows por meio da linha de comando ou software de automação.

• Substitua <version> pelo número da versão do arquivo MSI baixado
• Substitua <log_file_name> pelo caminho e nome do arquivo de log.

msiexec /package cisco-secure-client-win-<version>-core-vpn-predeploy-k9.msi /norestart /passive PRE_DEPLOY_DISABLE_VPN=1 /lvx* 

msiexec /package cisco-secure-client-win-<version>-umbrella-predeploy-k9.msi /norestart /passive /lvx* 

msiexec /package cisco-secure-client-win-<version>-dart-predeploy-k9.msi /norestart /passive /lvx* 

Esses comandos desabilitam totalmente a funcionalidade do Secure Client VPN usando o switch PRE_DEPLOY_DISABLE_VPN=1 - que é uma configuração comum.  Observe que o módulo VPN principal ainda deve estar instalado, mas a própria VPN está totalmente desativada.

Note: Para que o módulo Umbrella funcione, você deve ter implantado o arquivo OrgInfo.json antes ou depois da instalação, conforme descrito em 'Instalação de Perfil'.

Argumentos Opcionais

Há vários switches opcionais que podem ser usados durante a instalação do Cisco Secure Client e do Umbrella Module. Aqui estão alguns dos mais úteis:

instalações de macOS

Para obter mais informações sobre instalação e personalização no macOS, consulte esta página: 

Linha de comando e personalização

Estrutura do diretório

Os locais do diretório foram alterados com o Cisco Secure Client.

Diretórios do Cisco Secure Client

Windows

Executável

C:\Program Files (x86)\Cisco\Cisco Secure Client

Diretório Umbrella

C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\

MacOS

Executável

/Applications/Cisco/Cisco Secure Client.app

Diretório Umbrella

/opt/cisco/secureclient/Umbrella/

Para obter referências de implantação para alguns produtos RMM populares, consulte https://docs.umbrella.com/deployment-umbrella/docs/additional-references.