annotate mod_flash_policy.wiki @ 295:57e98a9eadb1

add page
author Kim Alvefur <zash@zash.se>
date Wed, 01 Aug 2012 16:13:37 +0200
parents 41800325d778
children 528721aaea46
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
199
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
1 #summary Adds support for flash socket policy
200
41800325d778 Edited wiki page mod_flash_policy through web user interface.
leonbogaert@gmail.com
parents: 199
diff changeset
2 #labels Stage-Alpha
199
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
3
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
4 = Introduction =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
5
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
6 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.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
7
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
8 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.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
9
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
10 = Usage =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
11
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
12 Add "flash_policy" to your modules_enabled list.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
13
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
14 = Configuration =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
15
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
16 || crossdomain_file || Optional. The path to a file containing an cross-domain-policy in xml format. ||
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
17 || crossdomain_string || Optional. A cross-domain-policy as string. Should include the xml declaration. ||
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
18
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
19 Both configuration options are optional. If both are not specified a cross-domain-policy with "{{{<allow-access-from domain="*" />}}}" is used as default.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
20
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
21 = Compatibility =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
22 ||0.7||Works||
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
23
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
24 = Caveats/Todos/Bugs =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
25
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
26 * The assumption is made that the first packet received will always
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
27 contain the policy request data, and all of it. This isn't robust
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
28 against fragmentation, but on the other hand I highly doubt you'll be
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
29 seeing that with such a small packet.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
30 * Only tested by me on a single server :)