Difference between revisions of "Eng:J2J"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
(бррр...)
 
(46 intermediate revisions by 26 users not shown)
Line 1: Line 1:
'''<big>Transport J2J</big>'''
+
{{EnglishVersion|J2J}}'''<big>Transport J2J</big>'''
  
With this transport you can aggregate contacts from two (or more) jabber-accounts' rosters in single roster. E.g., you can communicate through your GTalk or LiveJournal account, using main account on jabber.org. For your interlocutors it will be seen as you logged in on this three-accounts manually. Thought actually Gtalk and LiveJournal will be connected through J2J transport.
+
With this transport you can aggregate contacts from rosters of two (or more) Jabber accounts in single roster. E.g., you can communicate through your GTalk or LiveJournal account, using main account on Jabber.org. For your interlocutors it will be seen as you logged in on this three-accounts manually. Though actually Gtalk and LiveJournal will be connected through J2J transport.
  
==Features==
+
== Features ==
* [[Gtalk]] support;
+
* [[:w:en:Gtalk|Gtalk]] support;
* [[LiveJournal]] support;
+
* [[:w:en:LiveJournal|LiveJournal]] support;
* [[SSL]] is not supported;
+
* [[:w:en:Secure_Sockets_Layer|SSL]] is not supported; <!-- feature? -->
* [[StartTLS]] support.
+
* [[:w:en:Transport_Layer_Security|StartTLS]] support.
  
==Using==
+
== Usage ==
For simplification of explanations we'll enter two concepts: master-account and guest-account. Master-account is account which will be register this transport, guest-account is account which will be used through J2J.
+
  
[[image:X2x-register.gif]]
+
[[image:X2x-register.gif|frame|J2J registration form]]
  
In the Username field you must enter username of guest account. Password is a password for guest-account. In the Server field you must enter just a hostname of your Jabber-server jabber.ru.
+
To make explanations smplier we'll introduce two main concepts: ''master Account'' and ''guest account''. ''Master account'' is that which will be register this transport, ''guest account'' is that which will be used through J2J.
  
Value of Port field doesn't follow for change. It must be used when Jabber-server running on non-standard port.
+
In the Username field you must enter username of guest account. Password is a password for guest account. In the Server field you must enter just a hostname of your guest Jabber server.
 +
 
 +
Value of Port field doesn't follow for change. It must be used when Jabber server uses non-standard port.
 
Because SSL doesn't supported, value 5223 is invalid.
 
Because SSL doesn't supported, value 5223 is invalid.
  
You will receive a subscription request after registration, you must accept it and wait for connection with guest-account. J2J will be online, when connection is established.
+
You will receive a subscription request after registration, you must accept it and wait for connection with guest account. When connection is established, J2J will be online.
  
There are protection from ring registrations on transport, however, it not recommended that you create such connections.
+
There are protection from ring registrations on transport, however, it isn't recommended to create such connections.
  
==Использование в случае GTalk-аккаунта==
+
== Using with Google Talk ==
Просто введите свой JID как обычно. [[GTalk]] аккаунт автоматически распознается и дополнительные функции будут доступны.
+
  
В опциях транспорта, которые открываются с помощью ad-hoc commands, появится дополнительная опция Light first mail-notify, которая означает, что первое уведомление о новой почте будет содержать только лишь количество новых писем.
+
Just enter your JID. Your Gtalk account will be recognized automatically, and the additional functions will be accessible:
  
=="Импорт контактов" из гостевого аккаунта==
+
Discover j2j -> Register -> fill form:
Если вы хотите получить контакты из гостевого аккаунта в ростере мастер-аккаунта, вы можете открыть диалог Discovery вашего jabber-клиента, найти в нем J2J транспорт, там уже открыть секцию Guest Roster и уже оттуда добавить нужные контакты. Добавление происходит путем использования правокнопочного меню или просто перетаскиванием (drag and drop доступен в [[Tkabber]] и [[JAJC]]).
+
* username: gmailuser
 +
* password: pass
 +
* sever: gmail.com
 +
* domain or ip: <nothing>
 +
* port: 5222
 +
... registration successful.
  
==Формат JID-ов==
+
... may j2j see your presence? y/n
При работе через транспорт адреса будут выглядеть следующим образом: JID из гостевого аккаунта, у которого вместо собаки знак процента @ название транспорта. Например, <tt>vasya%jabber.ru@xmpp.tushinec.ru</tt>.
+
  
Чтобы добавить контакт в гостевой аккаунт надо писать JID именно в таком формате.
+
... j2j allows you to see its presence.
  
Многие клиенты ([[Tkabber]], [[JAJC]]) поддерживают добавление пользователей через транспорты прозрачно, в таком случае необходимо лишь указать, через какой транспорт добавлять пользователя, а его [[JID]] можно писать уже в обычном формате.
+
There will appear an extra option '''Light first mail-notify''' in transport options (they could be aceessed via ad-hoc commands). Setting this option on makes the first new mail notification message consistent of number of them only.
  
==Дополнительные функции==
+
== Using with Facebook ==
===Автоответчик===
+
From Febrary 2010, facebook let you use any xmpp client to use their chat system[http://www.facebook.com/sitetour/chat.php]. You need to edit your facebook account and click in settings and after that in username, you can choose a convenient and clean alias (without blanks and such) [https://register.facebook.com/editaccount.php?settings&alias].
По просьбам пользователей на нашем форуме, в транспорт J2J встроена функция автоответчика. Использование этой функции варьируется от информирования о смене [[JID]]а на новый до информировании о том, что пользователь перестал использовать [[proprietary|проприетарные]] [[IM]] системы, и искать его стоит в [[Jabber]], либо через [[Habahaba]]. Во втором случае на гостевом аккаунте необходимо подключить [[gateway|транспорты]] в нужные сторонние [[IM]] системы. Если Вы нашли другое интересное применение, мы будем рады выслушать Вас на нашем форуме.
+
  
Для включения автоответчика, необходимо воспользоваться Jabber-[[client|клиентом]] с поддержкой ad-hoc commands, например, [[Bombus]], [[JAJC]], [[Tkabber]], [[Gajim]]. Выберите комманду Options, поставьте галочку "Enable auto reply for all guest contacts" и введите текст автоответчика в поле "Text for auto reply". Текст может быть не более, чем в 1000 знаков.
+
Discover j2j -> Register -> fill form:
 +
* username: username_you_have_just_set
 +
* password: pass
 +
* sever: chat.facebook.com
 +
* domain or ip: <nothing>
 +
* port: 5222
 +
... registration successful.
  
Дополнительная опция "Always forward messages to me" означает, что сообщения от пользователей из гостевого аккаунта будут приходить даже при активированном автоответчике.
+
... may j2j see your presence? y/n
  
===Не принимать сообщения от пользователей не из ростера===
+
... j2j allows you to see its presence.
Вы можете запретить передачу сообщений от пользователей, не находящихся в вашем гостевом [[roster|ростере]], включив опцию "Receive messages only from Guest roster".
+
  
==Где используется==
+
Test it, it seems to work to some degree.
На данный момент транспорт J2J замечен на серверах:
+
 
 +
== Import your contacts from guest-account ==
 +
If you want to import your contacts from guest-account's roster to your master-account's roster, you can open Discovery-dialog of your Jabber-client, enter JID of your J2J-transport, and add contacts from the "Guest Roster" item. You can use grag and drop technology or context-menu. (drag and drop available in Tkabber и JAJC).
 +
 
 +
==JID Escaping==
 +
Because, node of JID cannot include "@" char, it needed to use JID-Escaping: all "@" chars is replacing to "%" and "%" replacing to "\%". For example, <tt>vasya%jabber.ru@xmpp.tushinec.ru</tt>.
 +
 
 +
If you want to add contact through your guest-account, you must use such format.
 +
 
 +
Some clients (Tkabber, JAJC) supports addition contacts through transports transparently. In this case, just select transport and enter JID in simple format <user@server>.
 +
 
 +
==Additional possibilities==
 +
===Auto-answer service===
 +
At requests of users, auto-answer service is implemented in J2J. Use this for inform your contacts about your new JID or something else.
 +
 
 +
You need use Jabber-client with ad-hoc commands support, for example, Bombus, JAJC, Tkabber, Gajim, Psi or Coccinella. Execute a Options command, check "Enable auto reply for all guest contacts" checkbox and enter text for auto-answer in text area "Text for auto reply". It limited to 1000 chars.
 +
 
 +
Additional checkbox "Always forward messages to me" means, that messages will be forwarded with enabled auto-answer service too.
 +
 
 +
===Receive message only from Guest roster===
 +
You can deny messages from users not from guest-account's roster checking checkbox "Receive messages only from Guest roster".
 +
 
 +
==Where it's used==
 +
For a moment, J2J is in use at this servers:
 
* ''jrudevels.org''
 
* ''jrudevels.org''
 
* ''udaff.com''
 
* ''udaff.com''
 
* ''jabbus.org''
 
* ''jabbus.org''
 
* ''jabbe.net.ru''
 
* ''jabbe.net.ru''
* ''bug.su''
+
* ''jabster.pl''
* ''nsmart.ru''
+
* ''chrome.pl''
 +
* ''im.flosoft.biz''
 +
* ''jabber.hot-chilli.net''
 +
* ''draugr.de''
 +
* ''jabber.apinc.org''
 +
 
 +
* [[jworld:Список публичных транспортов J2J|List of public and private J2J instances]] (in russian)
  
==Для администратора jabber-сервера==
+
==For Jabber-servers admins==
[[J2J:AdminGuide|Работа с транспортом J2J для администраторов]]
+
[[Eng:J2J:AdminGuide|J2J Installation and operation guide]]
  
  
 
[[Category:Gateway]]
 
[[Category:Gateway]]

Latest revision as of 06:54, 18 January 2015

Эта страница доступна в версии на русском языке.

This page is also available in Russian.

Pages in EnglishTranslated pagesPages that have an english version
Transport J2J

With this transport you can aggregate contacts from rosters of two (or more) Jabber accounts in single roster. E.g., you can communicate through your GTalk or LiveJournal account, using main account on Jabber.org. For your interlocutors it will be seen as you logged in on this three-accounts manually. Though actually Gtalk and LiveJournal will be connected through J2J transport.

Features[edit]

Usage[edit]

J2J registration form

To make explanations smplier we'll introduce two main concepts: master Account and guest account. Master account is that which will be register this transport, guest account is that which will be used through J2J.

In the Username field you must enter username of guest account. Password is a password for guest account. In the Server field you must enter just a hostname of your guest Jabber server.

Value of Port field doesn't follow for change. It must be used when Jabber server uses non-standard port. Because SSL doesn't supported, value 5223 is invalid.

You will receive a subscription request after registration, you must accept it and wait for connection with guest account. When connection is established, J2J will be online.

There are protection from ring registrations on transport, however, it isn't recommended to create such connections.

Using with Google Talk[edit]

Just enter your JID. Your Gtalk account will be recognized automatically, and the additional functions will be accessible:

Discover j2j -> Register -> fill form:

  • username: gmailuser
  • password: pass
  • sever: gmail.com
  • domain or ip: <nothing>
  • port: 5222

... registration successful.

... may j2j see your presence? y/n

... j2j allows you to see its presence.

There will appear an extra option Light first mail-notify in transport options (they could be aceessed via ad-hoc commands). Setting this option on makes the first new mail notification message consistent of number of them only.

Using with Facebook[edit]

From Febrary 2010, facebook let you use any xmpp client to use their chat system[1]. You need to edit your facebook account and click in settings and after that in username, you can choose a convenient and clean alias (without blanks and such) [2].

Discover j2j -> Register -> fill form:

  • username: username_you_have_just_set
  • password: pass
  • sever: chat.facebook.com
  • domain or ip: <nothing>
  • port: 5222

... registration successful.

... may j2j see your presence? y/n

... j2j allows you to see its presence.

Test it, it seems to work to some degree.

Import your contacts from guest-account[edit]

If you want to import your contacts from guest-account's roster to your master-account's roster, you can open Discovery-dialog of your Jabber-client, enter JID of your J2J-transport, and add contacts from the "Guest Roster" item. You can use grag and drop technology or context-menu. (drag and drop available in Tkabber и JAJC).

JID Escaping[edit]

Because, node of JID cannot include "@" char, it needed to use JID-Escaping: all "@" chars is replacing to "%" and "%" replacing to "\%". For example, vasya%jabber.ru@xmpp.tushinec.ru.

If you want to add contact through your guest-account, you must use such format.

Some clients (Tkabber, JAJC) supports addition contacts through transports transparently. In this case, just select transport and enter JID in simple format <user@server>.

Additional possibilities[edit]

Auto-answer service[edit]

At requests of users, auto-answer service is implemented in J2J. Use this for inform your contacts about your new JID or something else.

You need use Jabber-client with ad-hoc commands support, for example, Bombus, JAJC, Tkabber, Gajim, Psi or Coccinella. Execute a Options command, check "Enable auto reply for all guest contacts" checkbox and enter text for auto-answer in text area "Text for auto reply". It limited to 1000 chars.

Additional checkbox "Always forward messages to me" means, that messages will be forwarded with enabled auto-answer service too.

Receive message only from Guest roster[edit]

You can deny messages from users not from guest-account's roster checking checkbox "Receive messages only from Guest roster".

Where it's used[edit]

For a moment, J2J is in use at this servers:

  • jrudevels.org
  • udaff.com
  • jabbus.org
  • jabbe.net.ru
  • jabster.pl
  • chrome.pl
  • im.flosoft.biz
  • jabber.hot-chilli.net
  • draugr.de
  • jabber.apinc.org

For Jabber-servers admins[edit]

J2J Installation and operation guide