Differences

This shows you the differences between two versions of the page.

--- trigger:Public_Web [2015/07/03 04:18]
peternlewis
+++ trigger:Public_Web [2018/07/16 22:49] (current)
JMichaelTX [Public Web Trigger]
@@ Line 1: / Line 1: @@
-The *Public Web trigger* makes a trigger available without authentication via the Keyboard Maestro web server.
+{{:trigger:web-server-icon.png?nolink|}}
-Keyboard_Maestro has an built-in web server.  You can enable it in the Keyboard Maestro Web Server preferences.  If enabled, and if you configure a username and password, you can connect to your Keyboard_Maestro’s web server and login and then execute any macro you have defined.  Also, if the web server is enabled, and if you have configured any macro with a Public Web trigger, then anyone on the Internet can connect to your Mac and trigger Public_Web macros.
+====== Public Web Trigger ======
-Note that this means anyone with Internet access to your Mac (which could be anyone, although it does depend on firewalls and NAT settings) can potentially trigger this macro so it should generally only be a safe macro such as restarting a service that is always supposed to be running, or launching iTunes or some other fairly innocuous activity.
+The *Public Web trigger* makes a macro available without further authentication via the Keyboard Maestro web server.  See [[trigger:Web_Server|Set Setup and Use of Web Server]].
+The _Public Web Trigger_ is one of several triggers that use a `URL`.  See\\
+[Macro Triggers that Use a URL](https://forum.keyboardmaestro.com/t/request-for-a-working-example-of-remote-trigger/10844/10?u=jmichaeltx), 2018-07-15, peternlewis
+Any macro with the [[Public Web]] trigger can be triggered by anyone without the username or password,
+assuming the Keyboard Maestro web server is enabled, and assuming they can connect to your Mac
+(which is usually anyone on your local network, but depends entirely on how your network is configured).
+**Public Web Trigger on a Macro**
+{{:trigger:public-web-trigger-on-macro.png?nolink|}}
+**To Execute a Specific Macro**
+```html
+https://localhost:<Port+1>/action.html?macro=<YourMacroUUID>&value=<TheTriggerValueToPass>
+or
+http://localhost:<Port>/action.html?macro=<YourMacroUUID>&value=<TheTriggerValueToPass>
+(by default, the <Port> is 4490, <Port+1> is 4491)
+```
+===== Security Caution =====
+  * (!) Note that this means anyone with Internet access to your Mac (which could be anyone, although it does depend on firewalls and NAT settings) can potentially trigger this macro.
+  * So it should generally only be a safe macro, such as:
+    * Restarting a service that is always supposed to be running, or
+    * Launching iTunes or
+    * Reporting or alerting you to something.
+    * Some other fairly innocuous activity.
+  * Clearly there are some serious security issues with this, **so you should use a lot of caution when you allow any macro to be executed with a Public Web trigger**.
 As with all triggers, macros are only available if they are currently active, that is if they are enabled and in a Macro Group that is enabled and active.
-For example, if you are running some sort of process on your Mac that occasionally fails, you could write a script to restart it and make it available as a Public_Web triggered Macro, which you (or anyone else) could then execute to restart the process.
+===== Examples =====
+For example, if you are running some sort of process on your Mac that occasionally fails, you could write a script to restart it and make it available as a Public Web triggered Macro, which you (or anyone else) could then execute to restart the process.
+For a complete example with a macro, see [MACRO:   @Web Open URL Passed from KM Public Web Server](https://forum.keyboardmaestro.com/t/open-url-passed-from-km-public-web-server/7019).
+===== See Also =====
+=== Triggers ===
+* [[trigger:Web_Server|Web Server]]
+* [[Remote|Remote]] trigger
+* [[trigger:URL|URL Theme Trigger]]
+* [[/Triggers|All Triggers]]
+=== Forum Topics ===
-Clearly there are some serious security issues with this, so you should use a lot of caution when you allow any macro to be executed with a Public Web trigger.
+* [Issue Using Public Web Trigger ](https://forum.keyboardmaestro.com/t/issue-using-public-web-trigger/5302)
+* [MACRO:   @Web Open URL Passed from KM Public Web Server](https://forum.keyboardmaestro.com/t/open-url-passed-from-km-public-web-server/7019)
+* [Triggering Keyboard Maestro macros remotely, KM8, Peter Lewis](https://forum.keyboardmaestro.com/t/triggering-keyboard-maestro-macros-remotely/8277)

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools