Différences

Ci-dessous, les différences entre deux révisions de la page.

@@ Ligne 1: / Ligne 1: @@
+====== Passerelles pour serveur jabber  ======
+===== Introduction =====
+Les passerelles vous permettent de vous connecter à d’autres réseaux de messagerie instantanée depuis jabber.
+L'avantage de Jabber (xmpp) est sa flexibilité, il permet de discuter avec des gens qui sont inscrits sur d’autres protocoles comme MSN, TWITTER, ICQ, Yahoo!, AIM, IRC, etc. Il suffit d’utiliser une passerelle associée à un serveur. Comme serveur jabber, nous utilisons ejabberd.
+===== Information =====
+Les passerelles sont un moyen très pratique de communiquer avec des personnes connectées sur d’autres réseaux de messagerie instantanée. Par contre, elle ne permettent pas d’utiliser **toutes les fonctionnalités de ces réseaux**. Par exemple, il n’est pas toujours possible d’échanger des fichiers, de démarrer des sessions de vidéoconférence ou de voir les avatars des personnes connectées aux autres réseaux.
+===== Quel client utliliser ? =====
+Beaucoup de clients permettent une inscription sur ces passerelles.
+Pour profiter pleinement de vos autres messageries, il est préférable d'utiliser
+**un client multiprotocole**.
+Voici un site qui recense de nombreux clients : [[http://wiki.jabberfr.org/Clients|Cients]]
+Je vous propose une petite liste :
+^Gnu/Linux^Windows ^Mac OS X^
+|Empathy|Trillian |iChat|
+|Coccinella|Coccinella|Coccinella|
+|Pidgin    |Pidgin     |Instantbird|
+|Instantbird|Miranda   |Adium|
+|Jitsi      |Jitsi     |Jitsi|
+===== Installation de Spectrum =====
+La documentation officielle : [[http://spectrum.im/projects/spectrum/wiki|Spectrum]]
+Spectrum est une passerelle vers d'autres protocoles, cela permet de centraliser l'ensemble de ses comptes sur un seul compte.
+**Nous allons installer Spectrum sur une debian squeeze.**
+Ajouter le dépôt Spectrum au fichier /etc/apt/sources.list
+  deb http://packages.spectrum.im lenny spectrum
+Ajout de la clé GPG du dépot :
+  wget -O – http://packages.spectrum.im/keys/apt-repository@fsinf.at | apt-key add -
+Installation du paquet Spectrum :
+  apt-get update
+  apt-get install fsinf-keyring
+  apt-get update
+  apt-get install spectrum libpurple0-minimal
+===== Configurer les passerelles =====
+Il suffit de créer un fichier par passerelle dans le dossier /etc/spectrum.
+Pour configurer notre fichier, nous utilisons le fichier exemple.
+**Les fichiers possèdent une extension en .cfg**
+Nous allons mettre en place une **passerelle MSN**, sûrement l’une des plus utilisée.
+Créons le fichier msn.cfg :
+<code>
+[service]
+# enable this spectrum instance
+enable=1
+# one of: aim, facebook, gg, icq, irc, msn, myspace, qq, simple, xmpp, yahoo
+protocol=msn
+# component ip
+server=127.0.0.1
+# if use_proxy is 1, the http_proxy env var will be used as the proxy server
+# for example export http_proxy="http://user:passwd@your.proxy.server:port/"
+use_proxy=0
+# component JID
+jid=$protocol.mdl29.net
+# component secret
+password=pwdmsn
+# component port
+port=5203
+config_interface = /var/run/spectrum/$jid.sock
+# IP:port where filetransfer proxy binds to. This has to be public IP.
+filetransfer_bind_address=jabber.mdl29:12345
+# IP:port which will be sent in filetransfer request as stream host.
+#filetransfer_public_address=192.0.2.1:12345
+# admin JIDs - Jabber IDs of transport administrators who have access to admin adhoc commands
+# separated by semicolons
+admins=jabbermdl@mdl29.net
+# directory where downloaded files will be saved
+filetransfer_cache=/var/lib/spectrum/filetransfer_cache
+# URL used to acces filestransfer_cache directory from the web.
+#filetransfer_web=http://example.com/files/
+# if filetransfer_force_cache_storage is 1, files received from legacy networks
+# are always stored on server and link is sent to XMPP user
+#filetransfer_force_cache_storage=0
+# name of transport (this will appear in service discovery)
+name=Passerelle msn
+# default language
+language=fr
+# transport features separated by semicolons
+# combination of: avatars, chatstate, filetransfer
+# if commented, all features will be used
+# This variable is DEPRECATED and will be removed in future versions. Use [features] instead.
+#transport_features = avatars;chatstate;filetransfer
+# if vip_mode is 1, users are divided to 2 groups according to 'vip' database field
+vip_mode=0
+# if vip_mode is 1, you can set transport to be availabe only for VIP users by setting only_for_vip to 1.
+only_for_vip=0
+# if vip_mode is 1 and only_for_vip is 1, users can connect from these servers even they are not VIP.
+# This feature is useful, if you want to enable transport only for users from your server, but also want
+# to give access to VIP users from other servers (for example from GTalk)
+# seperated by semicolons
+#allowed_servers=localhost
+# transport features separated by semicolons which will be used for VIP users.
+# combination of: avatars, chatstate, filetransfer
+# if commented, all features will be used
+# This variable is DEPRECATED and will be removed in future versions.  Use [vip-features] instead.
+#vip_features = avatars;chatstate;filetransfer
+# pid file
+pid_file=/var/run/spectrum/$jid.pid
+# require_tls to connect legacy network
+#require_tls=false
+# Eventloop used by Spectrum. Allows to change default use of poll to epoll,
+# which should be faster and handles more connections better.
+# WARNING: some 3rd party libpurple protocol plugins are not prepared to be
+# used with different eventloop, but protocols included in libpurple by default
+# works OK.
+#eventloop=glib
+[registration]
+# Set to 0 to disable transport registration to everyone except
+# people from host from allowed_servers list.
+#enable_public_registration=1
+# You can override username registered by transport user. This is useful
+# for example if you want to let users to register only their Facebook name
+# and internally connect them to facebook_name@chat.facebook.com.
+# $username variable is replaced by username which has been registered
+# by particular user.
+#username_mask = $username@chat.facebook.com
+# This option allows you to white-list newly created accounts according
+# to regexp. for example allowed_usernames=*.\.gmail\.com$ will allow only
+# GTalk users to register. If you use username_mask, then username_mask is
+# applied before this option.
+#allowed_usernames=regexp
+# Label used to described username field in registration form
+#username_label = Facebook username
+# This variable overrides default instructions text in registration form.
+#instructions = Type your Facebook name here:
+# Transport features, all features are enabled by default.
+[features]
+#filetransfer=1
+#avatars=1
+#chatstates=1
+#statistics=1
+# Transport features for VIP users, all features are enabled by default.
+[vip-features]
+#filetransfer=1
+#avatars=1
+#chatstates=1
+[logging]
+# log file, needs to be unique for each spectrum instance
+log_file=/var/log/spectrum/$jid.log
+# log areas
+# combination of: xml, purple
+log_areas=xml;purple
+[database]
+# mysql or sqlite
+type=sqlite
+# hostname (not needed for sqlite)
+#host=localhost
+# username (not needed for sqlite)
+#user=user
+# password (not needed for sqlite)
+#password=password
+# sqlite: set path to database file here
+# mysql: set to name of database
+database=/var/lib/spectrum/$jid/database.sqlite
+# table prefix for multiple transport instances sharing the same database
+#prefix=icq_
+[purple]
+# avatar, vcard, roster storage
+# needs to be unique for each spectrum instance
+userdir=/var/lib/spectrum/$jid/userdir
+port=80
+http_method=1
+</code>
+**Explications**
+   ***protocol=**  on choisit quel protocole on souhaite utilser, ici c'est msn
+   ***server=**    on laisse l'adresse locale
+   ***jid=**       ajoutons notre nom de domaine
+   ***password=**  mot de passe utilisé lors de la connexion ejabberd et spectrum
+   ***port=**      le port de connexion entre ejabberd et spectrum
+   ***filetransfer_bind_address=** port utilisé pour le transfert de fichiers
+   ***name=**      nom de la passerelle
+   ***language=**  on définit en fr
+   ***[purple]**   ici on spécifie les paramètres spécifiques à msn
+ Par défaut, msn se connecte sur le port 1863.
+ Nous utiliserons une connexion par la méthode HTTP (port=80, http_method=1)
+On change les droits du fichier msn.cfg
+  cd /etc/spectrum
+  chown root:spectrum msn.cfg
+  chmod o-rwx msn.cfg
+Démarrons Spectrum :
+  /etc/init.d/spectrum start
+**Si vous avez plusieurs fichiers .cfg, il est possible de les démarrer ou arrêter
+ séparemment.
+**
+  spectrumctl -c msn.cfg start
+  spectrumctl -c msn.cfg stop
+Une fois Spectrum correctement lancé , nous allons modifier la configuration de notre
+serveur jabber.
+===== Configurer ejabberd =====
+Avant d'effectuer toutes modifications, nous arrêtons notre serveur :
+  /etc/init.d/ejabberd stop
+Pour rappel, le fichier de configuration se trouve dans /etc/ejabberd/ejabberd.cfg
+Ajoutons les lignes suivantes :
+<code>
+%%Passerelle msn
+{{5203, "127.0.0.1"}, ejabberd_service, [
+                                        {access, all},
+                                        {host, "msn.mdl29.net", [{password, "pwdmsn"}]}
+]},
+</code>
+Redémarrons le serveur :
+  /etc/init.d/ejabberd start
+On verifie que le serveur est bien lancé :
+  ejabberdctl status
+Voilà, votre passerelle msn est opérationnelle :)