المحتويات

المقدمة

المتطلبات الأساسية

المتطلبات

المكونات المستخدمة

إعداد مثبت .zip الخاص بك

تغييرات لوحة معلومات Kanji

المقدمة

يصف هذا وثيقة كيف أن يشكل cisco يأمن زبون (CSC) مع مظلة وحدة نمطية ل Kandji RMM (MacOS).

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

- الوصول إلى لوحة معلومات المظلة.

- الوصول إلى بوابة كاندجي.

- ملف تعريف وحدة Secure Client Umbrella النمطية (orgInfo.json).

- حزمة النشر المسبق لعميل آمن للإصدار المراد نشره.

ملاحظة: يستخدم هذا الدليل طريقة نشر .zip داخل Kandji، بالإضافة إلى برنامج نصي لمادة ما بعد التثبيت.

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى Cisco Secure Client مع وحدة Umbrella النمطية.

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

نظرة عامة

يصف هذا المقال كيفية تكوين Cisco Secure Client (CSC) مع وحدة Umbrella Module ل Kandji RMM (MacOS).

تحذير: تم تقديم هذه المادة في 3 مارس 2025. لا يضمن دعم Cisco Umbrella صحة هذه التعليمات بعد هذا التاريخ وهي عرضة للتغيير استنادا إلى التحديثات من Kandji.

إعداد مثبت .zip الخاص بك

1. يمكنك الوصول إلى لوحة معلومات المظلة الخاصة بك وتنزيل ملف تعريف وحدة المظلة الخاصة بالعميل الآمن (orgInfo.json) من خلال الانتقال إلى عمليات النشر > عملاء التجوال > تنزيل > تنزيل ملف تعريف وحدة التنزيل النمطية.

34747396643092

2. يمكنك أيضا تنزيل أحدث إصدار من مثبت MacOS من خلال تحديد حزمة ما قبل النشر.

34747396644884

3. يمكنك الآن تكوين ملف .dmg للنشر من خلال تغيير صورة المثبت إلى إصدار قابل للكتابة. يمكن القيام بذلك باستخدام الأداة المساعدة للقرص أو التطبيق الطرفي باستخدام الأمر:

hdiutil convert  -format UDRW -o

4. افتح ملف .dmg الذي تم تحويله حديثا وانتقل إلى مجلد 'ملفات التعريف'. ثم، في مجلد Umbrella، ضع ملف OrgInfo.json الذي قمت بتنزيله من لوحة المعلومات.

34747396647444

4.1. لإخفاء الوحدة النمطية للشبكة الخاصة الظاهرية (VPN) إختياريا، قم بتحرير ملف ACTransforms.xml. قم بتحديث عنصر <disableVPN> إلى true وإزالة علامات التمييز على التعليق <!— و—>

34747372903956

5. بعد ذلك، قم بإنشاء ملف جديد باسم install_options.xml. يمكن لهذا الملف تحديد الوحدات النمطية التي تريد تثبيتها.

قم بتشغيل هذا الأمر لإنشاء الملف:

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

- لتخطي وحدة نمطية، قم بتعريف الوحدة النمطية التي تحتوي على 0.

- لتثبيت وحدة نمطية، قم بتعريف الوحدة النمطية باستخدام 1.

يجب أن يكون هذا الملف موجودا في نفس المجلد الخاص بملف .dmg المعدل. يمكن أن يشبه هيكل المجلد لقطة الشاشة هذه:

34747372904212

في هذا المثال، يتضمن ملف install_options.xml الوحدات النمطية VPN و Umbrella و DART الأساسية، حيث يتم تعيين كل منها على 1، مما يشير إلى أنها مضمنة في تثبيت العميل الآمن:

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. يمكنك الآن تغيير صورة أداة التثبيت إلى إصدار للقراءة فقط باستخدام الأداة المساعدة للقرص أو التطبيق الطرفي:

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

7. تتمثل الخطوة الأخيرة في إعداد تثبيت Umbrella في تحويل مجلد التثبيت إلى ملف .zip، جاهز للتحميل إلى لوحة معلومات Kandji.

تغييرات لوحة معلومات Kanji

1. في حالة نظام التشغيل MacOS 13 (والإصدارات الأحدث) والعميل الآمن 5.1، يتطلب وكيل الشبكة الخاصة الظاهرية (VPN) موافقة المستخدم قبل أن يتم تشغيله بواسطة نظام التشغيل. لأتمتة عملية الاعتماد هذه أو منع المستخدمين من تعطيل عناصر تسجيل الدخول التي يمتلكها العميل الآمن، يجب نشر ملف تعريف MDM بسمات تم تكوينها لعناصر تسجيل الدخول المدارة.

- بادئة معرف الحزمة: com.cisco.secure

- معرف الفريق: DE8Y96K9QP

يمكن إنشاء ذلك باستخدام دليل كاندجي تكوين عنصر مكتبة عناصر تسجيل الدخول والخلفية، والذي يستخدم معرف الحزمة: com.cisco.secure.

2. يستخدم Cisco Secure Client ملحق نظام شبكة على MacOS 11 (والإصدارات الأحدث)، مضمن في تطبيق باسم "عامل تصفية مأخذ التوصيل - عميل آمن من Cisco". بعد ذلك، تحتاج إلى أن تقوم Kandji بتثبيت هذا باستخدام المعرفات المتوفرة هنا:

- معرف الفريق: DE8Y96K9QP

- معرف الحزمة: com.cisco.anyconnect.macos.acsockext

- نوع ملحق النظام: NetworkExtension

يمكن إعداد هذه المعرفات باستخدام دليل كاندجي: ملحقات النظام - لمحة عامة ودليل

3. يجب نشر Cisco Secure Client كتطبيق مخصص، والذي يمكن القيام به باستخدام دليل Kandji: نشر التطبيقات المخصصة

عند الوصول إلى مرحلة الإضافة والتكوين، قم بإجراء التعديلات التالية للنشر:

- أختر نوع الحزمة: أختر ملف ZIP

- مثبت التحميل: قم بتحميل ملف .zip الذي تم تكوينه مسبقا في الخطوة 7.

- إذا أخترت نوع ملف .zip، يمكنك أن يكون لديك حقل إضافي لتعريف موقع فك الضغط. (الموقع الافتراضي هو /var/tmp/)

- البرنامج النصي لما بعد التثبيت: قم بتوفير نص تنفيذي ليتم تنفيذه بعد تشغيل الحزمة.

- قم بتحديث <filename.zip>إلى الاسم المستخدم في الخطوة 7 السابقة.

- تحديث <اسم المجلد> المستخدم لاحتواء ملف .dmg وملف install_options.xml

- قم بتحديث <Output dmg file.dmg>إلى الاسم المعلن في الخطوة 5 السابقة.

برنامج نصي للمثال

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

إذا واجهت مشاكل نشر متعلقة بنشر العميل الآمن من Cisco، فيمكنك الاتصال بفريق Cisco TAC.

بالنسبة لمشكلات النشر المتعلقة بالوحدة النمطية Umbrella، يرجى تسجيل تذكرة دعم مع دعم Cisco Umbrella.