iT-Ti.ruочерки сисадмина

Очерки сисадмина Linux и сети

Отправка RADIUS CoA и Disconnect из командной строки

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция iT-Ti.ru

RADIUS CoA позволяет менять параметры уже установленной сессии или завершать её. Показываем, как отправить такой запрос утилитой radclient, и разбираем частые подводные камни со словарями и кавычками.

RADIUS CoA (Change of Authorization) — механизм из RFC 5176, который позволяет серверу AAA изменить параметры сессии уже после её установления. Не нужно останавливать подключение и стартовать заново: скорость, список доступа или другие атрибуты применяются на лету. Тот же документ описывает Disconnect-Request — команду принудительно завершить сессию. При отладке приложений, которые отправляют такие запросы, удобно воспроизводить их вручную. В Linux для этого есть radclient, входящий в состав FreeRADIUS.

Как это устроено

Обычный RADIUS-запрос идёт от устройства доступа (NAS) к серверу. CoA и Disconnect работают наоборот: инициатор (RADIUS-сервер или приложение биллинга) отправляет пакет на NAS, который слушает порт UDP 3799 по умолчанию. NAS отвечает подтверждением (ACK) или отказом (NAK):

Пакет Назначение
CoA-Request Изменить параметры существующей сессии
CoA-ACK / CoA-NAK Ответ NAS: применено или отклонено
Disconnect-Request Завершить сессию
Disconnect-ACK / Disconnect-NAK Ответ NAS на завершение

Сессия на NAS определяется набором атрибутов-идентификаторов, например Acct-Session-Id, User-Name, Framed-IP-Address, NAS-Identifier. Какие именно атрибуты обязательны, зависит от оборудования, смотрите его документацию.

Отправляем CoA-Request

echo User-Name="10.10.14.161", Nas-Identifier="192.168.122.111" | radclient -d /opt/raddb/ -sx 127.0.0.1:3799 coa testpassword

Разберём команду. Атрибуты читаются со стандартного ввода, перечисляются через запятую. Затем идут адрес и порт получателя, тип пакета (coa) и общий секрет (testpassword) — его нужно задать так же, как на NAS. Ключ -x включает отладочный вывод, -s — печать краткой статистики. Если указать -xx, детализация ещё больше.

Результат выполнения:

Sending CoA-Request of id 169 to 127.0.0.1 port 3799
    User-Name = "10.10.14.161"
    NAS-Identifier = "192.168.122.111"
rad_recv: CoA-NAK packet from host 127.0.0.1 port 3799, id=169, length=26
    Error-Cause = NAS-Identification-Mismatch

NAS ответил CoA-NAK с причиной NAS-Identification-Mismatch: значение NAS-Identifier в запросе не совпало с настроенным на устройстве. Именно атрибут Error-Cause показывает, что не так: например, Session-Context-Not-Found означает, что подходящая сессия не найдена, а Unsupported-Attribute — что NAS не понимает один из атрибутов.

Disconnect-Request

Завершение сессии отправляется аналогично, меняется только тип пакета:

echo 'Acct-Session-Id = "0A0B0C0D", User-Name = "testuser"' | radclient -x 192.0.2.10:3799 disconnect testpassword

В ответ приходит Disconnect-ACK, если сессия закрыта, или Disconnect-NAK с Error-Cause.

Словарь и ключ -d

Здесь чаще всего возникают проблемы.

  • Атрибуты, которые вы передаёте, должны быть описаны в словаре. Если встречается неизвестный атрибут, radclient сообщает об ошибке разбора, и он вместе со следующими за ним в строке в запрос не попадёт.
  • Каталоги словарей задаются ключами -d и -D. В FreeRADIUS 3.x -d указывает каталог конфигурации (raddb), а -D — каталог со словарями, по умолчанию это /usr/share/freeradius. Если используете собственный набор, проверьте поведение вашей версии через radclient -h.
  • В каталоге словарей читается основной файл dictionary. Чтобы подключить дополнительные словари, например вендорские, вставьте в него директивы вида $INCLUDE dictionary.cisco.
  • Вендорские атрибуты (Cisco-AVPair и подобные) без соответствующего словаря не разберутся.

Кавычки и скрипты

Значения-строки с особыми символами нужно заключать в кавычки: MAC-адреса, пробелы, двоеточия. Чтобы оболочка не разобрала их по-своему, оберните всю строку атрибутов в одинарные кавычки, а значения внутри оставьте в двойных, как в примере выше. Для нескольких атрибутов допускается и разнесение по строкам:

radclient -x 192.0.2.10:3799 coa testpassword <<'EOF'
User-Name = "testuser"
Acct-Session-Id = "0A0B0C0D"
Filter-Id = "limit-10m"
EOF

Такой запуск удобен в шелл-скриптах и тестах: не нужно писать обёртку на Perl или Python с RADIUS-библиотекой. Для входного файла можно использовать и аргумент -f.

Что проверить, если нет ответа

  • Доступность UDP 3799 между отправителем и NAS (межсетевые экраны).
  • На NAS разрешён источник запросов и совпадает общий секрет. При неверном секрете устройство молча отбрасывает пакет, и radclient выдаст таймаут.
  • Включён приём динамической авторизации на самом устройстве (на разном оборудовании называется по-разному).

Основа — спецификация RFC 5176 и справка FreeRADIUS по radclient.

Практические советы

Для отладки включайте подробный вывод и сохраняйте его вместе с временем запроса: пригодится при сверке с журналом NAS. Когда запрос отправляется из биллинга, сначала воспроизведите его вручную radclient с теми же атрибутами и убедитесь, что оборудование отвечает ACK, и лишь затем автоматизируйте вызов. Если требуется менять сразу много сессий, не запускайте запросы лавиной: некоторые NAS ограничивают число одновременно обрабатываемых динамических запросов. Для проверки ответа в скриптах анализируйте код возврата radclient и текст ответа на наличие слов ACK или NAK, а не только факт получения пакета.

Частые вопросы

Как отправить RADIUS CoA из командной строки в Linux?

Используйте radclient из пакета FreeRADIUS: передайте атрибуты через stdin и укажите адрес NAS с портом 3799, тип пакета coa и общий секрет. Например: echo 'User-Name = user' | radclient -x 192.0.2.1:3799 coa secret.

На каком порту работает RADIUS CoA?

По RFC 5176 устройства принимают запросы Change of Authorization и Disconnect на UDP-порту 3799 по умолчанию. На конкретном оборудовании порт может быть изменён настройками.

Чем CoA отличается от Disconnect-Request?

CoA-Request меняет атрибуты действующей сессии, не прерывая её: скорость, ACL, VLAN. Disconnect-Request полностью завершает сессию пользователя на устройстве доступа.