6.4 Deploying the Mac Agent via Addigy RMM

Information:

This guide demonstrates how to set up and deploy the RoboShadow agent into an Addigy policy for a customer. For each new deployment, you will need to create a package.

Obtain RoboShadow .pkg File:

Log into RoboShadow and click on 'Agent' in the top bar, then select 'Downloads':

Select ‘Mac’ and press ‘Download Agent (PKG)’

In the RoboShadow portal navigate to the organisations in the User menu:

You will then see your organisation ID’s listed

Create Package in Addigy

Log into Addigy and select 'Catalog', then 'Software':

Select 'New':

Give the software package a name, e.g. “ (your company name) RoboShadow Installer':

Press 'Select Files'. If the .pkg file has previously been uploaded, it will appear here. If it has not, then press 'Upload New' and browse your file directory to find the installer.

Press 'Select' to confirm the file then Press 'Add' under 'Install Command' to add the standard installation script:

Make space in the lines above the script and paste in the following

#!/bin/bash
# Bash script to create the setup.cfg file:
DIRECTORY="/Users/Shared/com.roboshadow"
FILE_PATH="$DIRECTORY/setup.cfg"
# Create the directory if it doesn't exist
if [ ! -d "$DIRECTORY" ]; then
mkdir -p "$DIRECTORY"
fi
# Create the setup.cfg file with the specified content
cat <<EOF> "$FILE_PATH"
{
"UploadMode" : true,
"OrganisationId" : "<OrgID>",
"DebugMode" : false
}
EOF
# Set permissions if necessary (optional)
chmod 644 "$FILE_PATH"
echo "Setup file created at $FILE_PATH"

Where '' is the organisation ID from section 2.2. This will create a .cfg file in /Users/Shared/com.roboshadow and insert the OrgID into the file. The whole installation script should start like this:

And end with the standard installation script above.

PPPC Permissions:

PPPC permissions will give the application the system access that is required. Select 'Attached Profiles' and expand:

Click on '2 apps found' to expand further:

Press 'Select all' and then click on 'Create Profiles'. Then expand 'RoboClientMac':

Set 'Allow' to:

File Provider Prescence
Removable Volumes
Media Library
Photos
Access to App Data
System Files
Desktop Folder
Documents Folder
Downloads Folder
Network Volumes
Admin Files

Others should be set to 'Deny'. You do not need to change the permissions for 'Roboshadow Uninstaller'. Press 'Save' at the bottom right

Add to Policy:

In Addigy, select 'Policies' on the left-hand side:

Find the policy for the organisation:

Navigate to 'Software':

Then search for the installer package e.g. “ (your company name) RoboShadow Installer':

Click on the tickbox and then press 'Add/Remove', then 'Add to Policy':

Once added, press 'Deploy Now':

You can track the progress of the deployment by pressing the 'Status' drop-down.

Provided no errors are present and devices are online, the deployment should be complete. The policy will push out every half an hour by default.

Check Endpoints in RoboShadow:

This step is optional but strongly advised.

To view the registered endpoints in RoboShadow go to the 'Organisations' drop-down in the right-hand corner and select:

Go to 'Device Engagement' and select 'Hardware':

Select 'Mac':

This should then list the endpoints that RoboShadow has installed to:

Roboshadow