Версия 2 протокола ICQ

Об этом документе

Если Вы хотите прочесть оригинальный документ по второй версии протокола ICQ или подписаться на рассылку, то воспользуйтесь следующим линком: http://www.student.nada.kth.se/~d95-mih/icq/

Этот документ - неофициальная спецификация, основанная исключительно на исследовании TCP/UDP-пакетов, и на данных, полученных из списка рассылки. Это означает, что информация, представленная здесь возможно частично неверная (или будет неверной):-)). Это означает, что если некоторые части спецификации правильны, то они могут быть изменены в любой момент по повелению Божественной Силы Мирабилис :-))

ICQ-клоны

Со времени опубликования этого документа было созданно по крайней мере 2 различных ICQ-клона. Они еще не дописаны, но по крайней мере частично функционируют :-) Для получения подробной информации по этому вопросу воспользуйтесь вышеприведенным линком на страничку Magnus Ihses.

Что было сделано

Самым большим недостатком этого документа является малое количество информации по 3-му и 4-му протоколам ICQ. Эти версии используются ICQ98 (старая бета-версия ICQ98 кажется использует только 3-й протокол, более поздняя версия использует оба этих протокола). Данный документ описывает только версию 2 протокола ICQ, которая в последний раз использовалась в версии ICQ 1.113. Заметьте, что номера версий ICQ привязаны к Win NT/95, т.е. я думаю, что Mac и Java версии ICQ до сих пор используют вторую версию протокола (поправьте меня, если я ошибаюсь) Так какие различия между версией 2 и 3/4 версиями протокола ICQ? Насколько я знаю, наибольшее различие состоит в том, что пакеты в 3/4 версии содержат некий присоединенный уникальный код. Я думаю, что это часть схемы анти-spoof. Мне не удалось выяснить, как этот код сгенерирован, и нуждаюсь в помощи по этому вопросу. Имеются также незначительные изменения в формате пакета. Основная структура осталась неизменной. То, что этот документ не описывает 3 и 4 версии протокола, совсем не означает, что его нельзя использовать при написании ICQ-клона. Серверы Мирабилис все еще поддерживают вторую версию (или по крайней мере поддерживали, когда я проверял это). Можно предположить, что рано или поздно поддержка исчезнет, как например теперь не используется первая версия протокола ICQ. Кроме того, есть некоторые поля в пакетах, назначения которых я выяснить не смог. И, в заключение в этом документе не описаны такие элементы ICQ, как передача файлов и чат.

Введение

Интерактивная связь между клиентами выполняется через прямое TCP-соединение. Все другие связи осуществляются при помощи UDP-пакетов, посланных на ICQ-сервер. Получение UDP-пакета должно быть подтверждено (квитировано) получателем. Если подтверждение не получено, то в течении 10 секунд будет выполнена повторная ретрансляция. После 6 неудачных попыток будет послано B_MESSAGE_ASK сообщение. Вся процедура повторяется 2 раза. И если оба раза не будет ответа, то принимается что пользователь в офф-лайне.

Прежде чем устанавливать любой вид связи, клиент должен залогиниться на сервер. Во время процесса логина клиент засылает на сервер информацию о себе, включающую IP-адрес, TCP-порт, выделенный под ICQ, пароль и свой контакт лист. С этого момента принимается, что клиент присоединен к серверу и он теперь будет посылать на него сообщения-подтверждения того, что он в он-лайне ("keep alive" сообщения). По умолчанию, клиент подсоединен к серверу через UDP-порт 4000.

Такие функции, как отправка сообщения пользователю, находящемуся в офф-лайне, получение информации о пользователе, поиск пользователя в ICQ Global Directory и изменение пароля, осуществляются путем отправки UDP-пакетов на сервер. Структура этих пакетов проста, они содержат UIN-адрес отправителя, специальный код, указывающий серверу, какую операцию он должен выполнить, и некоторые параметры.

Когда пользователь отправляет сообщение, URL или что-либо иное пользователю, находящемуся в он-лайне, между этими пользователями устанавливается TCP-соединение, формат отправляемых сообщений будет схожий (но не идентичный) с форматом, использующимся при UDP-передаче. После того, как сообщение отправлено, TCP-соединение не закрывается, а остается открытым для передачи будущих сообщений. TCP-соединение будет закрыто, когда один из пользователей уйдет в офф-лайн.

Обратите внимание на то, что все числа в этом документе представлены в шестнадцатеричной системе счисления - сначала идет младший байт, затем старший. Все строки заканчиваются NULL.

Связь между сервером и клиентом с использованием UDP

UDP-пакет, посланый клиентом на сервер имеет следующий формат:

UDP-пакет, посланый сервером клиенту имеет следующий формат:

Поле Version присуствует во всех ICQ-пакетах, оно идентифицирует пакет как ICQ-сообщение. SEQ_NUM содержит уникальный последовательный номер пакета. Это необходимо, чтобы избежать неприятностей, если пакет будет потерян или продублирован (такое случается). Обычно номер текущего пакета на 1 больше номера предыдущего. Отметьте, что сервер и клиент имеют раздельные системы нумерования - пакет с SEQ_NUM=3, посланный с сервера, отличен от пакета с SEQ_NUM=3, отосланного клиентом. Сервер начинает счет с 00 00, клиент с 01 00.

Клиент может послать на сервер следующие команды:

Еще детально не описаны (в версии 0.1 этого документа):

Следующие команды посылаются сервером клиенту в ответ на команду клиента или для оповещения клиента о каком-либо событии:

Еще детально не описаны (в версии 0.1 этого документа):

Рассмотрим UDP-сообщения более подробно.

Сообщения, посланные клиентом

ACK

0A 00

Подтверждение. Параметры отсутствуют.

Примечание! Порядковый номер в заголовке пакета содержит порядковый номер полученного с сервера пакета (квитанции)

SEND_MESSAGE

0E 01

Эта команда используется, чтоб послать сообщение пользователям, находящимся в off-line.

Параметры

MESSAGE_TYPE может быть одним из следующих:

LOGIN

E8 03

Этот пакет используется для подключения (log) к серверу.

Параметры

CONTACT_LIST

06 04

Эта команда используется для информирования сервера о своем контакт листе

Параметры

SEARCH_UIN

1A 04

Поиск пользователя с заданным UIN

Параметры

Ответ с сервера будет содержать соответствующее запросу значение SEARCH_SEQ_NUM.

SEARCH_USER

24 04

Поиск пользователя по его имени или эл. адресу.

Параметры

Заметьте, что поля поиска (NICK_NAME, FIRST_NAME, LAST_NAME, E_MAIL) могут быть пустыми, но не все одновременно, хотя бы одно должно содержать данные. Также отметьте, что вы можете начинать поиск, когда заполнено только одно поле EMAIL (все остальные поля пусты) или поле Name (но тогда хотя бы одно из остальных полей должно быть заполнено).

KEEP_ALIVE

2E 04

Эта команда должна посылаться серверу каждые 2 минуты. Если она не будет послана, то сервер примет, что вы находитесь off-line.

Параметров нет.

SEND_TEXT_CODE

38 04

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

Параметры

Возможные значения TEXT_CODE:

LOGIN_1

4C 04

Во время логина посылается неизвестный пакет.

INFO_REQ

60 04

Запрашивает основную информацию о пользователе.

Сервер ответит INFO_REPLY с тем же INFO_SEQ_NUM

EXT_INFO_REQ

6A 04

Запрашивает расширенную информацию о пользователе.

Сервер ответит EXT_INFO_REPLY с тем же INFO_SEQ_NUM

CHANGE_PASSWORD

9C 04

Сменить пароль входа.

STATUS_CHANGE

D8 04

Изменяет online статус пользователя (Away, Invisible и др.)

Параметры

Статусы

LOGIN_2

28 05

Используется во время логина

Сообщения, посланные сервером

ACK

0A 00

Квитанция на команду, посланную серверу.

Параметров нет.

Порядковые номера в заголовке содержат порядковые номера клиентский подтвержденных пакетов.

LOGIN_REPLY

5A 00

Этот пакет отсылается сервером в случае, если он корректно получил команду LOGIN.

Параметры

LOGIN_SEQ_NUM такой же как и в соответствующем поле команды LOGIN

USER_ONLINE

6E 00

Пользователь из вашего контакт листа он-лайн или изменил свой он-лайн статус

Параметры

REMOTE_IP - "внешний" IP-адрес отдаленного пользователя, REMOTE_REAL_IP - "внутренний" IP-адрес. Эти два адреса будут идентичны, если отдаленный пользователь не находится за firewall. REMOTE_IP - "официальный" IP-адрес, который отображен например в Инфо клиента. REMOTE_PORT - номер TCP- порта, используемый, когда клиент хочет открыть прямое соединение с отдаленным пользователем.  

 

USER_OFFLINE

78 00

Пользователь из вашего контакт листа ушел в офф-лайн

USER_FOUND

8C 00

Пользователь, соответствующий критериям выбора найден. Если было найдено несколько пользователей, вы получите пакет для каждого из них.

Параметры

AUTHORIZE может содержать только 00 или 01. 00 значит, что клиенту нужно послать запрос об авторизации, перед тем, как добавить пользователя в контакт лист, 01 - посылать запрос не надо. Если не найдено ни одного пользователя, удовлетворяющего критериям поиска, будет послано END_OF_SEARCH и пакеты USER_FOUND больше приходить не будут.

RECEIVE_MESSAGE

DC 00

Этот пакет шлется вам во время вашего логина на сервер, если на сервере есть для вас какие-либо пакеты (так называемые "оффлайн-сообщения")

MESSAGE_TYPE может иметь одно из следующих значений:

END_OF_SEARCH

A0 00

Пакеты USER_FOUND больше приходить не будут.

Если MORE_FOUND равно 00, то вы получите всех подходящих пользователей из базы данных. Если 01, то в базе данных очень много пользователей, удовлетворяющих критериям поиска, но все они выводится на экран не будут. Предел - 40 пользователей.

INFO_REPLY

18 01

Возвращает основную информацию о пользователе.

Параметры

AUTHORIZE может содержать только 00 или 01. 00 значит, что клиенту нужно послать запрос об авторизации, перед тем, как добавить пользователя в контакт лист, 01 - посылать запрос не надо.

EXT_INFO_REPLY

22 01

Возвращает расширенную информацию о пользователе.

Параметры

Код, используемый в COUNTRY_CODE - это международный телефонный префикс, т.е. 01 00 (1) для США, 2С 00 (44) для Великобритании, 2Е 00 (46) для Швеции и т.д. COUNTRY_STATUS обычно содержит FE, но если пользователь не ввел код страны (COUNTRY_CODE содержит FF FF), то тогда CONTRY_STATUS будет содержать 9С. Аналогично, если пользователь не ввел свой возраст, то поле AGE будет содержать FF FF. Поле SEX может содержать 3 различных значения: 00 - не определен, 01- женский, 02- мужской.

STATUS_UPDATE

A4 01

Пользователь из контакт листа сменил свой он-лайн-статус (Away и т.п)

Параметры

Статусы