mod_pubsub_post

Introduction

Lets you easily publish data to PubSub using a HTTP POST request. The payload can be Atom feeds, arbitrary XML, or arbitrary JSON. The type should be indicated via the Content-Type header.

curl http://localhost:5280/pubsub_post/princely_musings \
    -H "Content-Type: application/json" \
    --data-binary '{"musing":"To be, or not to be: that is the question"}'

• JSON data is wrapped in a XEP-0335 container.
• An Atom feed may have many <entry> and each one is published as its own PubSub item.
• Other XML is simply published to a randomly named item as-is.

Configuration

Authentication

Authentication can be handled in two different ways.

None

pubsub_post_actor = "superuser"

The module uses an internal actor that has all privileges and can always do everything. It is strongly suggested that you do not expose this to the Internet. Maybe it shouldn’t be the default…

IP

pubsub_post_actor = "request.ip"

Uses the IP address from the HTTP request as actor, which means this pseudo-JID must be given a ‘publisher’ affiliation. This should work nicely with the autocreate_on_publish setting, where the first actor to attempt to publish to a non-existant node becomes owner of it, which includes publishing rights.

Setting up affiliations

Prosodys PubSub module supports setting affiliations via XMPP, in trunk since revision 384ef9732b81.

It can however be done from another plugin:

local mod_pubsub = module:depends("pubsub");
local pubsub = mod_pubsub.service;

pubsub:create("princely_musings", true);
pubsub:set_affiliation("princely_musings", true, "127.0.0.1", "publisher");