CNS DOCWEB Home
CNS Home Page
CNS Publications Page
Search All CNS Docs

DOCWEB Logo PDF Available

Secure Instant Messaging at UF: Openfire Multiprotocol Jabber Server

CNS Document ID: D0211
Last Updated: 03/31/2008

Abstract

Jabber is an open, XML-based protocol for instant messaging which allows you to "chat" in real time with others.

CNS provides a Jabber instant messaging server called Openfire. One of Openfire's features is support for Instant Messaging Transports that provide connectivity to multiple external Instant Messaging services such as AOL Instant Messenger, Yahoo Instant Messaging, MSN/Windows Live Messaging, ICQ, and Google Talk messaging (still in beta at this writing).

The Openfire Jabber server allows you to consolidate the use of all of your IM clients into a single Jabber-compatible client.

This also provides a higher degree of security to the end user, since you can connect to the CNS server using an SSL secured connection. Messages sent from the CNS server to IM servers are also secured using SSL as well, so traffic streams in both directions are encrypted.


UF Computing & Networking Services

CNS Information Services

2124 NE Waldo Rd, Suite 2100

Gainesville Florida  32609-8922
(352) 392.2061


Table of Contents

User Documentation for the Openfire Jabber server
What is it?
What software do I need to use it?
Getting Started
Non-client specific configuration information
Exodus
Configuring Exodus with your account information
Connecting to an instant messaging transport using Exodus
How to add a buddy who uses another instant messaging service
Removing a transport or service
Connecting to UF Jabber conference rooms
Psi
Configuring Psi with your account information
Connecting to the server
Connecting to an instant messaging transport using Psi
How to add a buddy who uses another instant messaging service
Removing a transport or service
Connecting to UF Jabber conference rooms
Gaijm
Configuring Gaijm with your account information
Connecting to an instant messaging transport using Gaijm
How to add a buddy who uses another instant messaging service
Connecting to UF Jabber conference room
Spark
Configuring Spark with your account information
Connecting to an instant messaging transport using Spark
How to add a buddy who uses another instant messaging service
Removing a transport or service
Connecting to UF Jabber conference room

User Documentation for the Openfire Jabber server

What is it?

Jabber is an open, XML-based protocol for instant messaging. This means you can log in and "chat" in real time with others who have the software.

In the Spring of 2008, CNS implemented a new Jabber instant messaging server called Openfire. One of Openfire's features is support for Instant Messaging Transports that provide connectivity to multiple external Instant Messaging services such as AOL Instant Messenger, Yahoo Instant Messaging, MSN/Windows Live Messaging, ICQ, and Google Talk messaging (still in beta at this writing).

The Openfire Jabber server allows you to consolidate the use of all of your IM clients into a single Jabber-compatible client.

This also provides a higher degree of security to the end user, since you can connect to the CNS server using an SSL secured connection. Messages sent from the CNS server to IM servers are also secured using SSL as well, so traffic streams in both directions are encrypted.

When you register to use a messaging transport (IM client), the userid and password for that instant messaging service are stored in encrypted form on the UF jabber server. When you delete or remove the transport from the jabber client , these IM-based credentials are removed from the server as well.

However, please note that nicknames in conference rooms are not anonymous on this system. Anyone can look up a nickname and discover the Gatorlink userid associated with it.

What software do I need to use it?

There are many jabber clients available that support this new technology. We've configured and tested four of the most common ones: Exodus, Psi, Gajim, and Spark.

Any regular Jabber-compatible client may be used with the UF server. However, some popular clients, such as Pidgin, may not offer support for the instant messenger transports that are available on the server. However, they may be used to communicate with any other UF person using a Jabber-compatible client.

Getting Started

The rest of this document will show you how to configure and get started using each of the four jabber clients listed above: Exodus, Psi, Gajim, and Spark. All are currently free to download and use. You will find a url at the beginning of each section to indicate where you can find and download that client. We do not recommend one client over another in particular - they are listed in the order tested.

Non-client specific configuration information

For most clients, your userid/screen-name and your password is all that you need to configure them.

Please enter your GatorLink email address as your userid or screen-name if possible, in the form of:

gatorlinkuserid@ufl.edu

If you're not allowed to enter the "@ufl.edu" after your userid, then you will need to enter a domain or server value. This should be:

ufl.edu

The domain name server (DNS) will then point the client to the appropriate server address.

Exodus

http://code.google.com/p/exodus/

Configuring Exodus with your account information

When Exodus runs for the first time, it starts the New User Wizard. We recommend canceling out of this wizard because it fails during the "registration" process. Since you already have an existing account on the server (your GatorLink account), registration is not necessary.

Figure 1. Cancel out of this wizard

Cancel out of this wizard

Creating a new profile

  1. Click on the "Create a New Profile" item at the bottom of the window, or go to File, My Profiles, Create a New Profile.

  2. Call your profile anything you'd like. In the example, we just call it "default".

  3. Sometimes the first screen you see is the "default profile Details" screen. If this is the case, just proceed from this point in the instructions.

  4. 4. On the Account Details tab, specify your userid as:

    Jabber ID: gatorlinkuserid@ufl.edu

  5. Uncheck "This is a new account" and "Save password".

  6. Click on Connect.

  7. Enter your GatorLink password.

  8. If you are asked to enable a plug-in for message logging, click on OK. Then,

    1. Go to Options

    2. Select Settings

    3. Select Plug-ins

    4. Place a check next to "ExHTMLLogg... Save chat message history"

    5. Click OK

Connecting to an instant messaging transport using Exodus

We use AOL Instant Messenger (AIM) in this example, but it's the same procedure for other instant messaging services.

  1. Click on the Jabber browser icon in the toolbar.

    Figure 2. The Exodus Jabber Browser window

    The Exodus Jabber Browser window
  2. Right click on the transport that you want to use, and choose "Register".

  3. Click on Next.

  4. Enter your userid and password for the service selected.

  5. Exodus will automatically connect you to the service.

How to add a buddy who uses another instant messaging service

  1. Click on the People menu and choose Contacts, then Add Contact.

  2. Click on the pull down list next to Contact Type and choose the service that your buddy uses.

Removing a transport or service

  1. Right click on the transport or service under the Transports category.

  2. Choose Remove.

Connecting to UF Jabber conference rooms

There are two ways to connect to jabber chat rooms.

Method 1

  1. Click on the Jabber browser icon in the toolbar.

  2. Click on the "Public Chat rooms" icon.

  3. A list of available chat rooms will display. Right click on the one you want and choose "Join Conference".

Method 2

  1. Click on the "Join a Conference" icon in the toolbar.

  2. If you know the name of the room that you want to join, pull down the Conference Room Server box and choose the conference.ufl.edu server, then type in the name of the room you want to join under "Conference Room Name". Enter a password if required, and choose Finish.

  3. If you don't know the name of the room, click on "Browse servers for a conference room to join", then click on Next. A listing of conference rooms will appear. Click on the one you want to join, then press Finish.

    Figure 3. A typical chatroom in Exodus

    A typical chatroom in Exodus

Important

Nicknames are not anonymous. Anyone connected can query a nickname and get the GatorLink userid of the participant.

Creating a new UF conference room

  1. Click on People, then choose Conference, and click on "Join/Create a Conference Room".

  2. Click on the pull-down box next to Conference Room Server and click on "conference.ufl.edu".

  3. Enter a room name (and a password if you want to keep the room private), then click Finish.

The room configuration screen will appear - in most cases, you can accept the defaults and choose OK.

If you click on the "Perisistent" option on the room configuration screen, the room will remain active on the server even with no participants present. This option should only be used for rooms that have regularly scheduled use.

Removing a permanent room from the server

  1. Open a window connected to the room.

  2. Right click in the message window

  3. Choose Admin, then click on Destroy Conference Room.

Psi

http://psi-im.org/

Configuring Psi with your account information

When Psi runs for the first time, it displays the New User Wizard. Choose "Existing Account" instead of "Register" when you encounter the setup wizard (i.e. your GatorLink account already exists in the system).

  1. You can call the profile anything you'd like. We use the value "Default" in this example. Uncheck the "Register New Account" checkbox - GatorLink accounts are already registered with the server.

  2. For the Jabber ID field, please enter your GatorLink account address in the form of: gatorlink_userid@ufl.edu

  3. You do not have to enter your GatorLink password here - if you leave it blank, you'll be prompted to enter your password when you connect to the server. Please note that the "Change password" button has no effect - GatorLink passwords must be changed through the http://my.ufl.edu website.

  4. Click on Save to save your settings.

Connecting to the server

Change the status at bottom of the Psi window from Offline to Online.

Connecting to an instant messaging transport using Psi

  1. Go to the General menu and choose "Service Discovery". This will produce a list of transports that are available on the server.

  2. Right click on the desired transport and choose Register.

  3. Enter the userid and password that you use to connect to that instant messaging service.

  4. Click on the Register button to save the information.

How to add a buddy who uses another instant messaging service

  1. Enter the userid for that service, then click on the "Get Jabber ID" button.

    The client will automatically fill in the Jabber ID box. It should be in the form of:

    your-friend's-userid@transportname.ufl.edu

    You can make the nickname whatever you wish - this is the name that will appear in your buddy list.

    If you want to add this person to a specific group category (Buddies, Friends, Family, etc), pull down the Group list and choose the group that you want this person to appear in.

  2. Click on Add to save the information.

Removing a transport or service

  1. Expand the Agents/Transports item in the main window, if it's not already showing the transports you're subscribed to.

  2. Right click on the transport and choose Remove.

Connecting to UF Jabber conference rooms

  1. Go to the General menu and choose "Service Discovery".

  2. Click on "Public Chatrooms". If you expand "Public Chatrooms" (click on the + symbol to expand the list), you'll see a list of all current publicly available rooms.

  3. Right click on a room and choose Join. Enter a nickname (usually your GatorLink userid).

    Important

    Nicknames are not anonymous. Anyone connected can query a nickname and get the GatorLink userid of the participant.

To create a new UF chat room

  1. Click on General and choose "Join Groupchat".

  2. Enter a room name.

  3. Enter your nickname.

    Important

    Nicknames are not anonymous. Anyone connected can query a nickname and get the GatorLink userid of the participant.

  4. Enter a password if you want the room to have restricted access.

  5. Click Join to create the room.

Gaijm

http://www.gajim.org/

Note

If you are using Windows, download the Windows Gajim installer with GTK+ included.

Configuring Gaijm with your account information

When you run Gaijm for the first time after installing it, the new account wizard will automatically appear.

  1. Choose "I already have an account I want to use" - your GatorLink account is already registered with the server. Click on the Forward button to continue.

  2. In the Username field, enter your GatorLink userid without the "@ufl.edu" suffix.

  3. In the Server field, enter "ufl.edu"

  4. You do not have to enter your password - leave this box blank, then click on Forward.

  5. Check the "Connect when I press Finish" option, then click on the Finish button to save your settings.

Connecting to an instant messaging transport using Gaijm

  1. Click on the Actions menu and choose "Discover Services". A list of transports will appear.

  2. Choose the transport that you want to use by clicking on it once to highlight it, then click on the Register button at the bottom.

  3. Enter the username and password that you use for the service, then click on OK.

  4. Gajim will automatically connect you to the service.

How to Remove a Transport

  1. Right click on the icon for the IM transport

  2. Select “Remove from Roster

How to add a buddy who uses another instant messaging service

  1. Click on the Actions menu and choose "Add Contact".

  2. On the "Add New Contact" dialog box, pull down the protocol box and choose the service that your buddy uses.

Connecting to UF Jabber conference room

  1. Click on the Actions menu and select Discover Services

  2. Double-Click on Public Chatrooms.

  3. A list of publicly available rooms will appear. Click on the one that you want to join, then click on the Join button.

  4. Confirm the information presented (enter a password required to enter the room if it has one), then click on Join to enter the room.

To create a new UF conference room

  1. Click on the Actions menu, move down to "Group Chat", then choose "Join New Group Chat".

  2. Enter the room name as: room_name@conference.ufl.edu

  3. Enter a password if you want to password restrict the room.

  4. Click the Join button.

  5. The Room Configuration screen will appear. In most cases, you can simply accept default values and choose OK.

    Note

    if you want to change a configuration option after closing the configuration screen, it can be found under the Actions button in the chat window.

If you choose the "Room is Persistent" option, the room will persist on the server after the last person leaves. This option should only be used for rooms that will be staffed during a reoccurring time period.

Removing a permanent room

  1. Open a chat window connected to the room.

  2. Click on the Actions button and choose Configure Room.

  3. Uncheck the option next to "Room is Persistent".

  4. Click on OK to save changes.

  5. Exit the room. It will destroy itself when the last person exits.

Spark

http://www.igniterealtime.org/projects/spark/index.jsp

Configuring Spark with your account information

  1. Enter your GatorLink userid without the "@ufl.edu" suffix.

  2. Enter your password.

  3. Enter the server address: ufl.edu

Connecting to an instant messaging transport using Spark

Spark will automatically query the server looking for transports when it connects. They will appear as icons in the toolbar.

  1. Right click on an icon for the service that you want to use and choose "Enter login information".

  2. Enter your userid and password for the service.

  3. Click on Save.

Spark will connect you to the service automatically.

How to add a buddy who uses another instant messaging service

  1. Click on the Contacts menu and choose Add Contact.

  2. Check the "User is on a public network" box.

  3. Click on the pull down box next to "Network" and choose the instant messenger service that your buddy uses.

  4. Enter their Username in the top box, a nickname (optional), and a group to assign them to (optional). Click on Add to add them to your list.

Removing a transport or service

  1. Right click on the icon for the transport in the tool bar.

  2. Choose "Delete Login Information" from the menu.

Connecting to UF Jabber conference room

  1. Click on the Conferences tab at the bottom of the screen.

  2. Double click on the server listed (conferences.ufl.edu)

  3. Choose the room that you want to join (if one already exists) and choose Join Selected Room.

To create a new UF conference room

  1. Click on the Conferences tab at the bottom of the screen.

  2. Double click on the server listed (conferences.ufl.edu)

  3. Click on Create or Join Room.

  4. Enter a room name and topic.

  5. Click on Create.

Warning

If "Room is Permanent" is checked, it will persist on the server after the last person leaves. This option should only be used for rooms that will be staffed during a reoccurring time period.

To remove a room that was accidentally created as "Permanent"

Note

Note: You can only remove rooms that you created.

  1. Open a chat window in the room.

  2. Right click in the left side window where messages appear. Choose "Destroy Room".

  3. Answer Yes to confirm. Enter a reason and click OK.

Your Comments are Welcome

We welcome your comments and suggestions on this and all CNS documentation. Please send your comments to:

UF Computing & Networking Services
2124 NE Waldo Rd, Suite 2100
Gainesville, Florida 32609-8922

Phone: (352) 392.2061
E-mail: editor@cns.ufl.edu

CNS DOCWEB Home
CNS Home Page
CNS Publications Page
Search All CNS Docs