AVP (Attribute-Value Pairs) несут все данные DIAMETER. У каждого есть AVP Code, октет флагов (V — vendor, M — mandatory, P — reserved), длина, опциональный Vendor-Id и типизированное значение. Значения используют базовые типы, такие как Unsigned32, OctetString, Address, Time, Enumerated и Grouped. AVP Result-Code и Experimental-Result сообщают результаты.
Структура AVP
Каждая единица данных DIAMETER — идентичности, поля подписки, квоты, результаты — кодируется как AVP. AVP начинается с 32-битного AVP Code, затем следует октет флагов, 24-битная длина, охватывающая весь AVP, опциональный 32-битный Vendor-Id и значение, дополненное до границы в 4 октета. Сам AVP Code уникален в пространстве, управляемом IETF; когда установлен флаг V (Vendor-Specific), код интерпретируется в пространстве нумерации следующего за ним Vendor-Id — именно так 3GPP (Vendor-Id 10415) определяет сотни AVP, используемых S6a, Gx и Cx, не сталкиваясь с базовым протоколом.
0 1 2 3
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| AVP Code (32) |
| V M P r r r r r| AVP Length (24) |
| Vendor-Id (32) — present only if V=1 |
| Data ... (padded to a 4-octet boundary) |Флаги V, M и P
Три флага AVP определяют, как получатель должен обрабатывать AVP. V (Vendor-Specific) сигнализирует, что далее следует Vendor-Id и AVP Code принадлежит пространству этого вендора. M (Mandatory) — самый важный: если M установлен, а получатель не понимает AVP, он обязан отклонить всё сообщение с DIAMETER_AVP_UNSUPPORTED (5001), поэтому неверная установка M нарушает межсетевое взаимодействие, а вендорские AVP, которые реализация может безопасно проигнорировать, отправляются со сброшенным M. P изначально был маркером end-to-end безопасности; RFC 6733 упразднил это применение, и теперь бит зарезервирован и устанавливается в ноль.
| Флаг | Имя | Значение, если установлен |
|---|---|---|
| V | Vendor-Specific | Присутствует поле Vendor-Id; код находится в пространстве этого производителя |
| M | Обязательно | Получатель должен поддерживать его или отклонить сообщение (5001) |
| P | (зарезервировано) | Ранее — сквозная защита; упразднено RFC 6733, устанавливается в 0 |
Базовые типы данных
Значения AVP строго типизированы. RFC 6733 определяет набор базовых типов и несколько производных типов, построенных на OctetString. Целочисленные и беззнаковые типы несут счётчики, идентификаторы и перечисления; OctetString несёт непрозрачные или структурированные двоичные данные; а производные типы добавляют семантику, которую реализация может проверять. Address кодирует IP-адрес с ведущим двухоктетным семейством адресов. Time — это 32-битный счётчик секунд в стиле NTP. Enumerated — это Integer32, значения которого именуются приложением. DiameterIdentity и DiameterURI несут FQDN и URI пиров.
| Тип | Кодировка | Типовое использование |
|---|---|---|
| Unsigned32 / Integer32 | 32-битное целое число | Счётчики, квоты, Auth-Application-Id, Result-Code |
| Unsigned64 / Integer64 | 64-битное целое число | Объёмы в октетах, большие счётчики |
| OctetString | Непрозрачные октеты | Бинарные полезные нагрузки (векторы аутентификации, TPDU) |
| UTF8String | OctetString | Человекочитаемый текст (User-Name, название продукта) |
| Enumerated | Integer32 | Наборы именованных значений (например, RAT-Type, CC-Request-Type) |
| Address | OctetString + семейство | Адреса IPv4/IPv6 (Host-IP-Address, Framed-IP) |
| Время | Unsigned32 | Секунды с 1900 года (Event-Timestamp) |
| DiameterIdentity | OctetString | FQDN узла (Origin-Host, Destination-Host) |
| Grouped | Вложенные AVP | AVPs, содержащие другие AVPs |
Grouped AVP
Grouped AVP имеет в качестве значения конкатенированный список других AVP — поэтому структурированные записи вкладываются друг в друга без новых правил кодирования. Subscription-Data в S6a, Charging-Rule-Install в Gx и Experimental-Result — все несут вложенные AVP внутри группы. Группировка рекурсивна: Grouped AVP может содержать другие Grouped AVP, и именно так полный профиль подписки LTE или набор правил PCC выражается одним AVP верхнего уровня. Каждый вложенный AVP сохраняет свой код, флаги и длину, поэтому получатель разбирает группу тем же механизмом, что и на верхнем уровне.
Result-Code и Experimental-Result
DIAMETER сообщает результат запроса в ответе. Базовый AVP Result-Code (код 268) — это Unsigned32, сгруппированный по диапазонам по ведущей цифре: 1xxx — информационные, 2xxx — успех, 3xxx — протокольные ошибки (от прокси/ретранслятора), 4xxx — временные сбои, которые клиент может повторить, и 5xxx — постоянные сбои. Когда приложению нужна вендорская ошибка, которую базовый Result-Code выразить не может, оно использует AVP Experimental-Result (код 297) — Grouped AVP, несущий Vendor-Id и Experimental-Result-Code, — именно так 3GPP сигнализирует ошибки, такие как DIAMETER_ERROR_USER_UNKNOWN или DIAMETER_ERROR_ROAMING_NOT_ALLOWED.
| Диапазон | Класс | Пример |
|---|---|---|
| 1xxx | Информационное | 1001 DIAMETER_MULTI_ROUND_AUTH |
| 2xxx | Успешно | 2001 DIAMETER_SUCCESS |
| 3xxx | Ошибка протокола (прокси) | 3002 UNABLE_TO_DELIVER, 3007 APPLICATION_UNSUPPORTED |
| 4xxx | Временная ошибка (повторная попытка) | 4181 AUTHENTICATION_DATA_UNAVAILABLE (3GPP) |
| 5xxx | Постоянный сбой | 5001 AVP_UNSUPPORTED, 5012 UNABLE_TO_COMPLY |
Часто задаваемые вопросы
Что такое AVP в DIAMETER?
AVP (Attribute-Value Pair) — это единица данных в каждом сообщении DIAMETER. Она несёт AVP Code, октет флагов (V, M, P), длину, опциональный Vendor-Id и типизированное значение. Все идентичности, поля подписки, квоты и результаты кодируются как AVP, а сообщение — это заголовок, за которым следует их список.
Что делает флаг M (Mandatory)?
Если флаг M установлен, а получатель не понимает данный AVP, он обязан отклонить всё сообщение с DIAMETER_AVP_UNSUPPORTED (5001). Поэтому AVP, которые пир может безопасно проигнорировать, отправляются со сброшенным M. Неправильное использование бита M — частая причина сбоев межсетевого взаимодействия между вендорами.
Что такое Grouped AVP?
Grouped AVP — это AVP, значением которого является сам список AVP, что позволяет вкладывать структурированные записи. Subscription-Data, Charging-Rule-Install и Experimental-Result — это Grouped AVP. Группировка рекурсивна, поэтому полный профиль подписки LTE или набор правил PCC могут переноситься одним AVP верхнего уровня.
Как идентифицируются вендорские AVP?
По флагу V плюс поле Vendor-Id. Когда V установлен, за длиной следует 32-битный Vendor-Id, и AVP Code интерпретируется в пространстве нумерации этого вендора. 3GPP использует Vendor-Id 10415 для определения AVP для S6a, Gx, Cx и других прикладных интерфейсов.
В чём разница между Result-Code и Experimental-Result?
Result-Code (AVP 268) несёт базовые коды результата IETF, сгруппированные как 1xxx/2xxx/3xxx/4xxx/5xxx. Experimental-Result (AVP 297) — это Grouped AVP с Vendor-Id и Experimental-Result-Code, используемый, когда приложению нужна вендорская ошибка, например DIAMETER_ERROR_USER_UNKNOWN от 3GPP.
Что означают диапазоны кодов результата DIAMETER?
1xxx — информационные, 2xxx — успех (2001 DIAMETER_SUCCESS), 3xxx — протокольная ошибка, обычно поднятая прокси, 4xxx — временный сбой, который клиент может повторить, и 5xxx — постоянный сбой. Ведущая цифра говорит клиенту, повторять ли, завершать с ошибкой или перенаправлять.
Технические характеристики источника
На этой странице представлены опубликованные стандарты, на которых они основаны. (Открывается в новой вкладке)