RetrieveRadiusUser – Получить все атрибуты аккаунта Wi-Fi клиента из базы RADIUS
Общая информация
-
Команда актуальна, начиная с версии 1.5
Входные параметры
| Параметр | Значение | Формат значения | Расшифровка формата | Ссылка |
|---|---|---|---|---|
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 |
Выходные параметры
| Параметр | Значение | Формат значения |
|---|---|---|
code |
Код ответа |
Целое неотрицательное число. |
detail |
Пояснение к ответу |
Текст английскими буквами с пробелами и спецсимволами. |
response |
Объект NbiRadiusUserItemSingle |
Примеры команд и кодов
| Код | Описание ошибки |
|---|---|
11 |
Данного аккаунта не существует |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username>client1</xsd:username>
<xsd:domain>enterprise.root</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>11</ns:code>
<ns:detail>No user 'client1[enterprise.root]' in RADIUS server</ns:detail>
<ns:response>
<ns:clientCrtLink/>
<ns:domain/>
<ns:name/>
<ns:password/>
<ns:tariffCode/>
<ns:check/>
<ns:reply/>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
| Код | Описание ошибки |
|---|---|
10 |
Домен роли не имеет прав на домен пользователя |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username>client1</xsd:username>
<xsd:domain>root</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>10</ns:code>
<ns:detail>The role of the user does not have rights to this domain: 'root'. Role`s domains: 'enterprise.root test.root hotspot.root'</ns:detail>
<ns:response>
<ns:clientCrtLink/>
<ns:domain/>
<ns:name/>
<ns:password/>
<ns:tariffCode/>
<ns:check/>
<ns:reply/>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
| Код | Описание ошибки |
|---|---|
8 |
Нет домена или домен не соответствует правилам |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username>client1</xsd:username>
<xsd:domain>?</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>8</ns:code>
<ns:detail>Domain '?' does not conform to the rules FQDN</ns:detail>
<ns:response>
<ns:clientCrtLink/>
<ns:domain/>
<ns:name/>
<ns:password/>
<ns:tariffCode/>
<ns:check/>
<ns:reply/>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
| Код | Описание ошибки |
|---|---|
62 |
Домен не зарегистрирован |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username>client1</xsd:username>
<xsd:domain>1.root</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>62</ns:code>
<ns:detail>Such '1.root' is not registered in ELTEX_EMS.DOMAINS</ns:detail>
<ns:response>
<ns:clientCrtLink/>
<ns:domain/>
<ns:name/>
<ns:password/>
<ns:tariffCode/>
<ns:check/>
<ns:reply/>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
| Код | Описание ошибки |
|---|---|
20 |
Имя пользователя некорректно. |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username></xsd:username>
<xsd:domain>1.root</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>20</ns:code>
<ns:detail>Incorrect field 'username'</ns:detail>
<ns:response>
<ns:clientCrtLink/>
<ns:domain/>
<ns:name/>
<ns:password/>
<ns:tariffCode/>
<ns:check/>
<ns:reply/>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
| Код | Описание ошибки |
|---|---|
0 |
Успешно |
Запрос
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://nbi.radius.eltex.org">
<soapenv:Header/>
<soapenv:Body>
<xsd:RetrieveRadiusUser>
<xsd:username>test</xsd:username>
<xsd:domain>enterprise.root</xsd:domain>
</xsd:RetrieveRadiusUser>
</soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:RetrieveRadiusUserResponse
xmlns:ns="http://org.eltex.radius.nbi/xsd">
<ns:return>
<ns:code>0</ns:code>
<ns:detail/>
<ns:response>
<ns:clientCrtLink>http://127.0.0.1:8080/eltex-radius-nbi/certificates/root/enterprise/test.zip</ns:clientCrtLink>
<ns:domain>enterprise.root</ns:domain>
<ns:name>test</ns:name>
<ns:password>123</ns:password>
<ns:tariffCode>white</ns:tariffCode>
<ns:check>
<ns:attr>
<ns:name>Cleartext-Password</ns:name>
<ns:oper>:=</ns:oper>
<ns:value>123</ns:value>
</ns:attr>
</ns:check>
<ns:reply>
<ns:attr>
<ns:name>Eltex-User-Create-Date</ns:name>
<ns:oper>=</ns:oper>
<ns:value>2015-11-09 15:38:55</ns:value>
</ns:attr>
<ns:attr>
<ns:name>Eltex-Traffic-Limit</ns:name>
<ns:oper>=</ns:oper>
<ns:value>67108864</ns:value>
</ns:attr>
<ns:attr>
<ns:name>Eltex-Work-Time-Limit</ns:name>
<ns:oper>=</ns:oper>
<ns:value>180</ns:value>
</ns:attr>
</ns:reply>
</ns:response>
</ns:return>
</ns:RetrieveRadiusUserResponse>
</soapenv:Body>
</soapenv:Envelope>
Вернуться к списку команд
Версия 1.20-2055
Дата публикации 13-08-2021 02:44:15