---
title: SystemSettingsMacOS type | Wartiva GraphQL API
description: macOS-specific system settings including power management, privacy permissions, backup configuration, and security settings.
url: https://wartiva.com/api-docs/types/system-settings-mac-os.html
updated: 2026-10-07
---

Endpoint configuration · GraphQL type

# `SystemSettingsMacOS` type

macOS-specific system settings including power management, privacy permissions, backup configuration, and security settings. Per-user preferences (screen saver locking, Universal Control, Siri and search data sharing) live on [UserSystemSettingsMacOS](https://wartiva.com/api-docs/types/user-system-settings-mac-os.html).

## Fields

| Field Name | Description |
|---|---|
| `powerProfile` - [`PowerProfile`](https://wartiva.com/api-docs/types/power-profile.html) | Power management profile with battery and AC power source settings. |
| `locationServiceClients` - [`[LocationServiceClient!]`](https://wartiva.com/api-docs/types/location-service-client.html) | Applications registered with the location services daemon. |
| `privacyPermissions` - [`[PrivacyPermission!]`](https://wartiva.com/api-docs/types/privacy-permission.html) | TCC (Transparency, Consent, and Control) privacy permission entries. |
| `lockScreenSettings` - [`LockScreenSettings`](https://wartiva.com/api-docs/types/lock-screen-settings.html) | Lock screen and login window settings. |
| `backupConfiguration` - [`BackupConfiguration`](https://wartiva.com/api-docs/types/backup-configuration.html) | Time Machine backup configuration and destination encryption state. |
| `printerSharingEnabled` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether printer sharing is enabled on the system. |
| `authorizationRights` - [`[AuthorizationRight!]`](https://wartiva.com/api-docs/types/authorization-right.html) | Authorization rights from the Security framework authorization database. |
| `hotCornerSettings` - [`HotCornerSettings`](https://wartiva.com/api-docs/types/hot-corner-settings.html) | Hot corner action assignments for each screen corner. |
| `locationServicesEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether location services are enabled system-wide. |
| `showLocationSystemServices` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether the location services status bar icon is shown for system services. |
| `analyticsSharingEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether analytics sharing with Apple is enabled. |
| `fileVaultDisableRestricted` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether FileVault disable is restricted by policy. |
| `isGatekeeperEnabled` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether Gatekeeper is enabled, preventing unsigned or unnotarized applications from running. |
| `isNetworkTimeEnabled` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether network time synchronization (NTP) is enabled. |
| `getRemoteAppleEvents` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether remote Apple events are accepted from other machines. |
| `forceInternetSharingOff` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether Internet Sharing is forced off by policy. |
| `bonjourAdvertisingDisabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether Bonjour multicast advertising is disabled. |
| `automaticLoginEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether a user is automatically logged in at boot without entering a password (the autoLoginUser setting of the login window). CIS recommends automatic login be disabled. |
| `installLogRetention` - [`Duration`](https://wartiva.com/api-docs/types/duration.html) | How long entries in the system install log (/var/log/install.log) are retained, from the ttl setting of the asl(5) configuration at /etc/asl/com.apple.install. CIS recommends retaining install.log entries for at least 365 days. |
| `xProtectLaunchScansEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether XProtect malware scanning of applications at launch is enabled. |
| `xProtectBackgroundScansEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether XProtect background malware scanning is enabled. |
| `csrFlags` - [`[CSRFlag!]`](https://wartiva.com/api-docs/types/csr-flag.html) | System Integrity Protection (SIP) bypass flags decoded from the CSR bitmask. Each entry is a protection that is currently bypassed. An empty or null list indicates SIP is fully enabled. |
| `guestHomeFolderExists` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether the guest home folder (/Users/Guest) exists on the system. |
| `isAMFIEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether Apple Mobile File Integrity (AMFI) is enabled. |
| `loginWindowBannerExists` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | Whether a login window policy banner message file exists on the system. |
| `sudoConfig` - [`SudoConfig`](https://wartiva.com/api-docs/types/sudo-config.html) | Sudo configuration parsed from sudo -V output. |

## Used by

- [`SystemSettings`](https://wartiva.com/api-docs/types/system-settings.html) type: The machine-wide operating system configuration of an Endpoint.
- [`SystemSettingsOsSpecific`](https://wartiva.com/api-docs/types/system-settings-os-specific.html) union: OS-specific system settings union type.

## Example

### Example

```json
{
  "powerProfile": PowerProfile,
  "locationServiceClients": [LocationServiceClient],
  "privacyPermissions": [PrivacyPermission],
  "lockScreenSettings": LockScreenSettings,
  "backupConfiguration": BackupConfiguration,
  "printerSharingEnabled": true,
  "authorizationRights": [AuthorizationRight],
  "hotCornerSettings": HotCornerSettings,
  "locationServicesEnabled": false,
  "showLocationSystemServices": true,
  "analyticsSharingEnabled": false,
  "fileVaultDisableRestricted": true,
  "isGatekeeperEnabled": false,
  "isNetworkTimeEnabled": true,
  "getRemoteAppleEvents": true,
  "forceInternetSharingOff": false,
  "bonjourAdvertisingDisabled": false,
  "automaticLoginEnabled": false,
  "installLogRetention": "600000000",
  "xProtectLaunchScansEnabled": true,
  "xProtectBackgroundScansEnabled": false,
  "csrFlags": ["ALLOW_APPLE_INTERNAL"],
  "guestHomeFolderExists": true,
  "isAMFIEnabled": false,
  "loginWindowBannerExists": false,
  "sudoConfig": SudoConfig
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt