Preference Keys - Catalog Agent

This article describes all available preference keys for the App Catalog Agent, responsible for installing and updating apps.

Preference domain

When creating the Configuration Profile, the preference domain must be set to: nl.root3.catalog

Keys

authorization (required)

The authorization key is required for the App Catalog to communicate with the backend service. Required for both the Catalog Agent and Catalog App. You can obtain your authorization key in your Profile.

Key: authorization

Value type: String

Default: -

Example:

<key>authorization</key>
<string>AUTHORIZATION_CODE</string>

AllowUpdatesContrainedNetworks

By default, the update schedule will not perform updates if the Mac is connected to a Personal Hotspot or another expensive or constrained network, such as when Low Data Mode is enabled. Updating apps can be an expensive network activity and not desirable while using cellular data or when bandwidth is limited. Enabling this setting will overrule this behaviour and always update, regardless of the network type.

Key: AllowUpdatesContrainedNetworks

Value type: Boolean

Default: false

Example:

<key>AllowUpdatesContrainedNetworks</key>
<true/>

ExcludeAppsUpdate

By default, all installed apps are checked against apps in the App Catalog and updated as part of the update schedule. To exclude apps from the update schedule, add all the Bundle Identifiers from https://portal.appcatalog.cloud/catalog to this preference.

Key: ExcludeAppsUpdate

Value type: Array of strings

Default: -

Example:

<key></key>
<array>
    <string>com.google.Chrome</string>
    <string>org.mozilla.firefox</string>
</array>

HideUpdateNotifications

By default, update notifications are displayed to the end user. Setting this key to false disables update notifications.

Key: HideUpdateNotifications

Value type: Boolean

Default: false

Example:

<key>HideUpdateNotifications</key>
<true/>

NotificationTitle

By default, app installs or updates will generate a user notification in Notification Center. This notifications contains an optional title shown at the top of the notification. You can configure this title to your organization's name or another title that makes sense to the user.

Key: NotificationTitle

Value type: String

Default: App Catalog

Example:

<key>NotificationTitle</key>
<string>Acme Inc.</string>

Reference

You can create multiple Configuration Profiles and configure a reference for each. Using a reference will shows results for the computers associated with this reference in the App Catalog Dashboard.

Key: Reference

Value type: String

Default: -

Example:

<key>Reference</key>
<string>Development</string>

TeamViewerHostID

The App Catalog has an integration with TeamViewer Host to apply your organization's custom configuration. To use this integration, the unique Configuration ID from the TeamViewer Management Console. Check Get TeamViewer Configuration ID for instructions how to get this value.

Key: TeamViewerHostID

Value type: String

Default: -

Example:

<key>TeamViewerHostID</key>
<string>idcXXXXXXX</string>

TeamViewerQuickSupportID

The App Catalog has an integration with TeamViewer QuickSupport to apply your organization's custom configuration. To use this integration, the unique Configuration ID from the TeamViewer Management Console. Check Get TeamViewer Configuration ID for instructions how to get this value.

Key: TeamViewerQuickSupportID

Value type: String

Default: -

Example:

<key>TeamViewerQuickSupportID</key>
<string>idcXXXXXXX</string>

UpdateDeferrals

This key allows you to customize the maximum number of deferrals if an application requires user interaction to start the update.

Key: UpdateDeferrals

Value type: Integer

Default: 3

Example:

<key>UpdateDeferrals</key>
<integer>2</integer>

UpdateInterval

This key enables an automatic update schedule to update all available app updates. When configured to 1 or higher, the update schedule will run every X days. More info is available here: Updating Apps

Key: UpdateInterval

Value type: Integer

Default: -

Example:

<key>UpdateInterval</key>
<integer>1</integer>

Applicable only for macOS 13 and later