2. Instant message authorization documents

Instant message authorization document is XML document formated according to schema defined in [common auth]. It inherits MIME type of common policy documents defined there - application/auth-policy+xml.

All XML elements designed in this document belong to “urn:iptel:xml:ns:im-rules” namespace.

Note

This namespace breaks conventions mentioned in the document which was used as source but it will stay here due to compatibility reasons if there will be no problems with it.

2.1. Conditions

Conditions are processed according specification in [common auth].

2.1.1. Sphere

If the "instant messaging server" (proxy) trying to resolve authorization rules is bound together with presence server it can take the sphere value from presence server as defined in [presence auth], otherwise is sphere value considered undefined in terms of common policy processing.

2.2. Actions

This document defines one action - <im-handling>. It is defined an enumerated integer type (like sub-handling in [presence auth]). Possible values are:

block (value 0)

The message should not be delivered to the user and should be rejected with 403 Forbidden result code. This is the dafault value of im-handling.

allow (value 1)

The message should be delivered to the destination user.

In the future may these values change.

If there are more matching rules, the resulting action will be the maximum of their <im-handling> values.

2.3. Transformations

Transformations are not defined at this moment. In the future there can be for example length limitations or some flagging (like “spam”) or rate limitations.