Configuración de CSC con Umbrella Module para Kandji RMM (macOS)

Introducción

Este documento describe cómo configurar Cisco Secure Client (CSC) con Umbrella Module para Kandji RMM (macOS).

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Acceso a Umbrella Dashboard.
• Acceso al portal Kandji.
• Perfil de módulo Secure Client Umbrella (orginfo.json).
• Paquete de preimplementación de Secure Client para la versión que se va a implementar.

Nota: Esta guía utiliza el método de implementación .zip en Kandji, junto con un script posterior a la instalación.

Componentes Utilizados

La información de este documento se basa en el módulo Cisco Secure Client con Umbrella.

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Overview

En este artículo se describe cómo configurar Cisco Secure Client (CSC) con Umbrella Module para Kandji RMM (macOS).

Precaución: Este artículo se proporciona tal cual desde el 3 de marzo de 2025. La asistencia de Cisco Umbrella no garantiza que estas instrucciones sean válidas después de esta fecha y estén sujetas a cambios en función de las actualizaciones de Kandji.

Preparando el instalador .zip

1. Acceda a su panel de Umbrella y descargue el perfil del módulo Secure Client Umbrella (orginfo.json) navegando hasta Implementaciones > Clientes de roaming > Descargar > Descargar perfil del módulo.

34747396643092

2. También puede descargar la última versión del instalador de macOS seleccionando el paquete previo a la implementación.

34747396644884

3. Ahora puede configurar el archivo .dmg para su implementación cambiando la imagen del instalador a una versión grabable. Esto se puede hacer mediante la utilidad de disco o la aplicación Terminal con el comando:

hdiutil convert  -format UDRW -o 

4. Abra el archivo .dmg recién convertido y navegue hasta la carpeta 'Profiles'. A continuación, en la carpeta Umbrella, coloque el archivo OrgInfo.json que ha descargado del panel.

34747396647444

4.1. Para ocultar opcionalmente el módulo VPN, edite el archivo ACTransforms.xml. Actualice el elemento <DisableVPN> a true y quite las etiquetas de comentario <!— y —>

34747372903956

5. A continuación, cree un nuevo archivo llamado install_options.xml. Este archivo puede especificar qué módulos desea instalar.

Ejecute este comando para generar el archivo:

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

• Para omitir un módulo, defina el módulo con 0.
• Para instalar un módulo, defina el módulo con 1.

Este archivo debe estar ubicado en la misma carpeta que el archivo .dmg modificado. Su estructura de carpetas puede parecerse a esta captura de pantalla:

34747372904212

En este ejemplo, el archivo install_options.xml incluye los módulos Core VPN, Umbrella y DART, cada uno configurado en 1, lo que indica que están incluidos en la instalación de 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. Ahora cambia la imagen del instalador a una versión de sólo lectura utilizando la utilidad de disco o la aplicación Terminal:

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

7. El último paso en la preparación de la instalación de Umbrella es convertir la carpeta de instalación en un archivo .zip, que está listo para cargar en el panel de Kandji.

Cambios del panel kanji

1. Para macOS 13 (y versiones posteriores) y Secure Client 5.1, el agente VPN requiere la aprobación del usuario antes de ser iniciado por el SO. Para automatizar este proceso de aprobación o evitar que los usuarios deshabiliten los elementos de inicio de sesión propiedad de Secure Client, debe implementar un perfil de MDM con atributos configurados para los elementos de inicio de sesión administrados.

• Prefijo de identificador de paquete: com.cisco.secureclient
• Identificador de equipo: DE8Y96K9QP

Se pueden crear mediante la guía Kandji Configure the Login & Background Items Library Item, que utiliza el identificador de conjunto: com.cisco.secureclient.

2. Cisco Secure Client utiliza una extensión de sistema de red en macOS 11 (y versiones posteriores), agrupada en una aplicación llamada "Cisco Secure Client - Socket Filter". A continuación, debe hacer que Kandji instale esto usando los identificadores proporcionados aquí:

• Identificador de equipo: DE8Y96K9QP
• Identificador del paquete: com.cisco.anyconnect.macos.acsockext
• Tipo de extensión del sistema: ExtensiónDeRed

Estos identificadores se pueden configurar mediante la guía Kandji: Extensiones del sistema - Descripción general y guía

3. Cisco Secure Client se debe implementar como una aplicación personalizada, lo que se puede hacer mediante la guía Kandji: Implementación de aplicaciones personalizadas

Cuando llegue a la etapa Add & Configure, realice estos ajustes para la implementación:

• Elija el tipo de paquete: Elegir archivo ZIP
• Cargar instalador: Cargue el archivo .zip configurado anteriormente en el paso 7.
  • Si elige un tipo de archivo .zip, puede tener un campo adicional para definir una ubicación de descompresión. (La ubicación predeterminada es /var/tmp/)
• Script posterior a la instalación: Proporcione una secuencia de comandos que se ejecutará después de ejecutar el paquete.
  • Actualice <Filename.zip> al nombre utilizado en el paso 7 anterior.
  • Actualización <Folder Name> que se utiliza para contener el archivo .dmg y el archivo install_options.xml
  • Actualice <Output dmg file.dmg> al nombre declarado en el paso 5 anterior.

Script de ejemplo

#!/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

Si experimenta problemas de implementación relacionados con la implementación de Cisco Secure Client, puede ponerse en contacto con el equipo del TAC de Cisco.

Para problemas de implementación relacionados con el módulo Umbrella, registre un ticket de soporte con Soporte de Cisco Umbrella.