3. Синхронизация содержимого каталога
Операция Sync вызывается при посылке клиентом сообщения SearchRequest Message с элементом управления Sync Request Control.
Отсутствие куки, либо куки с состоянием инициализации синхронизации, указывает на то, что это запрос первоначального содержимого каталога, а наличие куки, представляющего собой состояние клиентской копии, указывает на то, что это запрос обновления содержимого каталога. Сессии синхронизации обсуждаются в разделе 3.1. Определение содержимого каталога обсуждается в разделе 3.2.
Режим — либо refreshOnly, либо refreshAndPersist. Режимы refreshOnly и refreshAndPersist обсуждаются, соответственно, в разделах 3.3 и 3.4. Режим refreshOnly состоит только из стадии обновления, а режим refreshAndPersist состоит из стадии обновления и следующей за ней стадии непрерывного обслуживания.
3.1. Сессия синхронизации
Последовательность операций Sync, в которой последнее куки, возвращённое сервером для одной операции, предоставляется клиентом в следующей операции, считается принадлежащей одной и той же сессии синхронизации.
Клиент должен (MUST) указывать одни и те же параметры управления содержимым каталога (смотрите раздел 3.5) в каждом поисковом запросе в рамках сессии. Клиенту следует (SHOULD) также выполнять каждый запрос Sync в рамках сессии с одними и теми же учётными данными аутентификации и авторизации, а также с эквивалентными параметрами целостности и защиты. Если сервер не распознает куки запроса, либо запрос выполняется с отличными учётными данными или неэквивалентными параметрами защиты, серверу нужно (SHALL) вернуть первоначальное содержимое каталога как в случае непредоставления куки, либо вернуть пустое содержимое с результирующим кодом LDAP e-syncRefreshRequired. Решение о том, возвращать ли первоначальное содержимое или пустое содержимое с результирующим кодом e-syncRefreshRequired, может (MAY) быть основано на reloadHint в элементе управления Sync Request Control, полученном от клиента. Если сервер распознает куки запроса как представляющее собой пустое состояние или состояние инициализации синхронизации клиентской копии, ему нужно (SHALL) вернуть первоначальное содержимое каталога.
Сессия синхронизации может охватывать несколько сессий LDAP между клиентом и сервером. Клиенту следует (SHOULD) выполнять каждый запрос Sync в рамках сессии к одному и тому же серверу. (Примечание: Соображения теневых копий обсуждаются в разделе 6).