# HG changeset patch
# User leonbogaert@gmail.com
# Date 1309987426 0
# Node ID e3654b7cd4aaa6e001cdf1feef15f9890991797b
# Parent  757684c251d9a300ab168e6c38edefbd1253ad4e
Created wiki page through web user interface.

diff -r 757684c251d9 -r e3654b7cd4aa mod_flash_policy.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_flash_policy.wiki	Wed Jul 06 21:23:46 2011 +0000
@@ -0,0 +1,29 @@
+#summary Adds support for flash socket policy
+
+= Introduction =
+
+This Prosody plugin adds support for flash socket policies. When connecting with a flash client (from a webpage, not an exe) to prosody the flash client requests for an xml "file" on port 584 or the connecting port (5222 in the case of default xmpp). Responding on port 584 is tricky because it requires root priviliges to set up a socket on a port < 1024.
+
+This plugins filters the incomming data from the flash client. So when the client connects with prosody it immediately sends a xml request string ({{{<policy-file-request/>\0}}}). Prosody responds with a flash cross-domain-policy. See http://www.adobe.com/devnet/flashplayer/articles/socket_policy_files.html for more information.
+
+= Usage =
+
+Add "flash_policy" to your modules_enabled list.
+
+= Configuration =
+
+|| crossdomain_file || Optional. The path to a file containing an cross-domain-policy in xml format. ||
+|| crossdomain_string || Optional. A cross-domain-policy as string. Should include the xml declaration. ||
+
+Both configuration options are optional. If both are not specified a cross-domain-policy with "{{{<allow-access-from domain="*" />}}}" is used as default.
+
+= Compatibility =
+||0.7||Works||
+
+= Caveats/Todos/Bugs =
+
+  * The assumption is made that the first packet received will always 
+contain the policy request data, and all of it. This isn't robust 
+against fragmentation, but on the other hand I highly doubt you'll be 
+seeing that with such a small packet.
+  * Only tested by me on a single server :)
\ No newline at end of file