6.2 Deploying the Mac Agent Via Intune (BETA)
- Cameron Barker
- Terry Lewis
Below is the process for deploying RoboShadow agents to MAC OS devices through InTune.
Please note this is early days for this process so we would like some feedback on this and happy to support you if you get stuck with anything.
Firstly you need to manually install the agent onto a MAC to allow the permissions to be set.
6.1 Mac Agent Manual Install Guide
Once the RoboShadow agent has been installed. Download and install PPPC-Utility from here - jamf/PPPC-Utility: Privacy Preferences Policy Control (PPPC) Utility (http://github.com )
PPPC-Utility will allow you to get the permissions XML needed for the InTune deployment.
Open PPPC-Utility, select the RoboShadow agent application and select the + button:
Search for and select the RoboClientMac and click Open
Search for and select Full Disk Access and select Allow
Select save. Select the location and name the saved file to something you can remember and identify the file. This is the XML we will need to import into InTune.
You can now close PPPC-Utility and go to the location you saved the file. In this case it is saved in Documents:
You can open the file with a text editor to review the XML if you need
Log into InTune with the required permissions to create deployments and create permissions profiles.
Best practice would be to create a static or dynamic device group to group machines you want to deploy the agent to. This group will be used later to deploy to the devices.
Firstly go to Devices/macOS/Configuration. Select Create and New Policy:
Select the Profile Type of Templates and use Template name of Custom click create:
Name the policy click next:
Name the configuration profile and select the file you saved previously with the permissions you created with PPPC-Utility:
If you have created a group for the devices. Select this group to deploy the configuration profile to select next and review the full policy. If you are happy click create:
Once this policy is saved you should see it here.
Next we can move onto deploying the agent to devices. The above is just for creating and deploying the configuration to give RoboShadow the required permissions to manage the device.
Select Apps/macOS and click add and choose macOS app (PKG):
Select “Select app package file” and navigate to the file location for the .pkg file:
Fill in the required information if you wish to:
Next step requires a post install script to run. This will link the RoboShadow agent to your organisation. You are required to have and add your RoboShadow organisation ID. Add the following script to the Post-Install script box:
#!/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" : "<Organisation ID>",
"DebugMode" : false
}
EOF
# Set permissions if necessary (optional)
chmod 644 "$FILE_PATH"
echo "Setup file created at $FILE_PATH"
Add the script and select next:
Select the minimum macOS version this will apply to:
Select any additional detection rules if required:
Review and save the app deployment.
Ensure any devices you wish to roll this out to are correctly enrolled into InTune and added to the required groups that the configuration profile is being deployed to as well as the .pkg is being deployed to.
When the device checks into InTune it should pull down the configuration and the agent pkg. Double check the following location on a few test machines to confirm the script is running and working:
Using a terminal, navigate to:
/Users/shared/com.roboshadow
Run the LS command and confirm there is a setup.cfg file in place. You can cat this file to review the configuration:
The Mac Manual install guide has some trouble shooting steps for the client, but if you struggle with any of this then please get in touch: