Inhoud

Inleiding

Voorwaarden

Vereisten

Gebruikte componenten

Uw .zip-installatieprogramma voorbereiden

Wijzigingen in het Kanji-dashboard

Inleiding

In dit document wordt beschreven hoe u Cisco Secure Client (CSC) configureert met Umbrella Module voor Kandji RMM (macOS).

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

- Toegang tot het Umbrella Dashboard.

- Toegang tot het Kandji Portal.

- Beveiligde client paraplu module profiel (orginfo.json).

- Secure Client Pre-implementatiepakket voor de te implementeren versie.

Opmerking: Deze handleiding maakt gebruik van de .zip-implementatiemethode binnen Kandji, samen met een post-installatiescript.

Gebruikte componenten

De informatie in dit document is gebaseerd op de Cisco Secure Client with Umbrella-module.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Overzicht

In dit artikel wordt beschreven hoe u Cisco Secure Client (CSC) configureert met Umbrella Module voor Kandji RMM (macOS).

Let op: Dit artikel is beschikbaar vanaf 3 maart 2025. Cisco Umbrella Support garandeert niet dat deze instructies na deze datum geldig zijn en kunnen worden gewijzigd op basis van updates van Kandji.

Uw .zip-installatieprogramma voorbereiden

1. Ga naar het overkoepelende dashboard en download het profiel van de beveiligde overkoepelende clientmodule (orginfo.json) door te navigeren naar Implementaties > Zwervende clients > Downloaden > Module-profiel downloaden.

34747396643092

2. U kunt ook de nieuwste versie van het macOS-installatieprogramma downloaden door het Pre-Deployment Package te selecteren.

34747396644884

3. U kunt het .dmg-bestand nu configureren voor implementatie door het installatiekopie te wijzigen in een beschrijfbare versie. Dit kan worden gedaan met behulp van Disk Utility of de Terminal-toepassing met de opdracht:

hdiutil convert  -format UDRW -o

4. Open het nieuw geconverteerde .dmg bestand en navigeer naar de map 'Profielen'. Plaats vervolgens in de map Umbrella het bestand OrgInfo.json dat u van uw dashboard hebt gedownload.

34747396647444

4.1. Bewerk het bestand ACTtransforms.xml om de VPN-module optioneel te verbergen. Werk het <DisableVPN> element bij naar true en verwijder de commentaartags <!- en ->

34747372903956

5. Maak vervolgens een nieuw bestand met de naam install_choices.xml. In dit bestand kunt u opgeven welke modules u wilt installeren.

Voer deze opdracht uit om het bestand te genereren:

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

- Als u een module wilt overslaan, definieert u de module met 0.

- Als u een module wilt installeren, definieert u de module met 1.

Dit bestand moet zich in dezelfde map bevinden als het gewijzigde .dmg-bestand. De mapstructuur kan lijken op deze screenshot:

34747372904212

In dit voorbeeld bevat het bestand install_choices.xml de Core VPN-, Umbrella- en DART-modules, elk ingesteld op 1, wat aangeeft dat ze zijn opgenomen in de installatie van de beveiligde 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. U wijzigt het installatiekopie nu in een alleen-lezen versie met behulp van het hulpprogramma Schijf of de toepassing Terminal:

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

7. De laatste stap bij het voorbereiden van de paraplu-installatie is het converteren van de installatiemap naar een .zip-bestand, dat klaar is om te uploaden naar het Kandji Dashboard.

Wijzigingen in het Kanji-dashboard

1. Voor macOS 13 (en hoger) en Secure Client 5.1 vereist de VPN Agent de goedkeuring van de gebruiker voordat het besturingssysteem het programma start. Als u dit goedkeuringsproces wilt automatiseren of wilt voorkomen dat gebruikers de aanmeldingsitems van de beveiligde client uitschakelen, moet u een MDM-profiel implementeren met kenmerken die zijn geconfigureerd voor beheerde aanmeldingsitems.

- Bundle Identifier Prefix: com.cisco.secureclient

- Team-ID: DE8Y96K9QP

Deze kunnen worden gemaakt met behulp van de Kandji-handleiding Configureer het bibliotheekitem Login & Background Items, dat de bundelidentificator gebruikt: com.cisco.secureclient.

2. De Cisco Secure Client gebruikt een netwerksysteemextensie op macOS 11 (en hoger), gebundeld in een toepassing met de naam "Cisco Secure Client - Socket Filter." Vervolgens moet u Kandji dit laten installeren met behulp van de hier verstrekte identificatoren:

- Team-ID: DE8Y96K9QP

- Bundle Identifier: com.cisco.anyconnect.macos.acsockext

- Systeemuitbreidingstype: NetworkExtension

Deze id's kunnen worden ingesteld met behulp van de Kandji-gids: Systeemextensies - Overzicht en gids

3. De Cisco Secure Client moet worden geïmplementeerd als een aangepaste app, wat kan worden gedaan met behulp van de Kandji-gids: aangepaste apps implementeren

Wanneer u de fase Toevoegen en configureren bereikt, voert u de volgende aanpassingen uit voor implementatie:

- Pakkettype kiezen: ZIP-bestand kiezen

- Upload Installer: Upload het .zip-bestand dat eerder in stap 7 is geconfigureerd.

- Als u een .zip-bestandstype kiest, kunt u een extra veld gebruiken om een unzip-locatie te definiëren. (Standaardlocatie is /var/tmp/)

- Post-Install Script: Geef een script op dat moet worden uitgevoerd nadat het pakket is uitgevoerd.

- Werk <bestandsnaam.zip> bij naar de naam die eerder in stap 7 is gebruikt.

- Update <Naam map> die wordt gebruikt om het .dmg-bestand en het bestand install_choices.xml te bevatten

- Werk <Output dmg file.dmg> bij naar de naam die in stap 5 eerder is gedeclareerd.

Voorbeeldscript

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

Als u problemen ondervindt bij de implementatie van de Cisco Secure Client, kunt u contact opnemen met het Cisco TAC-team.

Voor implementatieproblemen met betrekking tot de overkoepelende module moet u een supportticket aanmelden bij Cisco Umbrella Support.