-
x-samp.homepage.url : application homepage URL.
-
x-samp.releasenotes.url : application release notes URL.
-
x-samp.rss.url : application RSS feed URL.
-
x-samp.faq.url : application FAQ URL.
-
x-samp.authors : application authors.
-
x-samp.release.version : application version identifier.
-
x-samp.release.date : application release date.
Subscription Annotations
The hub declareSubscriptions() method takes a subscriptions map; the keys are the MType patterns
and the values are maps which can potentially annotate the subscription to the MType(s) matching
the pattern in question. This form, rather than the perhaps more obvious list of MType patterns,
was introduced in case it became useful at some point in the future. Up till now, it hasn't been
used much (at all?).
Add below suggestions for well-known keys for use in this context.
-
x-samp.mostly-harmless : A subscribing client can use this to note that an MType it subscribes to is known to be (in)capable of causing security breaches if invoked by a potentially untrusted client. A value of "1" means that it is safe for untrusted invocation, and "0" means it is unsafe. Any other value (or absence of the key) makes no comment. Hub implementations may use this information to modify their policies about whether untrusted or marginally trusted clients are blocked from sending the MType(s) so annotated to that client, but they should not rely on its presence (should fall back to some default policy if it is not supplied). Example:
declareSubscriptions({"test.echo", {"x-samp.mostly-harmless": "1"},
"system.delete-all-files", {"x-samp.mostly-harmless": "0"},
"table.load.votable", {}})
-- MarkTaylor - 23 Nov 2011 |