wpa_cli - клиент WPA для командной строки
wpa_cli [ -p путь_к_сокетам_управления ] [ -i интерфейс ] [ -hvB ] [ -a файл_действий ] [ -P PID_файл ] [ команда ... ]
wpa_cli - текстовый интерфейс для общения с wpa_supplicant. Он используется для запроса текущего состояния, смены настроек, событий переключения и интерактивного ввода запросов пользователя.
wpa_cli может показать текущее состояние аутентификации, выбранный режим безопасности, MIB-ты dot11 и dot1x и так далее. В дополнение, он может настраивать некоторые переменные вроде параметров конечного автомата EAPoL и события-переключатели, например пересоединение, и вход/выход IEEE 802.1X. wpa_cli представляет интерфейс пользователя для запроса информации аутентификации, например, имени пользователя и пароля, если они не указаны в настройках. Это может пригодиться для реализации, например, для одноразовых паролей или аутентификации по картам, когда аутентификация основана на механизме запрос-ответ с использованием внешних устройства для получения ответа.
Управляющий интерфейс wpa_supplicant может быть настроен таким образом, что он будет доступен обычным пользователям (параметр ctrl_interface GROUP= в файле конфигурации). Это позволяет запускать wpa_cli под учётной записью обычного пользователя.
wpa_cli поддерживает два режима: интерактивный режим и режим командной строки. Оба режима обладают одинаковым набором команд и главное отличие интерактивного режима состоит в предоставлении доступа к незапрашиваемым сообщениям (сообщения о событиях, запросы имени пользователя/пароля).
Интерактивный режим запускается если wpa_cli запущен без команды в качестве параметра командной строки. В этом случае команды можно вводить в ответ на приглашение wpa_cli. В режиме командной строки те же самые команды указываются в качестве аргумента командной строки для wpa_cli.
Когда wpa_supplicant нужны параметры аутентификации, такие как имя пользователя и пароль, которые не присутствуют в файле конфигурации, он отправляет запрос всем подключенным программам-оболочкам, например, wpa_cli в интерактивном режиме. wpa_cli отображает эти запросы с приставкой "CTRL-REQ-<тип>-<идентификатор>:<текст>". <тип> - это тип идентификации, одно из трёх значений: IDENTITY, PASSWORD, или OTP (one-time-password - одноразовый пароль). <идентификатор> - это уникальный идентификатор текущей сети. <текст> - это описание запроса. В случае запроса OTP, он включает вызов от сервера аутентификации.
Ответ на эти запросы могут быть заданы с помощью команд identity, password и otp. <идентификатор> нужно скопировать из подходящего запроса. Команды passwod и otp могут использоваться вне зависимости от того, что было запрошено - PASSWORD или OTP. Главное отличие между этими командами заключается в том, что значения указанные в passwod запоминаются до тех пор, пока работает wpa_supplicant, в то время как значения заданные с помощью otp используются только однажды и затем забываются, то есть, wpa_supplicant запрашивает у оболочки новое значение пароля при каждом использовании. Это может использоваться для реализации списков одноразовых паролей и аутентификации на основе идентификационных карт и брелоков.
Образец запроса пароля и подходящего ответа:
CTRL-REQ-PASSWORD-1:Password needed for SSID foobar > password 1 mysecretpasswordОбразец запроса идентификационной карты типа вызов-ответ:
CTRL-REQ-OTP-2:Challenge 1235663 needed for SSID foobar > otp 2 9876
-p путь Изменить путь, где должен находиться управляющий сокет. -i имя_интерфейса Указать настраиваемый интерфейс. По умолчанию, выбирает первый интерфейс, найденный с помощью сокета управления по указанному пути. -h Помощь. Показать справку по использованию. -v Показать информацию о версии. -B Работать в режиме демона в фоне. -a файл Работать в режиме демона, выполняя файл действий, основываясь на событиях от wpa_supplicant. Указанный файл будет выполнен с именем интерфейса, указанным в качестве первого аргумента, и словом "CONNECTED" или "DISCONNECTED" в качестве второго, в зависимости от события. Это может использоваться для выполнения служебных сетевых программ, необходимых для настройки интерфейса. Файлу доступны также три переменные окружения: WPA_CTRL_DIR, WPA_ID и WPA_ID_STR. WPA_CTRL_DIR содержит абсолютный путь к сокету управления интерфейсом. WPA_ID содержит уникальный идентификатор сети, назначенный активной сети, и WPA_ID_STR содержит значение опции id_str.
-P файл Задать расположение файла с идентификатором процесса. команда Запустить команду. Доступные команды перечислены в следующем разделе.
Доступны следующие команды:
status Получить текущее состояние WPA/EAPOL/EAP mib Получить переменные MIB (dot1x, dot11) help Вывести краткую справку по использованию interface [имя_интерфейса] Показать интерфейсы или выбрать интерфейс level <debug level> Изменить уровень отладки license Показать полную лицензию wpa_cli logoff IEEE 802.1X состояние машины при выходе EAPoL logon IEEE 802.1X состояние машины при входе EAPoL set Задать переменные (показать список переменных при запуске без аргументов) pmksa Показать кэш PMKSA reassociate Принудительная переассоциация reconfigure Заставить wpa_supplicant перечитать его файл конфигурации preauthenticate <BSSID> Принудительная пред-аутентификация identity <идентификатор_сети> <идентификатор> Настроить идентификацию на SSID password <идентификатор_сети> <пароль> Настроить пароль для SSID pin <идентификатор сети> <идентификационный_номер> Настроить идентификационный номер для SSID otp <идентификатор сети> <пароль> Настроить одноразовый пароль для SSID bssid <идентификатор сети> <BSSID> Настроить предпочитаемый BSSID для SSID list_networks Перечислить настроенные сети terminate Завершить wpa_supplicant quit Выйти из wpa_cli
wpa_supplicant(8)
wpa_supplicant Copyright © 2003-2007, Джуни Мэлайнен (Jouni Malinen) <j@w1.fi> и вкладчики. Все права защищены.
Эта программа распространяется под двумя лицензиями: GPL версии 2 и лицензией BSD. Любая из лицензий может использоваться на ваш выбор.
Перевод выполнен на сайте коллективных переводов http://translated.by. Авторы перевода Олег Безначев aka saturn721, Владимир Ступин <wheelof@gmail.com>.
| WPA_CLI (8) | 02 декабря 2008 |