Отправка RADIUS CoA и Disconnect из командной строки
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 полностью завершает сессию пользователя на устройстве доступа.