Skip to main content
PropertyTypeDefault ValueApplied onVersionNotes
domainStringTenant Domain is used to for displaying the tenant in the Agent Menu.
idsDomainLookupStringSupplies the url used for the Domain FQDN call. Should contain the domain and end in the form <url>/<domain>/ The idsDomainLookup is used to construct our FQDN service and directly to make the FQDN call. It is also used when we send logs.
oAuthClientSecretStringUsed as the oAuth token for asset registration call occurring before enrollment (currently being implemented)
oAuthClientIdStringNot currently used
oAuthScopeStringThe scope of what the oAuthClientSecret can be used for. Not currently used
disabledFeaturesarray of one Of (‘sudo’, ‘kerberos’) For versions under 24.2.0, also ‘unenrolledReminder’Accepted values are “kerberos”, “sudo”, “unenrolledReminder” Slightly changes the enrollment behavior based on if tenant wants to update their sudo configuration and if tenant is leveraging kerberos unenrolledReminder - Setting to false disables the automatic presentation of the welcome view every login or 24 hours for a non-enrolled user (REMOVED in 24.2.0, this is now handled by the enableGetStartedNotification value returned from the asset/configuration call)
canUnenroll (optional)BooleanFalseIn agent menu - will determine if “Unenroll” is visible after enrollment
accountLockOverride (optional)Dictionary"accountLockOverride" : { "maxFailedLoginAttempts": 8, "minutesUntilFailedLoginReset": 60, "shouldLockScreenOnAccountLock": true }maxFailedLoginAttempts: number Number of failed PIN entry attempts after which user is blocked from logging in to the macOS for lockout period defined below. Another invalid PIN entry attempt within lockout period extends the lockout period by the same amount of minutes. minutesUntilFailedLoginReset: number Length of the lockout period in minutes. shouldLockScreenOnAccountLock: boolean Determines whether or not the screen will lock when the user gets blocked from logging in to the macOS
enableAdminAccess (optional)BooleanFalseIf set to true, the menu will display “Admin Access” for standard users
allowOtherSmartCard (optional)BooleanTrueIf set to false, we search for other smart cards and print a warning if there was any found (i.e. Yubikey) prior enrollment
certExpirationOverride (optional)booleanFalseMA’s startPresent the “Renew Certificate…” option in the agent menu whole time. (WA-13230)
ssoRedirectionURLs (optional)Array of StringsEnrollment, MA StartTells the app to autoselect the identity used to SSO to the resource at the URLs supplied. Example: “ssoRedirectionURLs”: [ “https://next.cert.stage.truu.ai:443”, “https://url2:443”]
disableAssetAPICalls (optional)BooleanFalseSetting to true disables Asset Enrollment and Heartbeat
eventCacheMaxAge (optional)integer720MA’s Start25.2.0Specifies for how long we should persist the event. Value is in hours.
kerberosRealms (optional)Array of StringsArray of Realms and KDCs. Attempts to force use of the listed Realms and KDCs during enrollment. Examples:\\“kerberosRealms”:[ “corp.truu.ai” ] or (supplying a cdc in addition to the realm)“kerberosRealms”:[ “corp.truu.ai;kdc1234.corp.truu.ai” ]
useLocalNameForKerberosBooleanFalseThe option useLocalNameForKerberos = true is needed for an environments, where the Kerberos realm principal name differs from the linked TruU account. In such cases, the principal name constructed from the NSUserName and the realm name.
enableLogSubmissionOnLoginViewBooleanFalseMA’s Start24.2Enables the ability to send logs from the custom login view
authPluginSettings (optional)Dictionary"authPluginSettings" : { "enableLoginWindow": false }24.2
enrollmentReminderDelayInteger10MA’s Start24.3.0This key can postpone the enrollment notification, for example, to be shown 1 minute after it is triggered (timer/login/MA installation/…). Value is in seconds.
fetchDirectoryGroups (optional)booleanFalseMa’s Start25.1.1configure if entra groups should be regularly fetched into “/Library/Preferences/com.truu.user.state.plist”
runPostEnrollmentAfterReboot (optional)booleanfalseADE account creation24.6.0This key can controls behavior for post-enrollment phase. If set to “true” then post-enrollment phase postponed until computer reboot.
paginationSize (optional)integer1000User info groups fetching24.6.0The agent is pooling data from Identity Server to provide info about user’s groups. For some tenants that’s a tens of thousands. This parameter manages the bulk (page) size what can be fetched at one HTTP GET call.
odPwdChangeAllowed (optional)booleantrueMA’s Start25.2.1If set to true, users can change their system password when enrolled via system settings, MDM, or using the recovery Key
fileVaultAutologon (optional)booleantrueLogin Window start24.5.0Defines if the login window should be skipped once credentials were already provided on the FileVault screen.
config.json example
{
  "domain": "demo-truu",
  "idsDomainLookup": "https://global.platform.truu.ai/api/v1/public/fqdn/demo-truu/",
  "oAuthClientId": "oauth client value",
  "oAuthClientSecret": "client secret value",
  "oAuthScope": "tenant-management-api-agent",
  "disabledFeatures": ["unenrolledReminder"],
  "canUnenroll": true,
  "allowPasswordSync": true,
  "accountLockOverride" : {
     "maxFailedLoginAttempts": 10,
     "minutesUntilFailedLoginReset": 10,
     "shouldLockScreenOnAccountLock": true
  },
  "ssoRedirectionURLs": [],
  "kerberosRealms" : [],
  "useLocalNameForKerberos": true,
  "nitroSSO": true
}

Required System Permissions Manual Install TruU