Internal chat service

Instant messaging service using an open communications protocol (XMMP/Jabber). This service can be used from mobile devices or from multiple desktop client applications like Pidgin or Empathy, both from inside the CITIUS and from external networks. It can also be used with a web client.

All CITIUS users have this service available automatically. Username and password for this service are the same as the CITIUS credentials. If you don't remember them you can request a reactivation in citius.tic@usc.es

Pidgin configuration

If you are already using Pidgin for other accounts follow this instructions. If not, the first time you open Pidgin a wizard to add accounts will pop up and so the first two steps of this instructions can be skipped.

1. Access Accounts » Manage accounts.
2. In the new window press Add…
3. In the Basic tab, choose Protocol XMPP, Username your CITIUS username,Domain citius.usc.es,Resource Pidgin,Password your CITIUS password.
4. Finally, click Add and Close to return to the Pidgin main window.

If you get the Not authorized error it means that you didn't write your username or password correctly. Select Accounts and in your account the Edit account option. Correct the username/password info and click Save. Then enable the account in Accounts » Enable account » <Name of account>.

Empathy wizard configuration

A new account wizard will open the first time you use Empathy:

1. Choose Yes, I'll enter my account details now and click Forward.
2. As kind of chat account choose Jabber and put your CITIUS username( in this case as there is no place to indicate the domain the username has to be written as user.name@citius.usc.es) and password.
3. Click Apply.

If the wizard doesn't pop up:

1. Choose Edit » Accounts.
2. Click Add…
3. Do as indicated for the Wizard previously. User name also has to be written adding@citius.usc.es. If asked, you must answer Account already exists in server.
4. Click Initiate session.

If you receive the Authentication error message, probably your username and/or password are wrong. Click Edit, correct them and then click Apply.

Xabber configuration

Xabber is an open messaging client for Android. The first time you run it it will prompt you to add an account. Just put your user name and password and press Add account.

If it's not your first time, access Options pressing the Menu button (Android 2.x) or in the action bar (Android 3 and upper), choose XMPP accounts and press Add account.

Use the following data:

• Username and password: CITIUS credentials.
• Server: citius.usc.es
• Port: 5222
• Cypher: Not required but supports TLS.
• Legacy SSL : No

Pidgin certificate error

The SSL certificate is issued by TERENA. You must add the TERENA root certificate, the certification authority, to your instant messaging client, to avoid warning messages about the certificate validity.

This procedure differs among instant messaging clients and is not mandatory, so you can simply ignore the warning and trust the certificate.

For added security you can check that the certificate fingerprint is the same as the CITIUS web. Firefox has the correct root certificate, so it will report the certificate as good.

To have other contacts see your name instead of your Jabber address (JID) or have an avatar follow the next steps: To put a name and other optional details:

1. Go to Accounts » user.name@citius.usc.es/Pidgin(XMPP) » Set user info…
2. There fill in the data you wish to be public. Name to be seen by your contacts and Alias.
3. Finally, click Save.

To configure an avatar:

1. Click on the lower right small icon in the Buddy List icon and select a image file on your computer.

THe web client is in http://talk.citius.usc.es/ and doesn't require any additional port open so it can be used from networks that have limited connectivity, like wifi-usc.

There are two ways of doing file transfers: out of band, using a dedicated connection , or in band, using the messaging server to embed pieces of the files inside messages. The clients autonegotiate which method to use taking into account their capabilities and the network's.

The out of band method is more efficient and fast but forces clients behind a firewall to use a file transfer proxy. Inside the CITIUS network or using the VPN you can use the file transfer proxy proxy.citius.usc.es(note that its a JID and not a domain name).

To configure the file transfer proxy in Pidgin:

1. Choose Accounts » Manage accounts.
2. Choose your account and select Edit….
3. In the Advanced tab put proxy.citius.usc.es or citius.usc.es in the field File transfer proxies.