Inhalt

Einleitung

Voraussetzungen

Anforderungen

Verwendete Komponenten

Vorbereiten des .zip-Installationsprogramms

Änderungen am Kanji-Dashboard

Einleitung

In diesem Dokument wird die Konfiguration des Cisco Secure Client (CSC) mit Umbrella Module für Kandji RMM (macOS) beschrieben.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

- Zugriff auf das Umbrella Dashboard

- Zugang zum Kandji Portal.

- Secure Client Umbrella Module Profile (orginfo.json).

- Secure Client-Vorabbereitstellungspaket für die bereitzustellende Version.

Anmerkung: In diesem Handbuch wird die .zip-Bereitstellungsmethode in Kandji zusammen mit einem Skript nach der Installation verwendet.

Verwendete Komponenten

Die Informationen in diesem Dokument basieren auf Cisco Secure Client mit Umbrella-Modul.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Überblick

In diesem Artikel wird die Konfiguration des Cisco Secure Client (CSC) mit Umbrella Module für Kandji RMM (macOS) beschrieben.

Vorsicht: Dieser Artikel wird ab dem 3. März 2025 ohne Mängelgewähr bereitgestellt. Der Cisco Umbrella-Support garantiert nicht, dass diese Anweisungen nach diesem Datum gültig sind und sich aufgrund von Updates von Kandji ändern können.

Vorbereiten des .zip-Installationsprogramms

1. Rufen Sie Ihr Umbrella Dashboard auf, und laden Sie das Secure Client Umbrella Module Profile (orginfo.json) herunter, indem Sie zu Deployments > Roaming Clients > Download > Download Module Profile navigieren.

34747396643092

2. Sie können auch die neueste Version des macOS-Installers herunterladen, indem Sie das Pre-Deployment Package auswählen.

34747396644884

3. Sie können jetzt die .dmg-Datei für die Bereitstellung konfigurieren, indem Sie das Installationsprogramm-Image in eine beschreibbare Version ändern. Dies kann mithilfe des Festplattendienstprogramms oder der Terminalanwendung mithilfe des folgenden Befehls durchgeführt werden:

hdiutil convert  -format UDRW -o

4. Öffnen Sie die neu konvertierte .dmg-Datei und navigieren Sie zum Ordner 'Profiles'. Platzieren Sie dann die von Ihrem Dashboard heruntergeladene Datei OrgInfo.json im Umbrella-Ordner.

34747396647444

4.1. Bearbeiten Sie die Datei ACTransforms.xml, um das VPN-Modul optional auszublenden. Aktualisieren Sie das <DisableVPN>-Element auf true, und entfernen Sie die Kommentar-Tags <!— und —>

34747372903956

5. Als Nächstes erstellen Sie eine neue Datei mit dem Namen install_choice.xml. Diese Datei kann angeben, welche Module installiert werden sollen.

Führen Sie den folgenden Befehl aus, um die Datei zu generieren:

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

- Um ein Modul zu überspringen, definieren Sie es mit 0.

- Um ein Modul zu installieren, definieren Sie das Modul mit 1.

Diese Datei muss sich im selben Ordner wie die geänderte Dmg-Datei befinden. Ihre Ordnerstruktur kann diesem Screenshot ähneln:

34747372904212

In diesem Beispiel enthält die Datei install_choice.xml die Core-VPN-, Umbrella- und DART-Module, die jeweils auf 1 festgelegt sind und angeben, dass sie in der Secure Client-Installation enthalten sind:

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. Sie ändern das Installationsprogramm jetzt in eine schreibgeschützte Version, entweder mit dem Festplattendienstprogramm oder der Terminalanwendung:

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

7. Der letzte Schritt bei der Vorbereitung der Umbrella-Installation besteht darin, den Installationsordner in eine ZIP-Datei zu konvertieren, die in das Kandji Dashboard hochgeladen werden kann.

Änderungen am Kanji-Dashboard

1. Für macOS 13 (und höher) und Secure Client 5.1 benötigt der VPN Agent eine Benutzergenehmigung, bevor er vom Betriebssystem gestartet wird. Um diesen Genehmigungsprozess zu automatisieren oder zu verhindern, dass Benutzer die Anmeldeelemente des sicheren Clients deaktivieren, müssen Sie ein MDM-Profil mit Attributen bereitstellen, die für verwaltete Anmeldeelemente konfiguriert sind.

- Paket-ID-Präfix: com.cisco.secureclient

- Team-ID: DE8Y96K9QP

Diese können mithilfe des Kandji-Leitfadens Konfigurieren des Bibliothekselements für Anmelde- und Hintergrundelemente erstellt werden, der den Paket-Bezeichner verwendet: com.cisco.secureclient.

2. Der Cisco Secure Client verwendet eine Netzwerksystemerweiterung auf macOS 11 (oder höher), gebündelt in einer Anwendung namens "Cisco Secure Client - Socket Filter". Als Nächstes müssen Sie Kandji diese mit den hier angegebenen Bezeichnern installieren lassen:

- Team-ID: DE8Y96K9QP

- Paket-ID: com.cisco.anyconnect.macos.acsockext

- Systemerweiterungstyp: Netzwerkanschluss

Diese Kennungen können mithilfe des Kandji-Handbuchs eingerichtet werden: Systemerweiterungen - Übersicht und Leitfaden

3. Der Cisco Secure Client muss als benutzerdefinierte Anwendung bereitgestellt werden. Dies kann mithilfe des Kandji-Leitfadens erfolgen: Bereitstellen benutzerdefinierter Anwendungen

Nehmen Sie bei Erreichen der Phase "Hinzufügen und Konfigurieren" die folgenden Anpassungen für die Bereitstellung vor:

- Pakettyp auswählen: ZIP-Datei auswählen

- Installationsprogramm hochladen: Laden Sie die zuvor in Schritt 7 konfigurierte ZIP-Datei hoch.

- Wenn Sie einen ZIP-Dateityp auswählen, können Sie ein zusätzliches Feld zum Definieren eines Entpackspeicherorts verwenden. (Der Standardspeicherort ist /var/tmp/)

- Skript nach der Installation: Geben Sie ein Skript an, das nach der Ausführung des Pakets ausgeführt werden soll.

- <Filename.zip> auf den Namen in Schritt 7 aktualisieren.

- <Ordnername> aktualisieren, das die .dmg-Datei und die Datei install_choice.xml enthält

- Aktualisieren Sie <Output dmg file.dmg> auf den in Schritt 5 zuvor deklarierten Namen.

Beispielskript

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

Wenn bei der Bereitstellung des Cisco Secure Client Probleme auftreten, können Sie sich an das Cisco TAC-Team wenden.

Bei Bereitstellungsproblemen im Zusammenhang mit dem Umbrella-Modul reichen Sie bitte ein Support-Ticket beim Cisco Umbrella Support ein.