Gateway

From PsiWiki

Jump to: navigation, search


Contents

[edit] About Gateways

Gateways, also known as Transports, are Jabber components used for interacting with proprietary networks (instant messenger networks, SMS etc.).

Typically, gateways are used as translators between different types of instant messengers. If you are using Jabber but a friend uses MSN you can use a MSN gateway that will allow you to send messages to, and chat with, your friend on MSN.

You can choose whether or not to display gateways on your roster by clicking the gateway icon at the top of the roster. By displaying the gateways, as with your contacts, you can view the status of a gateway - if a gateway is offline the contacts in your roster for whom that gateway applies will appear as offline also. For example, if the MSN gateway is offline, your MSN contacts will appear as offline as well.

[edit] Connecting to the proprietary network

  1. Before you can use a gateway you must have an account with the selected IM. For example if you want to communicate with friends on MSN you must have created an account on the MSN website. The advantage of using Psi is that it can communicate with all of the major IM networks in one place.
  2. If you are on a server that provides a gateway you just need go to the next step. If your server does not provide the gateway you need you have to search for a different server, that provides the gateway and allows users who are not using this server to register. Many servers block users from other servers and very often Google accounts are blocked especially. Look e.g under [1] for a server that has a coloured icon for your needed gateway.
  3. You have to browse using Service Discovery to the server which hosts your Gateway. You may want to enter the address of a different server to get access to different gateways. If you use gateways only on your server, you just need to open Service Discovery and they will come up right away in the window, without modifying the address in the address bar.
  4. You need to let the gateway know your username and password for the proprietary network. This is done through a process called registering with the gateway. Once you have registered with the gateway, the contacts from the proprietary network should be pushed to your roster, if the gateway is functioning right.

[edit] How does a gateway work

The gateway (transport) functions like this:

  1. you log into the Jabber account
  2. the server sends your presence info to anyone in your roster (contact list) (this includes Gateways, which are just normal contacts, only displayed differently)
  3. once a gateway receives the presence information it logs into the proprietary network (only if you are registered with the transport)
  4. the gateway sends to your server the presence information of all the gateway contacts

The easiest way to not make the transport log automatically, is to remove authorization (Right click on the transport > Authorization > Remove authorization from). This will save you from entering registering the transport over and over again. You'll have it registered, but "blind", since you've removed its authorization and it won't receive any presence information from you (=it won't see you).

[edit] Connecting to an IRC Network

  1. Perform a Service Discovery.
  2. Register with the IRC protocol.
  3. Bring up the Multi User Chat dialogue.
  4. Your hostname is that of the transport you have registered.
  5. The room name is entered in one of the forms:
    1. room%server.domain.tld (for ejabberd's irc gateway)
    2. #room%server.domain.tld (for pyirct ad-hoc server connections)
    3. #room%serveralias (for pyirct pre-registered server connections).
  6. If you're using ejabberd's irc gateway, your nickname cannot be changed using the normal IRC /nick command once connected so choose it carefully if you have not registered the name previously.
  7. If your nickname has been registered previously nickserv will contact you. Simply type "identify password" in a message to it in order to identify yourself.

Once connected you will receive server messages in new windows, these hosts will appear as temporary contacts in your roster. After a short period of time, dependant on the IRC server to which you are connecting, the requested room will open in a new window.

[edit] Frequently Asked Questions

We have a special section on the FAQ Page about Gateways. Make sure you check it out.

[edit] Gadu-Gadu users

Please check this Forum topic for more help on setting up a Gadu-Gadu gateway.

[edit] FAQ

TODO: some of the behaviour described in the FAQs could/should be imported/copied in this page

[edit] Useful links

Retrieved from "http://psi-im.org/wiki/Gateway"
Personal tools