Коды ошибок списка разрешённых IP-адресов администратора (mpbx-api-ops)
Возникают при проверке списка разрешённых адресов перед API и в GET/PUT /api/v1/system/admin-ip-allowlist
(W7-PLAT-01b; SEC-NET-003). Руководство: Список разрешённых IP-адресов администратора.
| Код | Вид | Значение | Что делать |
|---|---|---|---|
MPBX-NET-ADMIN-IP-DENIED | forbidden (403) | Запрос пришёл с адреса, которого нет в списке разрешённых администратора. Он отклоняется до аутентификации, поэтому ответ ничего не говорит об учётных данных. | Подключайтесь с разрешённого адреса (или через VPN) либо попросите владельца установки добавить адрес. |
MPBX-NET-ALLOWLIST-LOCKOUT | invalid_argument (400) | Список, который вы сохраняете, не содержит адреса, с которого вы подключаетесь, поэтому вы потеряете доступ. | Добавьте свой адрес (в консоли есть для этого кнопка) и сохраните снова. |
MPBX-NET-ALLOWLIST-INVALID | invalid_argument (400) | Запись не является адресом IPv4 или IPv6 или блоком CIDR, в списке больше 64 записей, область не system и не api, либо список включён, но пуст. | Исправьте названное поле. |
Квота хранилища
Использование хранилища и квоты (GET /api/v1/system/storage/companies,
PUT /api/v1/system/storage/companies/{company_id}/quota) используют общие коды: неизвестная компания —
MPBX-NOT-FOUND; квота вне диапазона от 1 до 2^60 байт или процент предупреждения вне диапазона от 1 до 99 —
MPBX-INVALID-ARGUMENT с указанием поля; устаревший If-Match — 412 (MPBX-PRECONDITION-FAILED).
Руководство: Квоты хранилища.
Защита границы SIP (/api/v1/system/sip-edge/..., FU-W2SIP03-L1)
| Код | Вид | Значение | Что делать |
|---|---|---|---|
MPBX-NET-SIP-LIST-INVALID | invalid_argument (400) | Запись списка разрешённых или запрещённых адресов SIP не является адресом IPv4 или IPv6 или блоком CIDR, либо в списке больше 256 записей. | Исправьте названное поле. |
MPBX-NET-SIP-BAN-INVALID | invalid_argument (400) | Блокировка не содержит адреса IPv4 или IPv6 (сети вносятся в список запрещённых), либо её длительность не от 60 до 2592000 секунд. | Исправьте названное поле. |
MPBX-NET-SIP-BAN-ALLOWLISTED | invalid_argument (400) | Адрес находится в списке разрешённых границы SIP, который никогда не блокируется. | Сначала уберите его из списка разрешённых или поместите в список запрещённых. |
Геоблокировка (W10-OBS-01; SEC-NET-006)
Возникает при проверке геоблокировки перед API и в GET/PUT /api/v1/system/geo-blocking.
Руководство: Геоблокировка.
| Код | Вид | Значение | Что делать |
|---|---|---|---|
MPBX-NET-GEO-BLOCKED | forbidden (403) | Запрос пришёл из страны, которую запрещает правило геоблокировки. Он отклоняется до аутентификации. | Подключайтесь из разрешённой страны (или через VPN) либо попросите владельца установки изменить правило. |
MPBX-NET-GEO-LOCKOUT | invalid_argument (400) | Правило, которое вы сохраняете, заблокировало бы адрес, с которого вы подключаетесь. | Уберите свою страну из списка запрещённых (или добавьте её в список разрешённых) и сохраните снова. |
MPBX-NET-GEO-INVALID | invalid_argument (400) | Режим не off, deny или allow; код страны не из двух букв; область не system и не api; стран больше 300; либо правило allow не содержит ни одной страны. | Исправьте названное поле. |
MPBX-NET-GEO-NO-DATABASE | invalid_argument (400) | Правило сохранено, когда не загружена таблица соответствия IP-адресов странам, поэтому оно ничего не могло заблокировать. | Задайте [geo] database в файле конфигурации и перезапустите сервер. |