Mercurial > prosody-wiki

annotate mod_flash_policy.wiki @ 199:e3654b7cd4aa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Created wiki page through web user interface.
author leonbogaert@gmail.com
date Wed, 06 Jul 2011 21:23:46 +0000
parents
children 41800325d778
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
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
2
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
3 = Introduction =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
4
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
5 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
6
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
7 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
8
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
9 = Usage =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
10
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
11 Add "flash_policy" to your modules_enabled list.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
12
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
13 = Configuration =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
14
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
15 || 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
16 || 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
17
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
18 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
19
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
20 = Compatibility =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
21 ||0.7||Works||
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
22
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
23 = Caveats/Todos/Bugs =
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
24
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
25 * 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
26 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
27 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
28 seeing that with such a small packet.
e3654b7cd4aa Created wiki page through web user interface.
leonbogaert@gmail.com
parents:
diff changeset
29 * Only tested by me on a single server :)