feat(INSTALLER): support manual monterey installs

README.md

@@ -11,6 +11,20 @@ Ansible role that installs the JumpCloud agent on OSX machines.
 ### Notes:
 - See the [JumpCloud Website](https://jumpcloud.com/) for further details about this platform.
 
+### Monterey and Later:
+
+On OSX versions >= 12, there's are 2 manual installation steps required.
+- **Prior** to installing this role, the **Terminal** application should be given `Full Disk Access`.  
+- **While** installing this role, the `System Preferences` window will open, waiting five minutes for you to grant the JumpCloud Agent full disk access, before declaring the installation a failure.  
+
+This requires making the appropriate selection inside `System Preferences --> Security`:
+
+![SystemPreferences](.documentation/SystemPreferences.png)
+
+Once these steps are completed once, subsequent runs will complete without the interruption.
+
+See the [JumpCloud Website](https://jumpcloud.com/) for further details about the agent's requirements.
+
 Requirements
 ------------
 

molecule/mock_install_no_update/verify.yml

@@ -15,4 +15,4 @@
     - name: Check Mock Install Arguments
       assert:
         that:
-          - results.content | b64decode == "-s -k secret_jumpcloud_key\n"
+          - results.content | b64decode == "-f -s -k secret_jumpcloud_key\n"

molecule/mock_install_with_update/verify.yml

@@ -12,4 +12,4 @@
     - name: Check Mock Install Arguments (confirm it's been installed twice!)
       assert:
         that:
-          - results.content | b64decode == "Mock Previous Install\n-s -k secret_jumpcloud_key\n"
+          - results.content | b64decode == "Mock Previous Install\n-f -s -k secret_jumpcloud_key\n"

tasks/main.yml

@@ -19,7 +19,7 @@
 
 - name: Run the Agent Installation Script
   become: true
-  command: "{{ jumpcloud_installer_destination }} -s -k {{ jumpcloud_connect_key }}"
+  command: "{{ jumpcloud_installer_destination }} -f -s -k {{ jumpcloud_connect_key }}"
   register: installed
   args:
     chdir: /tmp/