Difference between revisions of "Eng:J2J"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
 
 
(48 intermediate revisions by 26 users not shown)
Line 1: Line 1:
'''<big>Транспорт J2J</big>'''
+
{{EnglishVersion|J2J}}'''<big>Transport J2J</big>'''
  
С помощью данного транспорта вы можете объединить в одном ростере контакты из двух (или более) jabber-аккаунтов. Например, вы можете, используя основной аккаунт на jabber.ru, также общаться через свой аккаунт в [[GTalk]] или/и [[LiveJournal]]. Для ваших собеседников это будет выглядеть так, как будто вы вручную залогонились на все три аккаунта. Хотя на самом деле в Gtalk и LiveJournal Jabber будет подключен 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 ==
* [[Gtalk]] поддерживается;
+
* [[:w:en:Gtalk|Gtalk]] support;
* [[LiveJournal]] поддерживается;
+
* [[:w:en:LiveJournal|LiveJournal]] support;
* [[SSL]] не поддерживается;
+
* [[:w:en:Secure_Sockets_Layer|SSL]] is not supported; <!-- feature? -->
* [[StartTLS]] поддерживается.
+
* [[:w:en:Transport_Layer_Security|StartTLS]] support.
  
==Использование==
+
== Usage ==
Для облегчения объявнений введем два понятия: мастер-аккаунт и гостевой аккаунт. Первый это с которого вы регистрируетесь в транспорте, а второй это тот, который будет вами использоваться посредством транспорта.
+
  
[[image:X2x-register.gif]]
+
[[image:X2x-register.gif|frame|J2J registration form]]
  
В поле Username вводите имя пользоватя гостевого аккаунта. Password - пароль от гостевого аккаунта. В поле 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.
  
Значение в поле 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.
Поскольку SSL не поддерживается транспортом, значение 5223 будет невалидным.
+
  
После заполнения формы вам придет запрос на подписку, ответьте положительно и ждите когда транспорт соединится с гостевым аккаунтом. Когда это случится, то он перейдет в статус Online.
+
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.
  
==Использование в случае GTalk-аккаунта==
+
There are protection from ring registrations on transport, however, it isn't recommended to create such connections.
Просто введите свой JID как обычно. [[GTalk]] аккаунт автоматически распознается и дополнительные функции будут доступны.
+
  
В опциях транспорта, которые открываются с помощью ad-hoc commands, появится дополнительная опция Light first mail-notify, которая означает, что первое уведомление о новой почте будет содержать только лишь количество новых писем.
+
== Using with Google Talk ==
  
=="Импорт контактов" из гостевого аккаунта==
+
Just enter your JID. Your Gtalk account will be recognized automatically, and the additional functions will be accessible:
Если вы хотите получить контакты из гостевого аккаунта в ростере мастер-аккаунта, вы можете открыть диалог Discovery вашего jabber-клиента, найти в нем J2J транспорт, там уже открыть секцию Guest Roster и уже оттуда добавить нужные контакты. Добавление происходит путем использования правокнопочного меню или просто перетаскиванием (drag and drop доступен в [[Tkabber]] и [[JAJC]]).
+
  
==Формат JID-ов==
+
Discover j2j -> Register -> fill form:
При работе через транспорт адреса будут выглядеть следующим образом: JID из гостевого аккаунта, у которого вместо собаки знак процента @ название транспорта. Например, <tt>vasya%jabber.ru@xmpp.tushinec.ru</tt>.
+
* username: gmailuser
 +
* password: pass
 +
* sever: gmail.com
 +
* domain or ip: <nothing>
 +
* port: 5222
 +
... registration successful.
  
Чтобы добавить контакт в гостевой аккаунт надо писать JID именно в таком формате.
+
... may j2j see your presence? y/n
  
Многие клиенты ([[Tkabber]], [[JAJC]]) поддерживают добавление пользователей через транспорты прозрачно, в таком случае необходимо лишь указать, через какой транспорт добавлять пользователя, а его [[JID]] можно писать уже в обычном формате.
+
... 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.
===Автоответчик===
+
По просьбам пользователей на нашем форуме, в транспорт 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 знаков.
+
== 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].
  
Дополнительная опция "Always forward messages to me" означает, что сообщения от пользователей из гостевого аккаунта будут приходить даже при активированном автоответчике.
+
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
Вы можете запретить передачу сообщений от пользователей, не находящихся в вашем гостевом [[roster|ростере]], включив опцию "Receive messages only from Guest roster".
+
  
==Где используется==
+
... j2j allows you to see its presence.
На данный момент транспорт J2J замечен на серверах:
+
 
 +
Test it, it seems to work to some degree.
 +
 
 +
== 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