Default expiration value to be used when the client doesn't supply one (in seconds). It is used for both subscriptions and publications.

Default value is 3600.

Maximal subscription expiration value in seconds.

Default value is 3600.

Maximal expiration of presence status information published via PUBLISH in seconds.

Default value is 3600.

If set to 1, PA module stores all subscription data into database and reloads them on startup. Requires db_url to be set.

Default value is 1.

Database connection URL. It has to be specified if use_db or use_offline_winfo is set.

Default value is empty.

...
modparam("pa", "use_db", 1)
modparam("pa", "db_url", "mysql://ser:heslo@127.0.0.1:3306/ser")
...

If set to 1 callbacks to registrar/jabber will be used, if set to 0 callbacks will not be used, thus it will work only with published information.

Default value is 1.

If set to 1 PA module will accept internal subscriptions via Querry Status API otherwise not. Set this to 1 if you want RLS module to be using internal subscriptions to PA. You can't use presence B2B UA in this case!

Default value is 0.

Set this to 1 if you want to enable subscriptions to "presence.winfo" events. If set to 0, watcherinfo subscriptions are denied.

Default value is 1.

Set this to 1 if you want to use offline watcher info notifications. In such case can be watcher information stored in database and later dumped to presentity in watcher info notification, requires db_url to be set. See functions for example.

Default value is 0.

Expiration time of stored "offline watcher information" in seconds. After this time is the information removed from database.

Default value is 259200.

Number of seconds after which is triggered automatic cleanup of expired offline watcherinfo.

Default value is 3600.

This variable specifies authorization type for presence watchers (event package is “presence”). Value can be one of:

Default value is empty. In this case “implict” authorization is used with an error message.

This function processes SUBSCRIBE requests to "presence" and "presence.winfo" (see watcherinfo_notify parameter) events. It sets AVP named “subscription_status” according to status assigned by authorization (“active”, “pending”, “terminated”) or “error” if an error occurs.

Meaning of the parameters is as follows:

...
handle_subscription("registrar");
...
			

This function returns 1 if the target (using get_to_uid on current message) is online, -1 otherwise.

This function stores data about currently created subscription into database for later dumping in the form of watcherinfo notification. It should be called after handle_subscription during processing SUBSCRIBE request. As subscription status is stored value taken from AVP “subscription_status”.

This function tries to send stored watcherinfo data in in the context of existing watcherinfo subscription. It uses get_to_uid as target for notification. If there is no watcherinfo subscription to such presentity, no information is sent.

If the client responds with 2xx on generated NOTIFY request, the stored information is removed from database.

...
if (method=="SUBSCRIBE") {
	if (!t_newtran()) {
		sl_reply_error();
		break;
	};
	
	if (handle_subscription("registrar")) {; # uses uid from AVP (get_to_uid)
		if (@msg.event=~"presence\.winfo") {
			log(1, "subscription to watcherinfo\n");
			dump_stored_winfo("registrar", "presence");
			log(1, "OFFLINE AUTH: watcherinfo dumped\n");
		}
		else {
			if ((@msg.event=~"presence") && (%subscription_status=="pending")) {
				log(1, "pending subscription to presence\n");
				# if offline user and new "pending" subscription
				if (!target_online("registrar") && (@to.tag=="")) {
					log(1, "OFFLINE AUTH: storing for offline user\n");
					store_winfo("registrar");
				}
			}
		}
	}
	break;
};
...

This function reads and processes IM authorization data and returns 1 if message can be accepted by destination user. If there is no IM authorization document on given XCAP server, it returns 1 too (MESSAGE is enabled by default). If the sender is blocked by recipient rules, this function returns -1. For more details about authorization documents see MESSAGE authorization rules.

...
if (method=="MESSAGE") {
	if (authorize_message("http://localhost/xcap")) {
		if (!lookup("location")) {
			sl_reply("404", "Not Found");
			break;
		};
		if (!t_relay()) { sl_reply_error(); };
	}
	else {
		sl_reply("403", "Forbidden");
	}
	break;
}
...