docs: add servicemanagement example profile (northpolesec#99)

pmarkowsky · Nov 3, 2024 · ccd0449 · ccd0449
1 parent 21aeda3
commit ccd0449
Show file tree

Hide file tree

Showing 2 changed files with 38 additions and 0 deletions.
diff --git a/docs/deployment/getting-started.md b/docs/deployment/getting-started.md
@@ -23,4 +23,6 @@ This page shows you the process to get started with your deployment of Santa.
 
     The notifications modified through this profile are different to the main Santa GUI pop-ups. To configure the [Santa GUI](../binaries/santa-gui.md) notifications, use the [configuration profile](configuration.md) (in step 2).
 
+1. (Optional) Suppress "Background Items Added" notifications. When Santa installs helper services a notification will popup, unless suppressed with a `com.apple.servicemanagement` MDM profile. A example profile can be found [here](./servicemanagement.santa.example.mobileconfig).
+
 1. Install the latest Santa package from [GitHub](/~https://github.com/northpolesec/santa/releases) (where you can also find release notes). The package is distributed as a `PKG` wrapped inside a `DMG`, both of which are properly signed and can be validated.
diff --git a/docs/deployment/servicemanagement.santa.example.mobileconfig b/docs/deployment/servicemanagement.santa.example.mobileconfig
@@ -0,0 +1,36 @@
+<?xml version=”1.0” encoding=”UTF-8”?>
+<!DOCTYPE plist PUBLIC “-//Apple//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”>
+<plist version=”1.0”>
+<dict>
+    <key>PayloadContent</key>
+    <array>
+        <dict>
+            <key>PayloadIdentifier</key>
+            <string>servicemanagement.santa.example.mobileconfig</string>
+            <key>PayloadUUID</key>
+            <string>0d4e2ece-dfa7-4103-97ff-e91a9f842a1d</string>
+            <key>PayloadType</key>
+            <string>com.apple.servicemanagement</string>
+            <key>Rules</key>
+            <array>
+                <dict>
+                    <key>RuleType</key>
+                    <string>TeamIdentifier</string>
+                    <key>RuleValue</key>
+                    <string>ZMCG7MLDV9</string>
+                </dict>
+            </array>
+        </dict>
+    </array>
+    <key>PayloadDisplayName</key>
+    <string>Service Management</string>
+    <key>PayloadIdentifier</key>
+    <string>com.northpolesec.santa.servicemanagement.03cca12c-a610-44c2-96f9-fdabe3acd47d</string>
+    <key>PayloadUUID</key>
+    <string>03cca12c-a610-44c2-96f9-fdabe3acd47d</string>
+    <key>PayloadType</key>
+    <string>Configuration</string>
+    <key>PayloadScope</key>
+    <string>System</string>
+</dict>
+</plist>
Original file line number	Diff line number	Diff line change
Expand Up		@@ -23,4 +23,6 @@ This page shows you the process to get started with your deployment of Santa.

		The notifications modified through this profile are different to the main Santa GUI pop-ups. To configure the [Santa GUI](../binaries/santa-gui.md) notifications, use the [configuration profile](configuration.md) (in step 2).

		1. (Optional) Suppress "Background Items Added" notifications. When Santa installs helper services a notification will popup, unless suppressed with a `com.apple.servicemanagement` MDM profile. A example profile can be found [here](./servicemanagement.santa.example.mobileconfig).

		1. Install the latest Santa package from [GitHub](/~https://github.com/northpolesec/santa/releases) (where you can also find release notes). The package is distributed as a `PKG` wrapped inside a `DMG`, both of which are properly signed and can be validated.