Skip to content

Deployment with Kandji

This guide tells you how to deploy the SenseOn Universal Sensor to macOS devices with Kandji.

Kandji deploys SenseOn in two steps:

  1. Use a configuration profile to give the agent Full Disk Access.
  2. Run the SenseOn install command as a Custom Script library item. The script installs the latest published version of the Universal Sensor on each device in the scope.

Step 1: Enable Full Disk Access

Full Disk Access is necessary for the SenseOn endpoint agent to operate. Upload the SenseOn Full Disk Access configuration profile to Kandji:

  1. Download the file SEE-FDA.mobileconfig. Click here to download SEE-FDA.mobileconfig.
  2. Log in to Kandji.
  3. Go to Library > Add New.
  4. Click Custom Profile.
  5. Click Add & Configure.
  6. Give the profile a name, for example SenseOn Full Disk Access.
  7. Select the Blueprint or Blueprints to which you want to deploy.
  8. Under Device families, select only Mac.
  9. Upload the SEE-FDA.mobileconfig file.
  10. Click Save.

Kandji Full Disk Access

Step 2: Copy your install command

  1. Log in to SenseOn.
  2. Go to Settings > Universal Sensor.
  3. Copy the macOS install command.

Step 3: Create the Kandji Custom Script

  1. Log in to Kandji.
  2. Go to Library > Add New.
  3. Select Custom Script.
  4. Click Add & Configure.
  5. Give the script the name SenseOn Install.
  6. Select the Blueprint or Blueprints to which you want to deploy.
  7. Under Device families, select only Mac.
  8. Set Execution Frequency to Run once per device.
  9. Paste the script that follows into the Audit Script box. Replace the tenant hostname and the installer key with your values from Step 2.

    #!/bin/bash
    set -e
    curl -fsSL https://<your-tenant>.senseon.io/install.sh -o /tmp/senseon-install.sh
    shasum -a 256 /tmp/senseon-install.sh  # compare against the SHA-256 value shown in Settings > Universal Sensor
    SENSEON_INSTALLER_KEY="<your-installer-key>" bash /tmp/senseon-install.sh
    

    If your security policy does not make checksum verification mandatory, you can use the one-line form as an alternative:

    #!/bin/bash
    set -e
    curl -fsSL https://<your-tenant>.senseon.io/install.sh \
      | SENSEON_INSTALLER_KEY="<your-installer-key>" bash
    
  10. Click Save.

Step 4: Verify

After a managed Mac checks in and runs the script, the Mac appears in Assets > Devices in a few minutes. For diagnostics, refer to Troubleshooting.


Ongoing Health Monitoring

You can configure alerts to make sure that the agent is healthy on the devices to which you deployed it.

  1. Log in to Kandji.
  2. Go to Library > Add New.
  3. Select Custom Script.
  4. Click Add & Configure.
  5. Give the script a name, for example Check SEE status.
  6. Select the Blueprint or Blueprints that you want to monitor.
  7. Set Execution Frequency to the value that is applicable to your needs (for example, Run Daily).
  8. Add the script that follows to the Audit Script box:

    sudo /usr/local/bin/seectl status
    
  9. Click Save.