EditRadiusUser – Редактирование аккаунта Wi-Fi клиента в базе RADIUS

Общая информация

  1. Команда актуальна, начиная с версии 1.5

  2. Проверка существования домена не выполняется.

  3. Начиная с версии 1.24, появилась возможность хешировать пароль с помощью атрибута Encryption-Type, который может принимать значения ClearText (простой текст), NT (NT-хеш). Для редактирования пароля необходимо указать новое значение в атрибуте Cleartext-Password и необходимый тип шифрования в атрибуте Encryption-Type. Значением по умолчанию для атрибута Encryption-Type является ClearText.

  4. При незаданном значении атрибута Cleartext-Password - атрибут Encryption-Type будет проигнорирован.

  5. Шифрование пароля доступно только для категорий пользователей enterprise, hotspot, bras и equipment.

Входные параметры

Параметр Значение Формат значения Расшифровка формата Ссылка

usernаme

Логин клиента. Уникальность аккаунта определяется по логину и домену.

^.{1,64}$

Текст до 64-х символов.

Wi-Fi пользователь

domain

Домен клиента. Уникальность определяется по логину и домену.

(?=^.{1,235}$)(^((?!-|_|.*(__|--).*)[a-zA-Z0-9_\-]{1,63}\.)*((?!-|_|.*(__|--).*)[a-zA-Z0-9_\-]{1,63})$)

Текст длиной до 235 символов, удовлетворяющий правилам FQDN

Domain

params

Атрибуты пользователя, ожидается один или больше объект NbiAttr. Если значение атрибута выставлено в null (xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"), то он будет удален.

Выходные параметры

Параметр Значение Формат значения

code

Код ответа

Целое неотрицательное число.

detail

Пояснение к ответу

Текст английскими буквами с пробелами и спецсимволами.

Примеры команд и кодов

Код Описание

0

Успешно
Запрос
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org" xmlns:xsd="http://response.object.nbi.radius.eltex.org/xsd">
   <soap:Header/>
   <soap:Body>
      <nbi:EditRadiusUser>
         <nbi:username>test</nbi:username>
         <nbi:domain>wifi.root</nbi:domain>
         <nbi:attributes>
            <xsd:name>Cleartext-Password</xsd:name>
            <xsd:oper>:=</xsd:oper>
            <xsd:value>123</xsd:value>
         </nbi:attributes>
      </nbi:EditRadiusUser>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:EditRadiusUserResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return>
            <ax21:code>0</ax21:code>
            <ax21:detail/>
         </ns:return>
      </ns:EditRadiusUserResponse>
   </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

7

Некорректный домен (отсутствует)

8

Домен не удовлетворяет правилам FQDN

10

У роли нет прав на домен

11

Такого пользователя RADIUS не существует

20

Некорректное поле username (отсутствует)

21

Нет ожидаемых атрибутов пользователя

22

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

24

Некорректный оператор атрибута пользователя

25

Такого оператора атрибута пользователя не существует

26

Атрибут пользователя не содержит оператора

27

Некорректное значение для атрибута

123

Нет таких атрибутов в аккаунте пользователя

427

Списка с таким именем и доменом не существует

444

У оператора(системного пользователя) отсутствует обязательный атрибут(Operator-Creator-Name, Operator-Creator-Family, Operator-Creator-Phone)

445

Атрибут нередактируемый

542

Тип хеширования пароля не поддерживается или введен некорректно

545

Шифрование пароля не поддерживается для данной категории пользователей

Пример использования

См. также

Вернуться к списку команд
Версия 1.29-3249
Дата публикации 21-12-2023 02:50:11