186 lines
7.0 KiB
HTML
186 lines
7.0 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
|
|
<TITLE>Jabber Tutorial</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>Jabber on SDF</H1>
|
|
<P>Jabber is the former name for the Extensible Messaging and
|
|
Presence Protocol (XMPP), which is a set of open XML <A HREF="http://xmpp.org/tech/" TARGET="_blank">technologies</A>
|
|
for presence and real-time communication developed by the <A HREF="http://xmpp.org/about/jabber.shtml" TARGET="_blank">Jabber</A>
|
|
open-source community in 1999, formalized by the <A HREF="http://www.ietf.org" TARGET="_blank">IETF</A>
|
|
in 2002-2004, continuously extended through the standards process of
|
|
the <A HREF="http://xmpp.org/xsf" TARGET="_blank">XMPP
|
|
Standards Foundation</A>, and implemented in a wide variety of
|
|
<A HREF="http://xmpp.org/software" TARGET="_blank">software</A>,
|
|
devices, and Internet services. Jabber service on SDF is run on
|
|
<A HREF="http://www.process-one.net/en/ejabberd" TARGET="_blank">ejabberd</A>.</P>
|
|
<P>Jabber is popularly used as a decentralized instant messaging
|
|
service. This means that you can create an account on one server such
|
|
as SDF and talk to users from any other Jabber service. It is also
|
|
possible to use a transport to communicate with users on other types
|
|
of instant messaging services as well.</P>
|
|
<H3>Connection Settings for SDF's Jabber Server</H3>
|
|
<P>Server: <b>jabber.sdf.org</b>
|
|
<br>Port: <b>5222</b>
|
|
<br>SSL: <b>enabled</b></p>
|
|
<P>SDF's Jabber server uses a self-signed SSL certificate, so you
|
|
will see a warning about this. It is safe to accept this certificate.</P>
|
|
<H2>Jabber Clients</H2>
|
|
|
|
Available on SDF:
|
|
<UL>
|
|
<LI><A HREF="http://developer.pidgin.im/wiki/Using%20Finch">finch</A>
|
|
(Unix shell)
|
|
</UL>
|
|
Others:
|
|
<UL>
|
|
<LI>iChat (Mac OS X)
|
|
<LI><A HREF="http://pidgin.im">Pidgin</A>
|
|
(Unix/Windows)
|
|
<LI><A HREF="http://adium.im">Adium</A>
|
|
(Mac OS X)
|
|
<LI><A HREF="http://www.bitlbee.org">Bitlbee</A>
|
|
</UL>
|
|
Some clients for mobile can be found <a href="http://sdf.org/?tutorials/mobile">here</a>
|
|
|
|
<H3>Account Registration in SDF's Jabber server
|
|
</H3><p>This is not needed if you are going to connect to a Jabber/XMMP
|
|
server than SDF's Jabber server.</p>
|
|
<p>In contrast with other Jabber servers, accounts in SDF's Jabber server are created from the shell with the 'maint' utility.
|
|
<ol>
|
|
<li>Log in to the password server by running the <b>maint</b> program.
|
|
<li>Type <b>o</b> to select optional features and social networking
|
|
<li>Type <b>j</b> to set your Jabber password.
|
|
<li>Quit from maint utility and wait one minute.
|
|
</ol>
|
|
After one minute you will be able to connect to SDF's Jabber server using your prefered Jabber client.</p>
|
|
|
|
<H3>Connecting with Finch from Unix shell</H3>
|
|
<p>This steps are valid to connect to SDF's Jabber server or any other
|
|
Jabber/XMMP server like GTalk.</p>
|
|
<P>To move around Finch's fields and buttons use the <B>TAB</B> key.
|
|
You can learn more about using Finch <A HREF="http://developer.pidgin.im/wiki/Using%20Finch">here</A>.</P>
|
|
<UL>
|
|
<LI>Press <B>ALT</B> <B>+ a </B>and
|
|
select <B>Accounts</B>
|
|
<LI>Select <B>Add</B> button to open
|
|
New Account dialog box
|
|
<LI>Choose <B>XMPP</B> as the protocol
|
|
<LI>Fill the appropiate field with you
|
|
desired <B>Username</B>
|
|
<LI>Fill the <B>Domain</B> with:
|
|
jabber.sdf.org
|
|
<LI><B>Save</B>
|
|
<LI>Now you just can select your newly created account from the
|
|
Accounts list to get connected to SDF's jabber server.
|
|
</UL>
|
|
<H3>Connecting with Pidgin from Unix/Windows
|
|
</H3>
|
|
<UL>
|
|
<LI>Go to <B>Accounts->Manage
|
|
Accounts</B>.
|
|
<LI>Click on <B>Add</B> button.
|
|
<LI>Select <B>XMPP</B> as <B>Protocol</B>.
|
|
<LI>Fill the appropiate field with
|
|
your desired <B>Username</B>.
|
|
<LI>Fill the <B>Domain</B> field with:
|
|
jabber.sdf.org
|
|
<LI><B>Click on Save</B> button.
|
|
</UL>
|
|
<P>After finishing this steps, Pidgin will try to connect to the
|
|
jabber server and will ask for your password (the one you have set up
|
|
with the <b>maint</b> utility),
|
|
also you will be warned about the self signed
|
|
certificate, it is safe to accept it.</P>
|
|
<h3>Add buddies in Finch</h3>
|
|
<p>
|
|
<ol>
|
|
<li>Select a group in the buddy list.
|
|
<li>Press <b>F11</b> to bring out the context menu
|
|
<li>Select <b>"Add Buddy"</b>.
|
|
</ol></p>
|
|
|
|
<h3>Using bitlbee</h3>
|
|
Read bitlbee's documentation for how to get the server up and running.
|
|
Then, to add SDF's jabber account:
|
|
<ol>
|
|
<li>Go to the &bitlbee channel in the server and register your user
|
|
<li>Run the following command in that channel: <b>account add account_name user@jabber.sdf.org [passwd]</b>
|
|
<li>Run: <b>account account_name on</b>
|
|
</ol>
|
|
|
|
Read the help of bitlbee's commands and add your contacts there.
|
|
|
|
<H3>Conferences</H3>
|
|
<P>Jabber allows you to talk to several users at
|
|
once in conferences. These are similar to com rooms or IRC
|
|
channels. The SDF jabber server has a "helpdesk" conference already
|
|
set up and you are free to create new conferences too.</P>
|
|
|
|
<H3>To join an existing conference using Pidgin</H3>
|
|
|
|
<UL>
|
|
<LI> Go to <b>Buddies</b>-><b>Join a Chat...</b>.
|
|
<LI> Select your jabber.sdf.org account in the <b>Account</b> drop-down
|
|
<LI> Click on the <b>Room List</b> button
|
|
<LI> Make sure the server to query is: conference.jabber.sdf.org
|
|
<LI> Click on the <b>Find Rooms</b> button
|
|
<LI> The Room List window will show all existing conferences along with
|
|
the number of users in each. Select the one you want (helpdesk, for
|
|
example) and click on the <b>Join</b> button.
|
|
</UL>
|
|
|
|
<p>By default you will not be notified of activity in conference
|
|
windows the same way you are when someone talks in a one-to-one chat
|
|
window. You can change this by going
|
|
to <b>Tools</b>-><b>Plugins</b>, selecting to configure <b>Message
|
|
Notification</b> and checking <b>Chat Windows</b> in the "Notify
|
|
For" section.
|
|
|
|
<H3>To create a new conference using Pidgin</H3>
|
|
|
|
<UL>
|
|
<LI> Go to <b>Buddies</b>-><b>Add Chat...</b>.
|
|
<LI> Select your jabber.sdf.org account and enter the desired room in
|
|
the <b>Room</b> field.
|
|
<LI> Click the <b>Add</b> button
|
|
<LI> The new conference will have appeared in your buddy list. Double
|
|
click on it to join it.
|
|
<LI> You will be prompted to configure your new room. Do so if you
|
|
wish, or accept defaults.
|
|
<LI> Invite other users to join your conference
|
|
through <b>Conversation</b>-><b>Invite...</b> or have them look in the
|
|
Room List as described above.
|
|
</UL>
|
|
|
|
<H3>Looking for Jabber users</H3>
|
|
|
|
<p>
|
|
The easiest way to find other SDF Jabber users is to visit the
|
|
conferences as described above. If you know that somebody uses the SDF
|
|
jabber server you can add them to your contact list directly by using
|
|
the address: <i>username</i>@jabber.sdf.org where <i>username</i> is
|
|
their SDF user name.
|
|
</p>
|
|
|
|
<p>
|
|
You can also use your SDF account to chat with people who have
|
|
accounts on other Jabber servers. Note that some people might call it
|
|
`XMPP' instead of `Jabber'. One of the largest Jabber servers is
|
|
Google Talk: you can chat to GMail/Google Talk users this way without
|
|
needing a Google account. The Jabber address of those users is the
|
|
same as their email address.
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
Created on Apr 18th by vosi & ecelis</br>
|
|
<p>
|
|
<cite>$Id: jabber.html,v 1.13 2019/12/02 16:13:22 thegiant Exp $</cite>
|
|
|
|
</BODY>
|
|
</HTML>
|