Sync all MacOS User Computers

To send us data related to employee/contractor MacOS computers, you send us MacosUserComputer resources. This helps us determine important security properties, like whether devices have encrypted drives, have anti-virus installed or have password managers installed.

This call replaces ALL existing MacosUserComputer resources for the given app and source_id - this is a “state of the world” sync. In other words, if a MacosUserComputer resource is sent for a user in a previous sync_all call, but is not included in a later sync_all call for that customer, it is assumed to no longer exist and is deleted in Vanta.

** Headers **

Authorization: Bearer <access_token>

** Scopes **

connectors.self:write-resource

** Schema **

Expand the resources array below for the schema of MacosUserComputer.

PUT /v1/resources/macos_user_computer

Sync all MacOS User Computers

cURL

curl --request PUT \
  --url https://api.vanta.com/v1/resources/macos_user_computer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resourceId": "<string>",
  "resources": [
    {
      "displayName": "<string>",
      "uniqueId": "<string>",
      "externalUrl": "<string>",
      "collectedTimestamp": "2023-11-07T05:31:56Z",
      "osName": "<string>",
      "osVersion": "<string>",
      "hardwareUuid": "<string>",
      "serialNumber": "<string>",
      "applications": [
        {
          "name": "<string>",
          "bundleId": "<string>",
          "lastOpenedTimestamp": "2023-11-07T05:31:56Z"
        }
      ],
      "browserExtensions": [
        {
          "extensionId": "<string>",
          "name": "<string>",
          "browser": "CHROME"
        }
      ],
      "drives": [
        {
          "name": "<string>",
          "encrypted": true,
          "filevaultEnabled": true,
          "isBootVolume": true
        }
      ],
      "users": [
        {
          "username": "<string>",
          "screenlockPolicies": [
            {
              "requiresPassword": true,
              "screenSleepTimeoutMs": 123
            }
          ],
          "screenlockSettings": {
            "requiresPassword": true,
            "screenSleepTimeoutMs": 123
          },
          "lastLoginTimestamp": "2023-11-07T05:31:56Z"
        }
      ],
      "systemScreenlockPolicies": [
        {
          "requiresPassword": true,
          "screenSleepTimeoutMs": 123
        }
      ],
      "isManaged": true,
      "autoUpdatesEnabled": true,
      "owner": "<string>",
      "lastEnrolledTimestamp": "2023-11-07T05:31:56Z",
      "isXProtectEnabled": true
    }
  ]
}
'

200

{
  "success": true
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

List of resources to sync

resourceId · string · required

Vanta generated identifier for the given resource, and can be found on the developer console page. See the list of registered resources and their IDs on https://app.vanta.com/settings/developer-console/<app_id>?tab=resources

resources · object[] · required

Show child attributes

Response

200 - application/json

The current resources synced.

success · boolean · required