diff --git a/docs/functions/api_examples.md b/docs/functions/api_examples.md index a274bfb6..fd3f42d7 100644 --- a/docs/functions/api_examples.md +++ b/docs/functions/api_examples.md @@ -455,3 +455,45 @@ var_dump($audit); ?> ``` + +## Update software using API + +``` +#!/rmm/api/env/bin/python + +import concurrent.futures +import requests + +API = "https://api.CHANGEME.com" +API_KEY = "CHANGEME" + +HEADERS = { + "Content-Type": "application/json", + "X-API-KEY": API_KEY, +} + +MAX_WORKERS = 10 + + +def create_list_of_urls(): + ret = [] + agents = requests.get(f"{API}/agents/?detail=false", headers=HEADERS) + for agent in agents.json(): + ret.append(f"{API}/software/{agent['agent_id']}/") # refresh software endpoint + + return ret + + +def do_software_refresh(url): + r = requests.put(url, headers=HEADERS) + return r.json() + + +with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor: + futures = [] + for url in create_list_of_urls(): + futures.append(executor.submit(do_software_refresh, url)) + + for future in concurrent.futures.as_completed(futures): + print(future.result()) +``` \ No newline at end of file diff --git a/docs/functions/automation_policies.md b/docs/functions/automation_policies.md index 81c98d7e..b636f19c 100644 --- a/docs/functions/automation_policies.md +++ b/docs/functions/automation_policies.md @@ -9,6 +9,8 @@ Automation policies in Tactical RMM allow for mass deployment of Checks, Automat You can also see a list of Relations that show what policy is applied to what Clients / Sites / Agents. +![Automation Results](images/automation_results.png) + Before you ask, [multiple automation policies](https://github.com/amidaware/tacticalrmm/issues/665) per level is in the todo list. ## Creating Automation Policies @@ -33,7 +35,7 @@ At each level you can block policy inheritance from the level above using checkb ## Adding Windows Patch Management Policy -Under the Automation Manager you can create a Patch Policy and control what patches are applied, when, and if the computer is rebooted after. +Under the Automation Manager you can create a Patch Policy and control [what patches](../howitallworks.md#windows-update-management) are applied, when, and if the computer is rebooted after. !!!note Most "regular" Windows patches are listed in the "Other" category. diff --git a/docs/functions/images/2024-02-15_221723 - ScreenConnect.WindowsClient_PCR_David_MBPro_13_inch_mid_2014_-_PC_Support_-_Co.png b/docs/functions/images/2024-02-15_221723 - ScreenConnect.WindowsClient_PCR_David_MBPro_13_inch_mid_2014_-_PC_Support_-_Co.png new file mode 100644 index 00000000..5b4a9faa Binary files /dev/null and b/docs/functions/images/2024-02-15_221723 - ScreenConnect.WindowsClient_PCR_David_MBPro_13_inch_mid_2014_-_PC_Support_-_Co.png differ diff --git a/docs/functions/images/automation_results.png b/docs/functions/images/automation_results.png new file mode 100644 index 00000000..a77b09fe Binary files /dev/null and b/docs/functions/images/automation_results.png differ diff --git a/docs/images/2024-02-15-22-17-49.png b/docs/images/2024-02-15-22-17-49.png new file mode 100644 index 00000000..f7f6e128 Binary files /dev/null and b/docs/images/2024-02-15-22-17-49.png differ diff --git a/docs/images/2024-02-15-22-22-33.png b/docs/images/2024-02-15-22-22-33.png new file mode 100644 index 00000000..ad7e0754 Binary files /dev/null and b/docs/images/2024-02-15-22-22-33.png differ diff --git a/docs/images/2024-02-15-22-22-56.png b/docs/images/2024-02-15-22-22-56.png new file mode 100644 index 00000000..9457da7e Binary files /dev/null and b/docs/images/2024-02-15-22-22-56.png differ diff --git a/docs/images/2024-02-15-22-23-48.png b/docs/images/2024-02-15-22-23-48.png new file mode 100644 index 00000000..6c7c02e7 Binary files /dev/null and b/docs/images/2024-02-15-22-23-48.png differ diff --git a/docs/install_agent.md b/docs/install_agent.md index e42a4caa..8e1fb808 100644 --- a/docs/install_agent.md +++ b/docs/install_agent.md @@ -223,3 +223,21 @@ wget scripturl chmod +x rmm.sh ./rmm.sh ``` + +## Mac Agent Permissions + +Because Mac has no automated access to permissions you must grant all permissions manually after agent install (you might need to attempt a mesh connection once after install to get mesh to appear in the security settings) + +![](images/2024-02-15-22-22-56.png) + +Take Control needs Screen Recording (to see anything more than the menu bar) + +![](images/2024-02-15-22-23-48.png) + +and Accessibility for keyboard/mouse input + +![](images/2024-02-15-22-22-33.png) + +tacticalagent needs full disk access for script running + +![](images/2024-02-15-22-17-49.png)