CreateRadiusUser – Создание аккаунта Wi-Fi клиента в базе RADIUS

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

Команда неактуальна, начиная с версии 1.18. Рекомендуется использовать CreateRadiusUserV2

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

Параметр	Значение	Формат значения	Расшифровка формата	Ссылка
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
tariffCode	Код тарифного плана. Может быть пустым. Если установлен, то новый пользователь будет принадлежать данному тарифному плану.	[a-zA-Z0-9 ]\{1,64}	Текст латинскими буквами и цифрами до 64-х символов
tlsCrtData	Исходные данные для генерации клиентского сертификата. Объект TlsCrtData. Если тег пустой или period меньше 0, генерация сертификата не происходит. Для генерации обязательным является только тег period, остальные могут быть заменены значениями по умолчанию.
attribute	Атрибуты пользователя, ожидается один или больше объект NbiAttr.

Параметр

Значение

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

Расшифровка формата

Ссылка

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

tariffCode

Код тарифного плана. Может быть пустым. Если установлен, то новый пользователь будет принадлежать данному тарифному плану.

[a-zA-Z0-9 ]\{1,64}

Текст латинскими буквами и цифрами до 64-х символов

tlsCrtData

Исходные данные для генерации клиентского сертификата. Объект TlsCrtData. Если тег пустой или period меньше 0, генерация сертификата не происходит. Для генерации обязательным является только тег period, остальные могут быть заменены значениями по умолчанию.

attribute

Атрибуты пользователя, ожидается один или больше объект NbiAttr.

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

Параметр	Значение	Формат значения
code	Код ответа	Целое неотрицательное число.
detail	Пояснение к ответу	Текст английскими буквами с пробелами и спецсимволами.
response	Объект NbiRadiusUserItemSingle

Параметр

Значение

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

code

Код ответа

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

detail

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

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

response

Объект NbiRadiusUserItemSingle

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

Код	Описание ошибки
0	Успешно

Код

Описание ошибки

Успешно

Запрос

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org" xmlns:xsd="http://object.nbi.radius.eltex.org/xsd" xmlns:xsd1="http://response.object.nbi.radius.eltex.org/xsd">
   <soap:Header/>
   <soap:Body>
      <nbi:CreateRadiusUser>
         <nbi:username>username8</nbi:username>
         <nbi:domain>root</nbi:domain>
         <nbi:tariffCode>default</nbi:tariffCode>
         <nbi:tlsCrtData>
            <xsd:country>RU</xsd:country>
            <xsd:emailDomain>eltex.nsk.ru</xsd:emailDomain>
            <xsd:location>Novosibirsk</xsd:location>
            <xsd:organization>Eltex</xsd:organization>
            <xsd:organizationUnit>In-soft</xsd:organizationUnit>
            <xsd:period>365</xsd:period>
            <xsd:state>Novosibirsk</xsd:state>
         </nbi:tlsCrtData>
         <!--Zero or more repetitions:-->
         <nbi:attribute>
            <xsd1:name>Operator-Name</xsd1:name>
            <xsd1:oper>=</xsd1:oper>
            <xsd1:value>Денис</xsd1:value>
         </nbi:attribute>
         <nbi:attribute>
            <xsd1:name>Operator-Family</xsd1:name>
            <xsd1:oper>=</xsd1:oper>
            <xsd1:value>Владимиров</xsd1:value>
         </nbi:attribute>
         <nbi:attribute>
            <xsd1:name>Cleartext-Password</xsd1:name>
            <xsd1:oper>:=</xsd1:oper>
            <xsd1:value>1234</xsd1:value>
            </nbi:attribute>
         <nbi:attribute>
            <xsd1:name>Eltex-User-Category</xsd1:name>
            <xsd1:oper>=</xsd1:oper>
            <xsd1:value>hotspot</xsd1:value>
            </nbi:attribute>
      </nbi:CreateRadiusUser>
   </soap:Body>
</soap:Envelope>

Ответ

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:CreateRadiusUserResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return xsi:type="ax22:NbiCodeRadiusUserItemSingleResponse">
            <ax22:code>0</ax22:code>
            <ax22:detail/>
            <ax22:response xsi:type="ax22:NbiRadiusUserItemSingle">
               <ax22:clientCrtLink>http://127.0.0.1:8080/eltex-radius-nbi/certificates/root/username8.zip</ax22:clientCrtLink>
               <ax22:domain>root</ax22:domain>
               <ax22:name>username8</ax22:name>
               <ax22:password>1234</ax22:password>
               <ax22:tariffCode>default</ax22:tariffCode>
               <ax22:check xsi:type="ax22:NbiAttrArray">
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Cleartext-Password</ax22:name>
                     <ax22:oper>:=</ax22:oper>
                     <ax22:value>1234</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>TLS-Client-Cert-Serial</ax22:name>
                     <ax22:oper>:=</ax22:oper>
                     <ax22:value>0123</ax22:value>
                  </ax22:attr>
               </ax22:check>
               <ax22:common xsi:type="ax22:NbiAttrArray">
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Operator-Name</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>Денис</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Operator-Family</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>Владимиров</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Eltex-User-Category</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>hotspot</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Operator-Creator-Name</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>N</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Operator-Creator-Family</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>A</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Operator-Creator-Phone</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>79134445566</ax22:value>
                  </ax22:attr>
               </ax22:common>
               <ax22:reply xsi:type="ax22:NbiAttrArray">
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Eltex-User-Create-Date</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>2020-06-10 15:58:21</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Eltex-User-State</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>1</ax22:value>
                  </ax22:attr>
                  <ax22:attr xsi:type="ax22:NbiAttr">
                     <ax22:name>Eltex-State-Begin-Date</ax22:name>
                     <ax22:oper>=</ax22:oper>
                     <ax22:value>1591779501</ax22:value>
                  </ax22:attr>
               </ax22:reply>
               <ax22:verificationWay xsi:nil="true"/>
            </ax22:response>
         </ns:return>
      </ns:CreateRadiusUserResponse>
   </soapenv:Body>
</soapenv:Envelope>

Код	Описание ошибки
8	Нет домена или домен не соответствует правилам
10	Домен роли не имеет прав на домен клиента
19	Данный аккаунт уже существует
20	Имя пользователя некорректно
21	Отсутствуют атрибуты
22	Атрибут некорректный или отсутствует
23	Нельзя редактировать зарезервированный атрибут
24	Отсутствует оператор атрибута пользователя
25	Такого оператора '=:' атрибута пользователя не существует
26	Некорректный оператор для атрибута пользователя
28	Отсутствует обязательный атрибут пользователя
62	Домен не зарегистрирован
75	Некорректное значение для объекта TlsCrtData
76	Ошибка создания клиентского сертификата
100	Тарифного плана с таким кодом не существует
101	Код тарифного плана некорректен
444	У оператора(системного пользователя) отсутствует обязательный атрибут(Operator-Creator-Name, Operator-Creator-Family, Operator-Creator-Phone)
531	Суммарная длина логина и домена не должна превышать 63 символа для создания TLS сертификата

См. также

Вернуться к списку команд
Версия 1.23-2695
Дата публикации 02-09-2022 11:42:18