Перевод RFC1928: Протокол SOCKS 5

Протокол SOCKS 5 [RFC1928].


Network Working Group                                           M. Leech
Request for Comments: 1928                    Bell-Northern Research Ltd
Category: Standards Track                                       M. Ganis
                                         International Business Machines
                                                                  Y. Lee
                                                  NEC Systems Laboratory
                                                                R. Kuris
                                                       Unify Corporation
                                                               D. Koblas
                                                  Independent Consultant
                                                                L. Jones
                                                 Hewlett-Packard Company
                                                               Март 1996


Статус данного документа

   Этот документ описывает протокол связи по стандартам Интернет, и открыт
   для обсуждения и предложений. Пожалуйста обращайтесь к текущей редакции
   "Internet Official Protocol Standards" (STD 1) чтобы справится о стадии
   стандартизации и статусе этого протокола. Распространение этого документа
   не ограничивается.


Благодарности

   Этот документ описывает протокол, который является развитием предыдущей
   версии протокола 4 [1]. Этот новый протокол основывается на бурных
   дискуссиях и прототипах реализаций. Основной вклад внесли:
   Marcus Leech: Bell-Northern Research, David Koblas: Independent Consultant,
   Ying-Da Lee: NEC Systems Laboratory, LaMont Jones: Hewlett-Packard Company,
   Ron Kuris: Unify Corporation, Matt Ganis: International Business Machines.


Введение

   Использование сетевых файрволов и систем, эффективно скрывающих
   организацию внутренней сетевой структуры от внешней сети, такой
   как Интернет, становится все более популярным. Эти файрволы обычно
   работают как гэйтэвэи прикладного уровня между сетями, предлагая
   обычно администрируемый TELNET, FTP, и SMTP доступ. С появлением
   более сложных протоколов прикладного уровня предназначенных для
   облегчения глобального информационного взаимодействия, появилась
   потребность в обеспечении общей основы для прозрачной и безопасной
   работы через файрволл для этих протоколов.

   Существует также необходимость в строгой аутентификации при работе через
   файрволл, в некоторой степени похожей на используемые сейчас методы. Это
   требование обусловлено тем, что отношения типа клиент-сервер появляются
   между сетями различных организаций, и эти отношения должны быть
   управляемыми и, зачастую, строго аутентифицированны.

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


Текущее положение дел

   Существующий сейчас протокол, SOCKS v4, предназначен для работы через
   файрволл без аутентификации для приложений типа клиент-сервер работающих
   по протоколу TCP, таких как TELNET, FTP и таких популярных протоколов
   обмена информацией, как HTTP, WAIS и GOPHER.

   Новый протокол расширяет модель SOCKS v4 добавляя к ней поддержку UDP,
   обеспечение универсальных схем строгой аутентификации и расширяет
   методы адресации, добавляя поддержку доменных имен и адресов IP v6.

   Реализация протокола SOCKS обычно влечет за собой перекомпиляцию или
   пересборку клиентских программ, работающих по протоколу TCP, для
   использования оответствующх функций SOCKS-библиотеки.

   Замечание:

   Если не оговорено обратное, десятичные числа в диаграммах формата
   пакетов обозначают длинну соответствующего поля в октетах (8-битных
   элементах). Если октет должен иметь определенное значение, используется
   обозначение X`hh` для определения значения октета в данном поле.
   Если используется слово `Variable`, это означает, что соответствующее
   поле имеет переменную длинну, определяемую либо связанным (одно- или
   двух-октетным) полем длинны, либо типом данных данного поля.



Процедура для клиентов работающих по TCP

   Когда работающий по TCP клиент хочет соединиться с объектом, доступным
   только через файрволл, он должен открыть TCP-соединение c
   соответствующим SOCKS-портом SOCKS-сервера. Сервис SOCKS обычно
   находится на TCP-порту 1080. Если соединение прошло успешно, клиент
   начинает переговоры о методе аутентификации, который будет
   использоваваться, проходит аутентификацию по выбранному методу и
   посылает свой запрос. SOCKS-сервер обрабатывает запрос и либо
   пытается установить соответствующее соединение, либо отказывает в нем.

   Клиент соединяется с сервером и посылает сообщение с номером версии
   и выбором соответствующего метода аутентификации:

                   +----+----------+----------+
                   |VER | NMETHODS | METHODS  |
                   +----+----------+----------+
                   | 1  |    1     | 1 to 255 |
                   +----+----------+----------+


   Значение поля VER равно X`05` для данной версии протокола. Поле
   NMETHODS содержит число октетов в идентификаторах методов авторизации
   в поле METHODS.

   Серевер выбирает один из предложенных методов, перечисленных в METHODS,
   и послылает ответ о выбранном методе:

                         +----+--------+
                         |VER | METHOD |
                         +----+--------+
                         | 1  |   1    |
                         +----+--------+


   Если выбранный метод в METHOD равен X`FF`, то ни один из предложенных
   клиентом методов не применим и клиент должен закрыть соединение.

   Эти значения определены для поля METHOD:

          *  X`00` аутентификация не требуется
          *  X`01` GSSAPI
          *  X`02` USERNAME/PASSWORD (см. RFC1929)
          *  X`03` до X`7F` зарезервировано IANA
          *  X`80` до X`FE` преднозначено для частных методов
          *  X`FF` нет применимых методов


   Затем клиент и сервер начинают аутентификацию согласно выбранному методу.

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

   Разработчики новых методов аутентификации применимых для этого протокола
   должны обращаться в IANA для получения номера метода. Документ с
   выделеными номерами должен дополнить текущий список номеров и
   соответствущих им методов аутентификации.

   Совместимые реализации должны поддерживать GSSAPI и могут поддерживать
   аутентификацию USERNAME/PASSWORD.


Запросы

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

   SOCKS-запрос формируется следующим образом:

        +----+-----+-------+------+----------+----------+
        |VER | CMD |  RSV  | ATYP | DST.ADDR | DST.PORT |
        +----+-----+-------+------+----------+----------+
        | 1  |  1  | X`00` |  1   | Variable |    2     |
        +----+-----+-------+------+----------+----------+


     Где:

          *  VER    версия протокола: X`05`
          *  CMD
             *  CONNECT X`01`
             *  BIND X`02`
             *  UDP ASSOCIATE X`03`
          *  RSV    зарезервировано
          *  ATYP   тип адреса, следующего вида:
             *  IP v4 адрес: X`01`
             *  имя домена:  X`03`
             *  IP v6 адрес: X`04`
          *  DST.ADDR требуемый адрес
          *  DST.PORT требуемый порт (в сетевом порядке октетов)


   SOCKS-сервер обрабатывает запрос на основании исходного и целевого
   адресов и посылает одно или несколько сообщений в ответ, в соответствии
   с типом запроса.


Адресация

   Тип адреса содержащегося в адресном поле (DST.ADDR, BND.ADDR),
   определяется содержимым поля ATYP:

          *  X`01`


   адрес является адресом IP v4, длинна адреса 4 октета

          *  X`03`


   поле адреса содержит имя домена. Первый октет адресного поля содержит
   число октетов в последующем за ним имени, завершающий NUL-октет в конце
   строки не применяется.

          *  X`04`


   адрес является адресом IP v6, длинна адреса 16 октет



Ответы

   SOCKS-запрос посылается клиентом как только он установил соединение с
   SOCKS-сервером и выполнил аутентификацию. Сервер обрабатывает запрос и
   посылает ответ в следующей форме:

        +----+-----+-------+------+----------+----------+
        |VER | REP |  RSV  | ATYP | BND.ADDR | BND.PORT |
        +----+-----+-------+------+----------+----------+
        | 1  |  1  | X`00` |  1   | Variable |    2     |
        +----+-----+-------+------+----------+----------+


     Где:

          *  VER    версия протокола: X`05`
          *  REP    код ответа:
             *  X`00` успешный
             *  X`01` ошибка SOCKS-сервера
             *  X`02` соединение запрещено набором правил
             *  X`03` сеть недоступна
             *  X`04` хост недоступен
             *  X`05` отказ в соединении
             *  X`06` истечение TTL
             *  X`07` команда не поддерживается
             *  X`08` тип адреса не поддерживается
             *  X`09` до X`FF` не определены
          *  RSV    зарезервирован
          *  ATYP   тип последующего адреса
             *  IP v4 адрес: X`01`
             *  имя домена:  X`03`
             *  IP v6 адрес: X`04`
          *  BND.ADDR       выданный сервером адрес
          *  BND.PORT       выданный сервером порт (в сетевом порядке октетов)


   Значения зарезервированных (RSV) полей должны быть установлены в X`00`.

   Если выбранный метод аутентификации требует особое формирование пакетов
   с целью проверки целостности и/или конфедициальности, запросы должны
   инкапсулироваться в пакет, формат которого определяется выбранным
   методом.


CONNECT

   В ответ на CONNECT, BND.PORT содержит номер порта, который сервер
   назначает для соединения с указанным хостом, а BND.ADDR содержит
   связанный IP-адрес. Выданный BND.ADDR зачастую отличается от
   IP-адреса, который клиент использует для доступа к SOCKS-северу,
   так как такие сервера часто имеют несколько IP-адресов. Ожидается,
   что сервер будет использовать DST.ADDR и DST.PORT и адрес клиента
   при обработке запроса CONNECT.


BIND

   Запрос BIND используется в протоколах, которые требуют чтобы клиент
   принимал соединение со стороны сервера. Хорошим примером этого
   является FTP, который использует основное соединение клиент-к-серверу
   для комманд и сообщений, но может использовать соединение
   сервер-к-клиенту для передачи данных по запросу (например LS, GET, PUT).

   Ожидается, что клиентская сторона прикладного протокола будет
   использовать запрос BIND только для установки вторичного соединения,
   после первичного соединения, установленного с использованием CONNECT.
   Ожидается, что сервер будет использовать DST.ADDR и DST.PORT
   при обработке запроса BIND.

   SOCKS-сервер посылает два ответа клиенту в течении операции BIND.
   Первый послыается после того, как сервер создает и привязывает
   новый сокет. Поле BND.PORT содержит номер порта, который SOCKS-сервер
   выделил для входящего соединения. Поле BND.ADDR содержит связанный
   IP-адрес. Клиент может использовать эту информацию для уведомления
   (через первичное соединение) приложения-сервера об адресе для
   взаимодействия. Второе уведомление происходит после ожидаемого
   входящего соединения или неудачной попытке входящего соединения.

   При втором ответе поля BND.PORT и BND.ADDR содержат адрес и номер
   порта присоединившегося хоста.


UDP ASSOCIATE

   Запрос UDP ASSOCIATE используется для установления соединения
   посылающим UDP-сообщения процессом. Поля DST.ADDR и DST.PORT содержат
   адрес и порт, на который клиент собирается слать UDP-датаграммы
   после установки соединения. Сервер может использовать эту информацию
   в целях ограничения доступа. Если клиент не располагает информацией
   об адресе на момент запроса UDP ASSOCIATE, то клиент должен заполнить
   нулями номер порта и адреса.

   UDP-связь обрывается, когда обрывается TCP-соединение выполнившее
   запрос UDP ASSOCIATE.

   В ответе на запрос UDP ASSOCIATE, поля BND.PORT и BND.ADDR определяют
   порт и адрес, куда клиент должен слать UDP-датаграмы для пересылки.


Обработка ответов

   Когда приходит ответ с сообщением о неудаче (значение REP не равно
   X`00`), то SOCKS сервер должен оборвать TCP-соединение вскоре после
   посылки ответа. Это должно произойти не более чем спустя 10 секунд
   после определения причин вызвавших неудачу.

   При получении ответа с сообщением об удаче (значение REP равно X`00`),
   если запросом был BIND или CONNECT, то клиент может начинать передавать
   данные. Если выбранная схема аутентификации требует особое формирование
   пакетов с целью проверки целостности и/или конфедициальности, данные
   должны инкапсулироваться в пакет, формат которого определяется выбранным
   методом. Подобно этому, когда данные для клиента получаются
   SOCKS-сервером, сервер должен инкапсулировать данные согласно тому,
   как это требует выбранный метод аутентификации.


Процедура для клиентов работающих по UDP

   Клиент, работающий по UDP, должен посылать свои датаграмы на
   порт пересылающего их UDP-сервера, указанного в поле BND.PORT в
   ответе на запрос UDP ASSOCIATE. Если выбранная схема аутентификации
   требует особое формирование пакетов с целью проверки целостности
   и/или конфедициальности, датаграмма должна инкапсулироваться в пакет,
   формат которого определяется выбранной схемой. Каждая UDP-датаграма
   содержит в себе заголовок UDP-запроса:

      +----+------+------+----------+----------+----------+
      |RSV | FRAG | ATYP | DST.ADDR | DST.PORT |   DATA   |
      +----+------+------+----------+----------+----------+
      | 2  |  1   |  1   | Variable |    2     | Variable |
      +----+------+------+----------+----------+----------+

     Поля заголовка UDP-запроса:

          * RSV  зарезервировано X`0000`
          * FRAG    текущий номер фрагмента
          * ATYP    тип адреса:
             *  IP v4 адрес: X`01`
             *  имя домена:  X`03`
             *  IP v6 адрес: X`04`
          *  DST.ADDR       требуемый целевой адрес
          *  DST.PORT       требуемый целевой порт
          *  DATA     пользовательские данные


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

   Обращение к пересылающему UDP-датаграммы серверу должно производиться
   с ожидаемого SOCKS-сервером IP-адреса клиента, который (клиент) будет
   посылать датаграммы на BND.PORT, данный в ответе на UDP ASSOCIATE.
   Сервер должен отбрасывать датаграммы полученные с любого IP-адреса,
   отличного от того, что был записан для этой связи.

   Поле FRAG показывает, является ли эта датаграмма самостоятельной или
   же фрагментом. Если датаграмма - фрагмент, то установленный старший
   бит является признаком последнего фрагмента, в то время как значение
   X`00` показывает, что это обычная датаграмма. Значения от 1 до 127
   обозначают на позицию фрагменте в последовательности. Каждый
   получатель будет иметь REASSEMBLY QUEUE (очередь сборки) и REASSEMBLY
   TIMER (таймер сборки) связанные с такой фрагментной датаграммой.
   Очередь сборки должна быть переинициализирована и связанные с ней
   фрагменты выкинуты всякий раз при истечении таймера сборки или
   с приходом новой датаграммы, чье значение в поле FRAG меньше,
   чем наибольшее значение поля FRAG датаграмм, обработанных
   при сборке фрагмента. Таймер сборки должен быть не менее 5 секунд.
   Приложениям рекомендуется избегать фрагментацию везде, где только
   это возможно.

   Реализация фрагментации опциональна, в реализациях где фрагментация
   не поддерживается, должны отбрасываться любые датаграммы, у которых
   поле FRAG отлично от X`00`.

   Программный интерфейс для UDP работающего через SOCKS должен сообщать
   о оставшемся свободном пространстве в буфере для UDP-датаграмы, которое
   меньше, чем действительный размер буфера, выделенный операционной
   системой:

          *  если ATYP равен X`01` - на 10+зависит_от_метода октетов меньше
          *  если ATYP равен X`03` - на 262+зависит_от_метода октетов меньше
          *  если ATYP равен X`04` - на 20+зависит_от_метода октетов меньше


   Иными словами, так как в заголовке UDP-запроса, включенного в датаграмму,
   нет информации о длинне данных, то приложение должно помнить об этом
   самостоятельно.


Замечания по безопасности

   Этот документ описывает протокол для работы на прикладном уровне
   с файрволлами в IP-сетях. Безопасность такой работы в большой
   степени зависит от особенностей аутентификации и инкапсуляции
   методов, обеспеченных в конкретной реализации и выбранных
   во время соединения клиента с SOCKS-cервером.

   При выборе метода аутентификации администраторы должны проявить особое
   внимание.

   Careful consideration should be given by the administrator to the
   selection of authentication methods.


Ссылки

   [1] Koblas, D., "SOCKS", Proceedings: 1992 Usenix Security Symposium.

Адрес автора

       Marcus Leech
       Bell-Northern Research Ltd
       P.O. Box 3511, Stn. C,
       Ottawa, ON
       CANADA K1Y 4H7

       Phone: (613) 763-9145
       EMail: mleech@bnr.ca


------------------------------------------------------------------------
Не стреляйте в переводчика, он переводит как умеет (с) неизвестен
Перевод сделан Александром Горлачем, alex@gorlach.koenig.su
------------------------------------------------------------------------