Sommario

Introduzione

Prerequisiti

Requisiti

Componenti usati

Preparazione del programma di installazione .zip

Modifiche al dashboard Kanji

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.