jabberStandard Jabber module integrates XODE XML parser for parsing Jabber messages. That introduces a module dependency: expat library. Expat is a common XML library and is the fastest available for Linux/Unix, the second over all, after msxml library. It is integrated in most of well known Linux distributions. Daniel Mierla Copyright © 2003 FhG FOKUS
This is new version of Jabber module that integrates XODE XML parser for parsing Jabber messages. That introduces a new module dependency: expat library. Expat is a common XML library and is the fastest available for Linux/Unix, the second over all, after msxml library. It is integrated in most of well known Linux distributions.
1.2.1. SERi ModulesThe following modules must be loaded before this module:
The user must activate his Jabber account associated with his SIP id. For each other IM network on which he wants to send messages, he must set an account for that IM network. The gateway is not able to create new account in foreign networks, excepting local Jabber server. When you want to send a message to someone in other IM network, you must set the destination of the message according with the pattern corresponding to that IM network (see last part of Section 1.4, “Administator's Guide”). Sending a message to user@jabber.xxx.org which is in Jabber network, the destination must be: user<delim>jabber.xxx.org@jabber_alias. For someone who is in Yahoo network the destination must be: user@yahoo_alias NoteThe SER administrator have to set the Jabber transports for each IM network in order to be able to send messages to those networks. The alias of each IM network can be found out from SER admin. You cannot send messages from your SIP client to your associated Jabber account--is something like sending messages to yourself. NoteA more complete guide about SIMPLE2Jabber gateway can be found at SER Homepage. The part below will be removed soon, only the manual from web will be updated. The Jabber server setup is not a subject of this guide. Check http://www.jabber.org for that. Useful scripts, for creating Jabber Gateway database, or for managing the Jabber accounts form web are located in 'doc' subdirectory of the module. Main steps of using the Jabber gateway:
The administrator of SER/Jabber gateway must inform the users what are the aliases for Jabber/Other IM networks. Other IM systems could be AIM, ICQ, MSN, Yahoo, and so on. These aliases depend on the server hostname where runs SER and how local Jabber server is setup. Next is presented a use case. Prologue:
The aliases for other IM networks must be the same as JID set in Jabber configuration file for each IM transport. The JIDs of Jabber transports must start with the name of the network. For AIM, JID must start with "aim.", for ICQ with "icq" (that because I use icqv7-t), for MSN with "msn." and for Yahoo with "yahoo.". The gateway needs these to find out what transport is working and which not. For our use case these could be like "aim.server.org", "icq.server.org", "msn.server.org", "yahoo.server.org". It is indicated to have these aliases in DNS, thus the client application can resolve the DNS name. Otherwise there must be set the outbound proxy to SER server. *** Routing rules for Jabber gateway First step is to configure SER to recognize messages for Jabber gateway. Look at "doc/xjab.cfg" to see a sample. The idea is to look in messages for destination address and if it contains Jabber alias or other IM alias, that means the message is for Jabber gateway. Next step is to find out what means that message for Jabber gateway. It could be a special message what triggers the gateway to take an action or is a simple message which should be delivered to Jabber network (using the method "jab_send_message"). The special messages are for:
The destination address must follow the following patterns:
Note"jabber_alias" is the first part of "jdomain". SQL URL of database. Default value is "mysql://root@127.0.0.1/sip_jab". IP or hostname of Jabber server - it must be the same as the value from <host> tagi of Jabber server config file. Default value is "127.0.0.1". Port number of Jabber server. Default value is 5222. Format: jabber.sipserver.com=<delim>. If the destination is for Jabber network the URIi should be like: username<delim>jabber_server@jdomain or nickname<delim>roomname<delim>conference_server@jdomain <delim> must be a un-reserved character. By default this character is * . The destination will be transformed to username@jabber_server or roomname@conference_server/nickname before the message is sent to Jabber server. Default value is none. Aliases for IM networks. Format: "N;alias1=<delim1>;...;aliasN=<delimN>;" Destinations like '*@aliasX' could have other format than those specified for Jabber network. All <delim> from user part of the destination address will be changed to <delimX> if the destination address contains <aliasX>. (Ex: jdomain is 'jabber.x.com=*' and msn_alias is 'msn.x.com=%'. The destination address forM MSN Network, on SIP side, is like 'username*hotmail.com@msn.x.com'. The destination address will be transformed to 'username%hotmail.com@msn.x.com'. 'msn.x.com' must be the same as the JID associated with MSN transport in Jabber configuration file (usually is 'jabberd.xml')) Default value is none. Outbound proxy address. Format: ip_address:port hostname:port All SIP messages generated by gateway will be sent to that address. If is missing, the message will be delivered to the hostname of the destination address Default value is none. The address in whose behalf the INFO and ERROR messages are sent. Default value is "jabber_gateway@127.0.0.1". Number of workers. Default value is 2. Maximum jobs per worker. Default value is 10. Cache time of a Jabber connection. Default value is 600. Time to keep a SIP message (in seconds). Default value is 90 seconds. Time between expired Jabber connections checking (in seconds). Default value is 20 seconds. Converts SIP MESSAGE message to a Jabber message and sends it to Jabber server. Join a Jabber conference--the nickname, room name and conference server address should be included in To header as: nickname%roomname%conference_server@jdomain . If the nickname is missing, then the SIP username is used. Leave a Jabber conference--the nickname, room name and conference server address should be included in To header as: nickname%roomname%conference_server@jdomain . Register to the Jabber server with associated Jabber ID of the SIP user. |
Navigation |
||||