RetrieveRadiusUserByMac – Получить полное описание учетной записи по MAC-адресу

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

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

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

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

mac

MAC-адрес устройства пользователя услуги Wi-Fi

^([0-9a-fA-F]{2}[:-]){5}([0-9a-fA-F]{2})$

6 двузначных шестнадцатеричных чисел, разделенных ':'.

domain

Домен учетной записи пользователя услуги Wi-Fi

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

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

Domain

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

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

code

Код ответа

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

detail

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

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

response

Объект NbiRadiusUserWithMac

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

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

63

MAC-адрес не передан или не валиден
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>йцу</nbi:mac>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>63</ax21:code>
                <ax21:detail>Incorrect mac</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

7

Не указан домен учетной записи пользователя.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:12:22:11</nbi:mac>
            <nbi:domain></nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>7</ax21:code>
                <ax21:detail>In request by key 'domain' value is empty or null</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

8

Домен не удовлетворяет правилам FQDN.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:12:22:11</nbi:mac>
            <nbi:domain>!qwe</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>8</ax21:code>
                <ax21:detail>Domain '!qwe' does not conform to the rules FQDN</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Указанный домен не зарегистрирован.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:12:22:11</nbi:mac>
            <nbi:domain>ru</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>62</ax21:code>
                <ax21:detail>Such domain 'ru' is not registered in ELTEX_EMS.DOMAINS</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Пользователь, выполняющий операцию, не имеет прав на указанный домен.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:12:22:11</nbi:mac>
            <nbi:domain>root</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>10</ax21:code>
                <ax21:detail>Role have no rights on domain 'root'</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

401

Данный MAC-адрес не привязан к учетным записям в данном домене
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:12:22:11</nbi:mac>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>401</ax21:code>
                <ax21:detail>No mac 'aa:bb:cc:12:22:11' in domain 'nsk.root'</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

0

Успешно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserByMac>
            <nbi:mac>aa:bb:cc:dd:ee:00</nbi:mac>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveRadiusUserByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>0</ax21:code>
                <ax21:detail/>
                <ax21:response xsi:type="ax21:NbiRadiusUserWithMacs">
                    <ax21:clientCrtLink/>
                    <ax21:domain>nsk.root</ax21:domain>
                    <ax21:name>test</ax21:name>
                    <ax21:password>123</ax21:password>
                    <ax21:tariffCode/>
                    <ax21:check xsi:type="ax21:NbiAttrArray">
                        <ax21:attr xsi:type="ax21:NbiAttr">
                            <ax21:name>Cleartext-Password</ax21:name>
                            <ax21:oper>:=</ax21:oper>
                            <ax21:value>123</ax21:value>
                        </ax21:attr>
                    </ax21:check>
                    <ax21:common xsi:type="ax21:NbiAttrArray"/>
                    <ax21:reply xsi:type="ax21:NbiAttrArray">
                        <ax21:attr xsi:type="ax21:NbiAttr">
                            <ax21:name>Eltex-User-Create-Date</ax21:name>
                            <ax21:oper>=</ax21:oper>
                            <ax21:value>2016-11-10 15:31:46</ax21:value>
                        </ax21:attr>
                    </ax21:reply>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:02.493+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:00</ax21:mac>
                    </ax21:mac>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:11.156+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:01</ax21:mac>
                    </ax21:mac>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:15.223+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:02</ax21:mac>
                    </ax21:mac>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.19-78
Дата публикации 04-06-2021 16:40:20