Configurar CSC com módulo Umbrella para Kandji RMM (macOS)

Introdução

Este documento descreve como configurar o Cisco Secure Client (CSC) com o Umbrella Module for Kandji RMM (macOS).

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Acesso ao Painel do Umbrella.
• Acesso ao Portal Kandji.
• Perfil do módulo Secure Client Umbrella (orginfo.json).
• Pacote de Pré-implantação de Cliente Seguro para a versão a ser implantada.

Note: Este guia utiliza o método de distribuição .zip dentro do Kandji, juntamente com um script pós-instalação.

Componentes Utilizados

As informações neste documento são baseadas no Cisco Secure Client com módulo 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

Este artigo descreve como configurar o Cisco Secure Client (CSC) com o Umbrella Module for Kandji RMM (macOS).

Caution: Este artigo é fornecido como está a partir de 3 de março de 2025. O suporte do Cisco Umbrella não garante que essas instruções sejam válidas após esta data e estejam sujeitas a alterações com base nas atualizações do Kandji.

Preparando o instalador do .zip

1. Acesse o Umbrella Dashboard e baixe o Secure Client Umbrella Module Profile (orginfo.json) navegando até Implantações > Clientes de Roaming > Download > Download Module Profile.

34747396643092

2. Você também pode baixar a versão mais recente do instalador do macOS selecionando o Pacote de Pré-Implantação.

34747396644884

3. Agora você pode configurar o arquivo .dmg para implantação alterando a imagem do instalador para uma versão gravável. Isso pode ser feito usando o Utilitário de Disco ou o aplicativo Terminal com o comando:

hdiutil convert  -format UDRW -o 

4. Abra o arquivo .dmg recém-convertido e navegue até a pasta 'Perfis'. Em seguida, na pasta Umbrella, coloque o arquivo OrgInfo.json baixado do seu painel.

34747396647444

4.1. Para ocultar opcionalmente o módulo VPN, edite o arquivo ACTransforms.xml. Atualize o elemento <DisableVPN> para true e remova as marcas de comentário <!— e —>

34747372903956

5. Em seguida, crie um novo arquivo chamado install_options.xml. Esse arquivo pode especificar quais módulos você deseja instalar.

Execute este comando para gerar o arquivo:

installer -pkg /volumes/Cisco\ Secure\ Client\ /Cisco\ Secure\ Client.pkg -showChoiceChangesXML > ~/Downloads/install_choices.xml 

• Para ignorar um módulo, defina o módulo com 0.
• Para instalar um módulo, defina o módulo com 1.

Esse arquivo precisa estar localizado na mesma pasta que o arquivo .dmg modificado. Sua estrutura de pastas pode se parecer com esta captura de tela:

34747372904212

Neste exemplo, o arquivo install_options.xml inclui os módulos Core VPN, Umbrella e DART, cada um definido como 1, indicando que eles estão incluídos na instalação do Secure Client:

attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_anyconnect_vpn


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_anyconnect_vpn


attributeSetting
1
choiceAttribute
selected
choiceIdentifier
choice_anyconnect_vpn


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_fireamp


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_fireamp


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_fireamp


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_dart


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_dart


attributeSetting
1
choiceAttribute
selected
choiceIdentifier
choice_dart


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_secure_firewall_posture


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_secure_firewall_posture


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_secure_firewall_posture


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_iseposture


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_iseposture


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_iseposture


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_nvm


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_nvm


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_nvm


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_secure_umbrella


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_secure_umbrella


attributeSetting
1
choiceAttribute
selected
choiceIdentifier
choice_secure_umbrella


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_thousandeyes


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_thousandeyes


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_thousandeyes


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_duo


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_duo


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_duo


attributeSetting

choiceAttribute
visible
choiceIdentifier
choice_zta


attributeSetting

choiceAttribute
enabled
choiceIdentifier
choice_zta


attributeSetting
0
choiceAttribute
selected
choiceIdentifier
choice_zta

6. Agora você pode alterar a imagem do instalador para uma versão somente leitura usando o Utilitário de Disco ou o aplicativo Terminal:

hdiutil convert <source dmg> -format UDRO -o <output dmg>

7. A etapa final na preparação da instalação do Umbrella é converter a pasta de instalação em um arquivo .zip, que está pronto para ser carregado no Painel Kandji.

Alterações no Painel Kanji

1. Para o macOS 13 (e mais recente) e o Secure Client 5.1, o Agente VPN requer aprovação do usuário antes de ser iniciado pelo SO. Para automatizar esse processo de aprovação ou impedir que os usuários desabilitem os Itens de Logon de propriedade do Cliente Seguro, você deve implantar um perfil MDM com atributos configurados para Itens de Logon Gerenciados.

• Prefixo do identificador de pacote: com.cisco.secureclient
• Identificador da Equipe: DE8Y96K9QP

Eles podem ser criados usando o guia Kandji Configure the Login & Background Items Library Item, que usa o identificador do pacote: com.cisco.secureclient.

2. O Cisco Secure Client usa uma extensão de sistema de rede no macOS 11 (e posterior), agrupada em uma aplicação chamada "Cisco Secure Client - Filtro de Soquete". Em seguida, você precisa que o Kandji instale isto usando os identificadores fornecidos aqui:

• Identificador da Equipe: DE8Y96K9QP
• Identificador do pacote: com.cisco.anyconnect.macos.acsockext
• Tipo de Extensão do Sistema: Extensão deRede

Estes identificadores podem ser configurados usando o guia Kandji: Extensões do sistema - Visão geral e guia

3. O Cisco Secure Client deve ser implantado como um aplicativo personalizado, o que pode ser feito usando o guia Kandji: Implantação de aplicativos personalizados

Quando você chegar ao estágio Add & Configure, faça estes ajustes para a implantação:

• Escolher tipo de pacote: Escolher arquivo ZIP
• Carregar instalador: Carregue o arquivo .zip configurado anteriormente na etapa 7.
  • Se você escolher um tipo de arquivo .zip, poderá ter um campo adicional para definir um local de descompactação. (O local padrão é /var/tmp/)
• Script de pós-instalação: Forneça um script a ser executado após a execução do pacote.
  • Atualize <Filename.zip> para o nome usado na etapa 7 anterior.
  • Atualize o <Nome da pasta> usado para conter o arquivo .dmg e o arquivo install_choice.xml
  • Atualize <Output dmg file.dmg> para o nome declarado na etapa 5 anterior.

Exemplo de script

#!/bin/bash

# Optional extract the ZIP file. (Kandji extracts to /var/tmp by default)
#unzip "/var/tmp/Cisco Secure Client 5-1-7-80.zip" -d /var/tmp/

# Mount the DMG.
hdiutil attach "/var/tmp/<Folder Name>/<Output dmg file.dmg>"

# Run the installer with our xml choices file.
installer -pkg "/Volumes/Cisco Secure Client 5.1.7.80/Cisco Secure Client.pkg" -applyChoiceChangesXML "/var/tmp/<Folder Name>/install_choices.xml" -target /

# Check installer exit code.
if [ $? -ne 0 ]; then
echo "Error: Installation failed."
# Add any necessary cleanup or rollback actions here
exit 1
fi

# Unmount the DMG.
hdiutil detach "Cisco Secure Client 5.1.7.80"

# Remove the temp files & folders.
rm -rf /var/tmp/<Folder Name>
rm -f /var/tmp/<Filename.zip>

exit 0

Se você tiver problemas de implantação relacionados à implantação do Cisco Secure Client, entre em contato com a equipe do Cisco TAC.

Para problemas de implantação relacionados ao Módulo Umbrella, registre um tíquete de suporte no Cisco Umbrella Support.