Endpoint configuration · GraphQL type

UserSystemSettings type

The per-user operating system configuration of one user account on an Endpoint, complementing the machine-wide SystemSettings. Collected on macOS only, it carries UserSystemSettingsMacOS, read from the user's own preference domains and account record: screen saver idle time and whether a password is required after sleep or screen saver, Universal Control, Siri and search data sharing, Bluetooth sharing, the user's location daemon preference and whether a password hint is set. One UserSystemSettings exists per (endpoint, user) pair; it is linked to its EndpointUser and is reachable from that user's userSystemSettings field rather than directly from the Endpoint.

Fields

Field Name Description
id - ID! The UserSystemSettings' unique identifier on the security graph.
orgId - OrganizationId! Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to.
objectType - GraphObjectType! The type of this graph object.
objectTypeLabel - String! A localized label describing the object type.
displayName - String! A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object.
firstSeen - Time! Time this object was first seen.
lastSeen - Time! Time this object was last seen.
seen - SeenOnline! Describes when this UserSystemSettings was seen.
createdAt - Time! The time this object was created in the security graph.
updatedAt - Time! The time this object was last mutated in the security graph.
snapshotInfo - GraphObjectSnapshotInfo! Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed.
endpointUser - EndpointUser The EndpointUser these settings apply to.
osSpecific - UserSystemSettingsOsSpecific The platform-specific per-user settings. Currently always UserSystemSettingsMacOS.
findings - FindingsPayload! Policy findings for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.

issues - IssuesPayload! Policy issues for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.

issuesSummary - IssuesSummary! Summary of the active policy issues currently open on this object, broken down by severity.

Returned by

  • userSystemSettings query: Retrieves one macOS user's UserSystemSettings by its graph object id: screen saver locking, Universal Control, Siri and search data sharing,…

Used by

  • EndpointUser type: An operating system or domain user account observed on an Endpoint.
  • GraphObjectType enum: An enumeration of the different types of security graph objects.
  • GraphObjectTypeCategory enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
  • UserSystemSettingsPayload type: Payload wrapper for a single UserSystemSettings result.

Related types

  • EndpointUser An operating system or domain user account observed on an Endpoint.

Example

Example

{
  "id": 4,
  "orgId": "615f3b3b28284380e28a7342",
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "seen": SeenOnline,
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "endpointUser": EndpointUser,
  "osSpecific": UserSystemSettingsMacOS,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}