RFC: 4533
Оригинал: The Lightweight Directory Access Protocol (LDAP) Content Synchronization Operatio
Категория: Экспериментальный
Дата публикации:
Автор:
Перевод: Pro-LDAP.ru

2. Элементы операции Sync

Операция Sync определяется как расширение операции поиска LDAP [RFC4511], где пользовательский агент каталога (directory user agent, DUA или клиент) посылает сообщение SearchRequest Message с элементом управления Sync Request Control, системный агент каталога (directory system agent, DSA или сервер) отвечает нулём или более сообщений SearchResultEntry Message, каждое из которых содержит элемент управления Sync State Control; нулём или более сообщений SearchResultReference Message, каждое из которых содержит элемент управления Sync State Control; нулём или более сообщений Sync Info Intermediate Response Message; и сообщением SearchResultDone Message с элементом управления Sync Done Control.

Для того, чтобы клиенты могли определить, поддерживает ли сервер данную операцию, серверам, осуществляющим данную операцию, следует (SHOULD) публиковать 1.3.6.1.4.1.4203.1.9.1.1 в качестве значения атрибута 'supportedControl' [RFC4512] в корне своей DSA-specific entry (DSE). Сервер может (MAY) избрать тактику афиширования данного расширения только в том случае, когда клиент авторизован (имеет право) использовать его.

2.1. Общие элементы ASN.1

2.1.1. syncUUID

Тип данных syncUUID — строка октетов (OCTET STRING), содержащая 128-битный (16-октетный) универсальный уникальный идентификатор (Universally Unique Identifier, UUID) [UUID].

syncUUID ::= OCTET STRING (SIZE(16))
     -- constrained to UUID

2.1.2. syncCookie

syncCookie — введённая для удобства обозначения формулировка, указывающая на то, что, хотя тип syncCookie кодируется как строка октетов (OCTET STRING), его значение — непрозрачная величина, содержащая информацию о синхронизационной сессии и её состоянии. Как правило, информация о сессии включает в себя хэш операционных параметров, которые по требованию сервера нельзя изменять, а информация о состоянии синхронизации включает в себя порядковый номер подтверждения (журнала), порядковый номер изменения или отметку времени. Для удобства описания термин "нет куки" ("no cookie") указывает либо на нулевой куки, либо на куки с предварительно проинициализированным состоянием синхронизации.

syncCookie ::= OCTET STRING

2.2. Sync Request Control

Sync Request Control — элемент управления LDAP [RFC4511], в котором controlType — идентификатор объекта 1.3.6.1.4.1.4203.1.9.1.1, а controlValue — строка октетов (OCTET STRING), содержащая syncRequestValue, закодированное BER. Поле criticality элемента управления — либо TRUE, либо FALSE.

syncRequestValue ::= SEQUENCE {
    mode ENUMERATED {
        -- 0 unused
        refreshOnly       (1),
        -- 2 reserved
        refreshAndPersist (3)
    },
    cookie     syncCookie OPTIONAL,
    reloadHint BOOLEAN DEFAULT FALSE
}

Элемент управления Sync Request Control может применяться только для сообщений SearchRequest Message.

2007 - 2017 © Русские переводы RFC, IETF, ISOC.