Contents

Introdução

Propósito

Upgrades e migração

Componentes e abordagem

Instalação do perfil

Exemplos de linha de comando - Windows

Argumentos Opcionais

instalações de macOS

Estrutura do diretório

Diretórios do Cisco Secure Client

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:

Instalador

Argumento Opcional

Propósito

cisco-secure-client-win-<version>-core-vpn-predeploy-k9.msi

PRE_DEPLOY_DISABLE_VPN=1

O módulo principal inclui o recurso de VPN, mesmo que não seja usado. Isso instrui o sistema a ocultar o módulo VPN inativo. Isso também pode ser feito após a instalação usando as etapas listadas aqui.

cisco-secure-client-win-<version>-umbrella-predeploy-k9.msi

LOCKDOWN=1

Isso evita que o serviço Umbrella seja desabilitado manualmente. Mais informações podem ser encontradas aqui.

Qualquer módulo

ARPSYSTEMCOMPONENT=1

Isso impede que o módulo seja exibido na caixa de diálogo Adicionar ou remover programas.

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.