Deploy Footprint Agent for macOS using SimpleMDM

Introduction

In order to deploy the Footprint agent using SimpleMDM, you'll just need to follow these simple steps: 

1. Copy the installation script from Footprint

2. Create a script with the command to download, install, and connect the agent to your dashboard

3. Create a job so that SimpleMDM can deploy the script.

Copy macOS installation script from Footprint

1. Log into your Footprint Console

2. On the left bar, click Scan Surface.

3. On the top menu, click Agent-based Surface.

   • If Agent-based Surface does not appear here, you may need to enable this feature.

     • Browse to Settings | Client Settings.

     • Locate the Installation Mode, and select Enable Agent-based.

     • Click Just enable the features.

     • You can then return to Scan Surface and click Agent-based Surface.

4. Switch to the Setup agents tab.

   • On the Use Footprint Agents to gain more insights on your organization's internal security page, on the right side, you will see two important pieces of information which you will need to set up each endpoint:

     • 🌐Footprint Agent Management URL (the custom URL that you use to manage your Footprint environment)

     • 🔑Footprint Agent Token (a unique alphanumeric token which your Internal Scanner VM will use to communicate with your Footprint environment)

5. Under the OS options, beneath the Apple logo, click Get | Get Agent Command

6. On the right side, Run the following command to install the agent will appear, along with a curl command in a text box. Note that the command includes your organization's specific Footprint Management URL and Footprint Agent Token.

   Click the copy button to copy that command to the clipboard.

Create an Installation Script in SimpleMDM

1. Log into SimpleMDM at https://a.simplemdm.com.

2. On the left navigation bar, navigate to the Scripts section.

3. Click Create Script

4. Give the script a meaningful name, such as Footprint Deployment.

5. On the first line, enter a shebang:

   #!/bin/bash

6. Press Enter to add another line. On the second line, paste the Footprint curl installation command from the clipboard exactly as it was copied above.

7. Click Save.

Once you have created your script, you will be able to use it to create a job to run on your devices.

Creating A Job

1. Log into SimpleMDM at https://a.simplemdm.com.

2. On the left navigation bar, navigate to the Scripts section.

3. Click Create Script

4. Give the script a meaningful name, such as Footprint Deployment.

5. On the first line, enter a shebang:

   #!/bin/bash

6. Press Enter to add another line. On the second line, paste the Footprint curl installation command from the clipboard exactly as it was copied above.
   
   

   

For more information about scripts and jobs in SimpleMDM, including how to check the completion status of jobs in progress, see the Scripts article in the SimpleMDM help center.

Confirm that your macOS device has connected to Footprint

1. Back in Footprint, on the left bar, click Scan Surface.

2. On the top menu, click Agent-based Surface, and select the Deployed agents tab.

3. You will see all deployed agents on this list, as well as their online/offline State.

Troubleshooting

If you run into any problems with the Footprint Agent for macOS, collect the log files located in this folder, and submit them via the Contact Support button in the top right corner of the help center.

/private/var/log/CODA/FootprintAgent/