Configurazione di CSC con il modulo Umbrella per Kandji RMM (macOS)

Introduzione

Questo documento descrive come configurare Cisco Secure Client (CSC) con Umbrella Module per Kandji RMM (macOS).

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Accesso a Umbrella Dashboard.
• Accesso al portale Kandji.
• Profilo Secure Client Umbrella Module (orginfo.json).
• Pacchetto pre-distribuzione client sicuro per la versione da distribuire.

Nota: Questa guida utilizza il metodo di distribuzione .zip all'interno di Kandji, insieme a uno script post-installazione.

Componenti usati

Le informazioni di questo documento si basano su Cisco Secure Client con modulo Umbrella.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Panoramica

In questo articolo viene descritto come configurare Cisco Secure Client (CSC) con Umbrella Module per Kandji RMM (macOS).

Attenzione: Questo articolo viene fornito così com'è il 3 marzo 2025. Il supporto Cisco Umbrella non garantisce che queste istruzioni siano valide dopo questa data e siano soggette a modifiche in base agli aggiornamenti di Kandji.

Preparazione del programma di installazione .zip

1. Accedere a Umbrella Dashboard e scaricare Secure Client Umbrella Module Profile (orginfo.json) selezionando Distribuzioni > Client mobili > Scarica > Scarica profilo modulo.

34747396643092

2. È anche possibile scaricare la versione più recente del programma di installazione di macOS selezionando il Pacchetto pre-distribuzione.

34747396644884

3. È ora possibile configurare il file dmg per la distribuzione modificando l'immagine del programma di installazione in una versione scrivibile. A tale scopo, è possibile utilizzare Disk Utility o l'applicazione Terminal con il comando:

hdiutil convert  -format UDRW -o 

4. Aprire il file .dmg appena convertito e passare alla cartella 'Profili'. Quindi, nella cartella Umbrella, posizionare il file OrgInfo.json scaricato dal dashboard.

34747396647444

4.1. Per nascondere facoltativamente il modulo VPN, modificare il file ACTransforms.xml. Aggiornare l'elemento <DisableVPN> su true e rimuovere i tag di commento <!— e —>

34747372903956

5. Creare quindi un nuovo file denominato install_cuts.xml. In questo file è possibile specificare i moduli da installare.

Eseguire questo comando per generare il file:

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

• Per ignorare un modulo, definire il modulo con 0.
• Per installare un modulo, definire il modulo con 1.

Il file deve trovarsi nella stessa cartella del file dmg modificato. La struttura delle cartelle può somigliare a questa schermata:

34747372904212

In questo esempio, il file install_options.xml include i moduli Core VPN, Umbrella e DART, ciascuno impostato su 1, per indicare che sono inclusi nell'installazione 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. È ora possibile modificare l'immagine del programma di installazione in una versione di sola lettura utilizzando l'utilità disco o l'applicazione terminale:

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

7. L'ultimo passo nella preparazione dell'installazione di Umbrella è quello di convertire la cartella di installazione in un file .zip, che è pronto per il caricamento nel Kandji Dashboard.

Modifiche al dashboard Kanji

1. Per macOS 13 (e versioni successive) e Secure Client 5.1, l'agente VPN richiede l'approvazione dell'utente prima di essere avviato dal sistema operativo. Per automatizzare il processo di approvazione o impedire agli utenti di disabilitare gli elementi di login di proprietà del client protetto, è necessario distribuire un profilo MDM con attributi configurati per gli elementi di login gestiti.

• Prefisso identificatore bundle: com.cisco.secureclient
• Identificatore team: DE8Y96K9QP

È possibile creare tali elementi utilizzando la guida Kandji Configure the Login & Background Items Library Item, che utilizza l'identificatore di bundle: com.cisco.secureclient

2. Cisco Secure Client utilizza un'estensione del sistema di rete su macOS 11 (e versioni successive), fornita in bundle in un'applicazione chiamata "Cisco Secure Client - Socket Filter". Successivamente, è necessario che Kandji installi questo utilizzando gli identificatori forniti qui:

• Identificatore team: DE8Y96K9QP
• Identificatore pacchetto: com.cisco.anyconnect.macos.acsockext
• Tipo di estensione di sistema: EstensioneRete

Questi identificatori possono essere impostati usando la guida Kandji: Estensioni di sistema - Panoramica e guida

3. Cisco Secure Client deve essere distribuito come app personalizzata, utilizzando la guida Kandji: Distribuzione di app personalizzate

Quando si raggiunge la fase Aggiungi e configura, apportare le seguenti modifiche per la distribuzione:

• Scegliere il tipo di pacchetto: Scegli file ZIP
• Carica programma di installazione: Caricare il file .zip configurato in precedenza nel passaggio 7.
  • Se si sceglie un tipo di file zip, è possibile disporre di un campo aggiuntivo per definire una posizione di decompressione. (Il percorso predefinito è /var/tmp/)
• Script di post-installazione: Fornire uno script da eseguire dopo l'esecuzione del pacchetto.
  • Aggiornare <Filename.zip> al nome utilizzato nel passaggio 7 precedente.
  • Aggiornamento <Nome cartella> utilizzato per contenere il file con estensione dmg e il file install_options.xml
  • Aggiornare <Output dmg file.dmg> al nome dichiarato nel passaggio 5 precedente.

Script di esempio

#!/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 si verificano problemi di distribuzione relativi alla distribuzione di Cisco Secure Client, è possibile contattare il team Cisco TAC.

Per i problemi di installazione relativi al modulo Umbrella, registrare un ticket di supporto con il supporto Cisco Umbrella.