C. Распространённые ошибки при использовании программного обеспечения OpenLDAP
В следующих подразделах предпринята попытка обобщить наиболее распространённые причины ошибок LDAP при использовании OpenLDAP.
C.1. Распространённые причины ошибок LDAP
C.1.1. ldap_*: Can't contact LDAP server (невозможно соединиться с сервером LDAP)
Ошибка Can't contact LDAP server обычно возвращается, когда к серверу LDAP невозможно подключиться. Такое может произойти по многим причинам:
- Сервер LDAP не запущен; это можно проверить, запустив, например,
telnet <хост> <порт>
заменяя <хост> и <порт> именем хоста и портом, на котором сервер должен принимать запросы.
- клиенту не сообщили, как соединиться с работающим сервером; при использовании инструментов командной строки OpenLDAP это достигается путём предоставления параметра -H, аргумент которого — корректный LDAP url, соответствующий интерфейсу, на котором сервер должен принимать запросы.
C.1.2. ldap_*: No such object (нет такого объекта)
Ошибка no such object обычно возвращается, когда невозможно найти целевой DN операции. В этом подразделе описаны причины, общие для всех типов операций. Необходимо также искать частные причины для конкретных типов операций (указанных в сообщении об ошибке).
Наиболее распространённой причиной этой ошибки является то, что объекта с таким именем не существует. Прежде всего, проверьте наличие опечаток.
Также имейте в виду, что по умолчанию вновь созданный сервер каталогов не содержит объектов (за исключением нескольких системных записей). Таким образом, если Вы настроили новый сервер каталогов и получили такое сообщение, то это может попросту означать, что Вы еще не добавили объект, который пытаетесь найти.
Обычно такая ошибка возникает, когда при запросе не указан базовый DN поиска, а значение по умолчанию не было корректно настроено.
Если, например, в slapd.conf Вы определили суффикс
suffix "dc=example,dc=com"
то Вам нужно использовать параметр -b
ldapsearch -b 'dc=example,dc=com' '(cn=jane*)'
чтобы указать утилите, где начинать поиск.
Параметр -b должен быть указан для всех команд LDAP, если Вы не настроили значение по умолчанию в ldap.conf(5).
Подробнее об этом смотрите в ldapsearch(1), ldapmodify(1).
Кроме того, slapadd(8) и её вспомогательные команды очень строго относятся к синтаксису файла LDIF.
Если в файле LDIF допущены некоторые вольности, то в результате его обработки может создаться видимость успешного создания базы данных, однако доступ к некотором частям этой базы может быть затруднён.
Одна из известнейших распространённых ошибок при создании базы данных — помещение пустой строки перед первой записью в файле LDIF. В начале файла LDIF не должно быть пустых строк.
При добавлении новых записей в каталог в общем случае рекомендуется использовать ldapadd(1) вместо slapadd(8). slapadd(8) нужно использовать для загрузки большого количества записей достоверно правильного формата.
Другой причиной появления этого сообщения может быть запись referral (смотрите Построение распределённой службы каталогов), ссылающаяся на незаполненный каталог.
В таком случае либо удалите эту запись referral, либо добавьте одну запись с базовым DN, на который ссылается referral, в пустой каталог.
Также данная ошибка может возникнуть, если slapd не может получить доступ к своим базам данных из-за проблем с правами на файлы. Например, в системе Red Hat Linux slapd запускается от имени пользователя 'ldap'. Если при создании базы данных с нуля slapadd был запущен от root, файлы в директории /var/lib/ldap будет созданы с владельцем и группой root и правами 600, делая тем самым содержимое каталога недоступным для сервера slapd.
C.1.3. ldap_*: Can't chase referral (невозможно последовать по ссылке)
Причиной этого является строка
referral ldap://root.openldap.org
в slapd.conf. В оригинальном файле данная строка помещена как пример использования объектов referrals. Однако, если Ваша машина не подключена к Internet постоянно, она не сможет найти этот сервер, и, как следствие, выводит данное сообщение об ошибке.
Чтобы решить эту проблему, просто поместите # в начало данной строки и перезапустите slapd, либо направьте его на доступный сервер LDAP.
Смотрите также ldapadd(1), ldapmodify(1) и slapd.conf(5)
C.1.4. ldap_*: server is unwilling to perform (сервер не желает выполнять)
slapd вернёт ошибку unwilling to perform, если механизм манипуляции данными, содержащий целевую запись, не поддерживает запрошенную операцию.
Механизм манипуляции данными password может выполнять только поиски. Он будет возвращать ошибку unwilling to perform для всех остальных операций.
Механизм манипуляции данными shell является настраиваемым и может поддерживать ограниченное подмножество операций. Проверьте также другие ошибки, свидетельствующие о нехватке ресурсов, необходимых для сервера каталогов, например, у Вас может быть переполнен диск и т.п.
C.1.5. ldap_*: Insufficient access (недостаточные полномочия доступа)
Эта ошибка возникает, когда сервер запрещает операцию из-за недостаточных прав доступа. Обычно это происходит из-за подключения от имени DN, не обладающего достаточными привилегиями для выполнения операции (либо анонимного подключения).
Для получения полного доступа Вы можете подсоединиться от имени rootdn/rootpw, указанных в slapd.conf(5). В противном случае, Вы должны выполнять подключение от имени записи, которой предоставлены соответствующие права при настройке контроля доступа.
C.1.6. ldap_*: Invalid DN syntax (неверный синтаксис DN)
Целевой (или другой) DN операции является неверным. Это означает, что либо строковое представление DN не соответствует требуемой форме, один из типов в утверждениях значений атрибута не определён, либо одно из значений в утверждениях значений атрибута не соответствует требуемому синтаксису.
C.1.7. ldap_*: Referral hop limit exceeded (превышен лимит перехода по ссылкам)
Обычно эта ошибка возникает, когда клиент переходит по ссылке на сервер, который в свою очередь возвращает ему ссылку обратно на тот сервер, с которым он уже связывался. Этот сервер вновь отвечает также, как и в прошлый раз, и клиент зацикливается. Зацикливание обнаруживается, когда превышается лимит переходов.
Чаще всего причиной этого является неправильная настройка ссылки по умолчанию сервера. Ссылка по умолчанию не должна указывать на сам сервер, то есть на сервере ldap://myldap/ ссылка по умолчанию не должна указывать на ldap://myldap/ (или любое имя хоста/ip-адрес, эквивалентный myldap).
C.1.8. ldap_*: operations error (операционная ошибка)
В некоторых версиях slapd(8), ошибка operationsError выдавалась вместо других.
C.1.9. ldap_*: other error (другая ошибка)
В результате выполнения операции был возвращен нестандартный код неудачного завершения, свидетельствующий о внутренней ошибке. Возможно, проблему прояснит дополнительная информация, предоставляемая с кодом возврата, однако, скорее всего, придётся просматривать файлы журнала сервера.
C.1.10. ldap_add/modify: Invalid syntax (неверный синтаксис)
Сообщение об этой ошибке поступает, когда значение атрибута не соответствует ограничениям синтаксиса. Обычно в сопутствующей дополнительной информации даётся указание, какое значение и какого именно атрибута определено как неверное. Дважды проверьте это значение и другие значения, поскольку сервер выдаёт сообщение только о первой найденной им ошибке.
Типичные причины возникновения:
- посторонние пробелы (особенно конечные пробелы);
- символы в неправильной кодировке (LDAPv3 использует кодировку Unicode UTF-8);
- пустые значения (лишь немногие синтаксисы позволяют оставлять значения пустыми).
Для некоторых синтаксисов, таких как OBJECT IDENTIFIER (OID), данная ошибка свидетельствует о том, что предоставленный дескриптор ("короткое название") OID не распознан. Например, данная ошибка возвращается, если предоставленное значение objectClass не распознано.
C.1.11. ldap_add/modify: Object class violation (нарушение объектного класса)
Данная ошибка возвращается, когда добавляемая или изменяемая запись нарушает правила схемы объектного класса. Обычно в сопутствующей дополнительной информации данное нарушение детализируется. Ниже приведены некоторые информационные сообщения и описание причин их появления.
Нарушения, связанные с атрибутами записей:
Attribute not allowed (атрибут не разрешён)
Предоставленный атрибут не разрешён объектным классом (классами) записи.
Missing required attribute (отсутствует необходимый атрибут)
Атрибут, обязательный для объектного класса (классов) записи, не был предоставлен.
Нарушения, связанные с классом (классами) записи:
Entry has no objectClass attribute (у записи нет атрибута objectClass)
В записи не указано, к какому объектному классу она принадлежит.
Unrecognized objectClass (objectClass не распознан)
Одно (или несколько) из перечисленных значений атрибута objectClass не распознано.
No structural object class provided (не предоставлен структурный объектный класс)
Ни одно из перечисленных значений атрибута objectClass не является структурным объектным классом.
Invalid structural object class chain (неверная цепочка структурного объектного класса)
Два или более структурных объектных класса в значениях атрибута objectClass не принадлежат одной и той же цепочке структурного объектного класса.
Structural object class modification (изменение структурного объектного класса)
Попытка изменить структурный объектный класс записи в ходе операции модификации.
Instanstantiation of abstract objectClass (экземпляр абстрактного объектного класса).
Абстрактный класс не подчиняется ни одному из перечисленных структурных или вспомогательных классов.
Invalid structural object class (неверный структурный объектный класс)
Другая проблема со структурным объектным классом.
No structuralObjectClass operational attribute (нет операционного атрибута structuralObjectClass)
Данное сообщение обычно возвращается, когда теневой сервер предоставляет запись, не содержащую операционного атрибута structuralObjectClass.
Имейте в виду, что приведённые выше сообщения об ошибке и их описания предполагают наличие базовых знаний о схемах LDAP/X.500.
C.1.12. ldap_add: No such object (нет такого объекта)
Ошибка "ldap_add: No such object" обычно возвращается, когда не существует родительской записи для той записи, которую хотят добавить. Сначала добавьте родительскую запись...
Например, если при добавлении "cn=bob,dc=domain,dc=com" Вы получаете:
ldap_add: No such object
похоже, что запись "dc=domain,dc=com" не существует. Проверьте, существует ли она, с помощью ldapsearch:
ldapsearch -b 'dc=domain,dc=com' -s base '(objectclass=*)'
Если нет, добавьте её. Если нужна помощь, обратитесь к Руководству по быстрому развёртыванию и началу работы.
Примечание: если добавляемая запись совпадает с суффиксом базы данных, наличие родительской записи не требуется. Например, если Ваш суффикс — "dc=domain,dc=com", для добавления "dc=domain,dc=com" не требуется наличия "dc=com".
Также данная ошибка возникает, когда Вы пытаетесь добавить какую-либо запись, на хранение которой Ваш сервер не сконфигурирован.
Например, если суффикс Вашей базы данных — "dc=domain,dc=com" и Вы попытаетесь добавить "dc=domain2,dc=com", "dc=com", "dc=domain,dc=org", "o=domain,c=us", или какой либо другой DN в поддереве "dc=domain,dc=com" (не добавив предварительно саму эту запись), сервер вернёт ошибку "No such object" (либо отсылку).
slapd(8) обычно возвращает "no global superior knowledge" в качестве дополнительной информации, указывая, почему он вернул noSuchObject вместо отсылки. То есть в настройках сервера не было дано информации о глобальном вышестоящем сервере.
C.1.13. ldap add: invalid structural object class chain (неверная цепочка структурного объектного класса)
Данная ошибка относится к правилу о СТРУКТУРНЫХ объектных классах, которое утверждает, что объект может иметь только один СТРУКТУРНЫЙ класс, структурный класс данного объекта. Говорят, что объект принадлежит этому классу, нулю или более вспомогательным классам и их суперклассам.
Хотя все эти классы обычно перечислены в атрибуте objectClass записи, один из этих классов является структурным объектным классом записи. Таким образом, считается нормальным для атрибута objectClass иметь значения inetOrgPerson, organizationalPerson и person, поскольку они наследуются один от другого в форме одной цепочки суперкласса. То есть, inetOrgPerson наследуется от organizationPerson, который в свою очередь наследуется от person. С другой стороны, неверным будет перечислить в атрибуте objectClass сразу inetOrgPerson и account, поскольку inetOrgPerson и account не являются частью одной и той же цепочки суперкласса (если только вместе с ними не перечислен какой-то другой класс, являющийся подклассом от обоих).
Для решения этой проблемы необходимо определить, какой из классов будет лучше использовать в качестве структурного объектного класса для данной записи, добавить этот класс в атрибут objectClass (если он ещё не добавлен), и убрать из атрибута objectClass записи все остальные структурные классы, не являющиеся суперклассом для данного структурного объектного класса.
Какой объектный класс лучше использовать, зависит от конкретной ситуации. В общем случае, нужно проконсультироваться с документацией по тому приложению, которое использует данный объект из Вашего каталога. Скорее всего, это поможет сделать выбор.
C.1.14. ldap_add: no structuralObjectClass operational attribute (нет операционного атрибута structuralObjectClass)
ldapadd(1) может выдать ошибку:
adding new entry "uid=XXX,ou=People,o=campus,c=ru" ldap_add: Internal (implementation specific) error (80) additional info: no structuralObjectClass operational attribute
если slapd(8) не может определить на основании содержимого атрибута objectClass, какой должен быть структурный объектный класс.
C.1.15. ldap_add/modify/rename: Naming violation (нарушение именования)
OpenLDAP slapd проверяет целостность атрибутов именования и отличительных значений в соответствии с RFC4512(рус.).
Атрибуты именования — это атрибуты тех типов, которые присутствуют в RDN записи; отличительные значения — это значения атрибутов именования, которые присутствуют в RDN записи, например, в записи
cn=Someone+mail=someone@example.com,dc=example,dc=com
атрибуты именования — cn и mail, а отличительные значения — Someone и someone@example.com.
OpenLDAP slapd проверяет целостность когда:
- добавляется запись;
- изменяется запись, если при этом изменяются значения атрибутов именования;
- переименовывается запись, если при этом изменяется RDN записи.
Возможные причины появления ошибки:
- атрибуты именования не присутствуют в записи, например:
dn: dc=example,dc=com objectClass: organization o: Example # обратите внимание: "dc: example" пропущено
- атрибуты именования присутствуют в записи, но те типы атрибутов, которыми они определены, помечены как:
- коллективные;
- операционные;
- устаревшие.
- атрибуты именования присутствуют в записи, а отличительные значения — нет, например:
dn: dc=example,dc=com objectClass: domain dc: foobar # обратите внимание: "dc" присутствует, но его значение не "example"
- атрибуты именования присутствуют в записи вместе с отличительными значениями, но атрибуты именования:
- не имеют поля равенства (equality field), вследствие чего невозможно утверждать равенство;
- не поддерживают правило соответствия (возможно, пока);
- не удовлетворяют правилу соответствия.
- предоставленные отличительные значения не соответствуют установленному для них синтаксису.
- другие ошибки, возникающие в процессе проверки/нормализации/сравнения; даже если Вам не подошел ни один из описанных выше вариантов, ситуация может проясниться при просмотре файлов журнала.
В любом случае, убедитесь, что определение типа атрибута для атрибута именования содержит соответствующее поле EQUALITY; либо же поле EQUALITY содержит вышестоящий тип атрибута, если определение данного типа атрибута основано на вышестоящем типе (смотрите поле SUP). Подробности можно найти в RFC4512(рус.).
C.1.16. ldap_add/delete/modify/rename: no global superior knowledge (нет сведений о глобальной вышестоящей части дерева)
Если имя целевой записи указывает, что она должна быть размещена в поддереве, на обслуживание которого не настроена ни одна из баз данных сервера, и, при этом, у сервера нет сведений о глобальной вышестоящей части дерева, сервер покажет, что он не желает выполнять операцию и выдаст "no global superior knowledge" в качестве дополнительного текста.
Возможно, допущена ошибка в имени записи, либо сервер должен хранить записи с таким именем, но был неверно настроен, либо, если каталог распределённый, не была настроена отсылка по умолчанию.
C.1.17. ldap_bind: Insufficient access (недостаточные полномочия доступа)
В текущих версиях slapd(8) перед тем, как допустить клиентов к выполнению операции подключения, требуется, чтобы у них были права на аутентификацию к тем типам атрибутов, которые используются в целях аутентификации. Поскольку все операции подключения выполняются анонимно (независимо от предыдущих успешных подключений), пользователю anonymous должны быть предоставлены права доступа auth.
В приведённом ниже примере ACL предоставляются следующие права доступа:
- анонимным пользователям:
- права на прохождение аутентификации с использованием значений атрибута userPassword
- аутентифицированным пользователям:
- права на обновление (но не чтение) своих собственных значений атрибута userPassword
- права на чтение любого объекта, за исключением значений атрибута userPassword
Весь остальной доступ запрещён.
access to attr=userPassword by self =w by anonymous auth access * by self write by users read
C.1.18. ldap_bind: Invalid credentials (неверные учётные данные)
Данная ошибка обычно возникает, когда предоставленные учётные данные (пароль) не совпадают с хранимыми в атрибуте userPassword той записи, от имени которой Вы пытаетесь подключиться.
Также данная ошибка может возникнуть, когда указанный при подключении DN неизвестен тому серверу, к которому Вы пытаетесь подключиться.
Проверьте и то, и другое! Кроме двух вышеуказанных причин, проверьте также, не запрещён ли доступ к атрибутам userPassword в выбранной части каталога. Фактически, slapd всегда возвращает "Invalid credentials" в случае неудачной попытки подключения, независимо от причины неудачи, поскольку другие коды возврата могут помочь злоумышленнику выяснить, правильное ли имя пользователя он предоставляет.
Для отладки правил доступа, определённых в slapd.conf, добавьте уровень журналирования "ACL".
C.1.19. ldap_bind: Protocol error (ошибка протокола)
Данная ошибка обычно возникает, когда запрашиваемая клиентом версия LDAP не поддерживается сервером.
Сервер OpenLDAP 2.x по умолчанию принимает запросы на подсоединение только LDAP версии 3, но может быть настроен для приёма запросов на подсоединение LDAP версии 2.
Примечание: если клиент запрашивает 3-ю версию протокола, сервер OpenLDAP 2.x ожидает, что будет использоваться LDAPv3 [RFC4510], если же запрашивается 2-я версия протокола, сервер ожидает, что будет использоваться ограниченный вариант LDAPv3 (в основном, синтаксис и семантика LDAPv3 в PDU LDAPv2).
Данный вариант также иногда называется LDAPv2+. Он отличается от U-Mich варианта LDAP в ряде направлений.
C.1.20. ldap_modify: cannot modify object class (не могу изменить объектный класс)
Данное сообщение обычно возвращается, когда предпринята попытка изменения атрибута objectClass способом, несовместимым с информационной моделью LDAP/X.500. На практике, такая ошибка обычно возникает, когда кто-то пытается изменить структуру объекта с одного класса на другой, например, пытается поменять 'яблоко' на 'грушу' или 'фрукт' на 'грушу'.
slapd(8) не допускает такие изменения в соответствии с ограничениями LDAP и X.500.
C.1.21. ldap_sasl_interactive_bind_s: ...
Если Вы хотели подсоединиться, используя DN и пароль, и получили ошибку из семейства ldap_sasl_interactive_bind_s, возможно, Вы просто забыли указать команде аргумент '-x'. По умолчанию используется SASL-аутентификация. Для выбора простой ("simple") аутентификации требуется аргумент '-x'.
C.1.22. ldap_sasl_interactive_bind_s: No such Object (нет такого объекта)
Данное сообщение указывает на то, что функция SASL-аутентификации LDAP не может прочитать Root DSE. Эта ошибка возникает, когда сервер не предоставляет root DSE. Такое может происходить из-за ограничений контроля доступа.
C.1.23. ldap_sasl_interactive_bind_s: No such attribute (нет такого атрибута)
Данное сообщение указывает на то, что функция SASL-аутентификации LDAP может прочитать Root DSE, но эта запись не содержит атрибута supportedSASLMechanism.
В атрибуте supportedSASLmechanism перечисляются механизмы, доступные в настоящее время. Данный список может быть пустым, если ни один из поддерживаемых механизмов в данный момент не доступен. Например, EXTERNAL перечисляется, только если клиент установил свою идентичность с помощью аутентификации на более низком уровне (например, TLS).
Примечание: данный атрибут может быть невидим из-за ограничений контроля доступа
Примечание: подсоединение с использованием SASL применяется по умолчанию для всех инструментов OpenLDAP, таких как ldapsearch(1), ldapmodify(1). Чтобы принудительно использовать подсоединение "simple", воспользуйтесь аргументом "-x". Использование подсоединения "simple" не рекомендовано, если не предприняты адекватные меры по защите конфиденциальности (такие, как TLS/SSL, IPSEC).
C.1.24. ldap_sasl_interactive_bind_s: Unknown authentication method (неизвестный метод аутентификации)
Данное сообщение указывает, что ни один из поддерживаемых сервером механизмов аутентификации SASL не поддерживается клиентом, либо они слишком слабы, либо по иной причине не подходят для использования клиентом. Имейте в виду, что параметры безопасности по умолчанию запрещают использование определённых механизмов, таких как ANONYMOUS и PLAIN (без TLS).
Примечание: подсоединение с использованием SASL применяется по умолчанию для всех инструментов OpenLDAP, таких как ldapsearch(1), ldapmodify(1). Чтобы принудительно использовать подсоединение "simple", воспользуйтесь аргументом "-x". Использование подсоединения "simple" не рекомендовано, если не предприняты адекватные меры по защите конфиденциальности (такие, как TLS/SSL, IPSEC).
C.1.25. ldap_sasl_interactive_bind_s: Local error (82) (локальная ошибка)
Возможная причина возникновения этой ошибки — отсутствие прямой и обратной записи DNS для сервера LDAP.
C.1.26. ldap_search: Partial results and referral received (получены частичные результаты и отсылка)
Данная ошибка возвращается, если при ответе на поисковый запрос LDAPv2 сервер возвращает сразу и результаты (ноль или более совпавших записей), и ссылки (отсылки на другие серверы). Смотрите также ldapsearch(1).
Если при операции обновления реплики на ней не существует записи, которую требуется обновить (updatedn), будет возвращена отсылка. Также это может произойти, если ACL требует корректировки.
C.1.27. ldap_start_tls: Operations error (ошибка операций)
ldapsearch(1) и другие инструменты возвращают
ldap_start_tls: Operations error (1) additional info: TLS already started
когда пользователь (с помощью аргументов командной строки и/или файла ldap.conf(5)) запрашивает второй раз запустить TLS (SSL). Например, когда указываются сразу и "-H ldaps://server.do.main" и "-ZZ".
C.2. Другие ошибки
C.2.1. ber_get_next on fd X failed errno=34 (Numerical result out of range) (числовой результат за границей диапазона)
Данная ошибка slapd обычно указывает на то, что клиент отправил сообщение, превысившее административное ограничение. Смотрите директивы конфигурации sockbuf_max_incoming и sockbuf_max_incoming_auth в slapd.conf(5).
C.2.2. ber_get_next on fd X failed errno=11 (Resource temporarily unavailable) (ресурс временно недоступен)
Это сообщение не указывает на ненормальное поведение или ошибку. Оно просто означает, что ожидаемые данные еще не доступны из запрошенного ресурса, в запрошенном контексте, либо из запрошенного сетевого сокета. slapd(8) обработает данные, как только они станут доступны.
C.2.3. daemon: socket() failed errno=97 (Address family not supported) (семейство адресов не поддерживается)
Это сообщение указывает на то, что операционная система не поддерживает одно из семейств адресов (протоколов), на поддержку которого настроен slapd(8). Чаще всего это происходит, когда slapd(8) настраивался на поддержку IPv6, а ядро операционной системы — нет. В таких случаях данное сообщение можно проигнорировать.
C.2.4. GSSAPI: gss_acquire_cred: Miscellaneous failure; Permission denied; (различные сбои; доступ запрещён)
Это сообщение означает, что slapd был запущен не с правами root, и поэтому не может получить свой ключ Kerberos 5 из keytab, обычно файл /etc/krb5.keytab.
Файл keytab используется для хранения ключей, которые требуются сервисам и демонам, запускающимся во время загрузки. Очень важно хранить эти секретные сведения вне досягаемости злоумышленников.
Поэтому по умолчанию владельцем файла keytab является root, а для всех остальных чтение этого файла не разрешено. Не следует ослаблять эти ограничения на права. Вместо этого создайте другой файл keytab для slapd и убедитесь, что владельцем его является тот пользователь, с правами которого запускается slapd.
Чтобы это сделать, запустите kadmin и введите следующие команды:
addprinc -randkey ldap/ldap.example.com@EXAMPLE.COM ktadd -k /etc/openldap/ldap.keytab ldap/ldap.example.com@EXAMPLE.COM
Затем, перейдя в оболочку, сделайте:
chown ldap:ldap /etc/openldap/ldap.keytab chmod 600 /etc/openldap/ldap.keytab
Теперь нужно сообщить slapd (ну, на самом деле сообщить библиотеке gssapi Kerberos 5, вызываемой Cyrus SASL), где найти новый keytab. Сделайте это путём задания переменной окружения KRB5_KTNAME примерно так:
export KRB5_KTNAME="FILE:/etc/openldap/ldap.keytab"
Задайте эту переменную окружения в скрипте запуска slapd (на Red Hat лучше задать её в более подходящем месте /etc/sysconfig/ldap).
Всё это работает, только если Вы используете MIT kerberos. Это не будет работать, к примеру, с Heimdal.
В Heimdal есть функция gsskrb5_register_acceptor_identity(), устанавливающая путь к файлу keytab, который Вы хотите использовать. В Cyrus SASL 2 для использования данной функции Вы можете добавить
keytab: /path/to/file
в конфигурационный файл SASL Вашего приложения. Это работает только с Heimdal.
C.2.5. access from unknown denied (запрещён доступ от неизвестного)
Появление сообщения "access from unknown denied" в файле журнала связано с TCP wrappers. Дополнительную информацию смотрите в hosts_access(5). Чтобы избавиться от этой ошибки, Вы можете, например, добавить строку "slapd: .hosts.you.want.to.allow" в /etc/hosts.allow.
C.2.6. ldap_read: want=# error=Resource temporarily unavailable (ресурс временно недоступен)
Появление данного сообщения является нормальным. Это означает, что необходимые данные еще не доступны из запрошенного ресурса, либо из запрошенного сетевого сокета. slapd(8) обработает данные, как только они станут доступны.
C.2.7. `make test' fails (`make test' завершился неудачей)
Иногда `make test' завершается неудачей на самых ранних тестах с невразумительным сообщением вроде такого:
make test make[1]: Entering directory `/ldap_files/openldap-2.4.6/tests' make[2]: Entering directory `/ldap_files/openldap-2.4.6/tests' Initiating LDAP tests for BDB... Cleaning up test run directory leftover from previous run. Running ./scripts/all... >>>>> Executing all LDAP tests for bdb >>>>> Starting test000-rootdse ... running defines.sh Starting slapd on TCP/IP port 9011... Using ldapsearch to retrieve the root DSE... Waiting 5 seconds for slapd to start... ./scripts/test000-rootdse: line 40: 10607 Segmentation fault $SLAPD -f $CONF1 -h $URI1 -d $LVL $TIMING >$LOG1 2>&1 Waiting 5 seconds for slapd to start... Waiting 5 seconds for slapd to start... Waiting 5 seconds for slapd to start... Waiting 5 seconds for slapd to start... Waiting 5 seconds for slapd to start... ./scripts/test000-rootdse: kill: (10607) — No such pid ldap_sasl_bind_s: Can't contact LDAP server (-1) >>>>> Test failed >>>>> ./scripts/test000-rootdse failed (exit 1) make[2]: *** [bdb-yes] Error 1 make[2]: Leaving directory `/ldap_files/openldap-2.4.6/tests' make[1]: *** [test] Error 2 make[1]: Leaving directory `/ldap_files/openldap-2.4.6/tests' make: *** [test] Error 2
Обычно, пять строк:
Waiting 5 seconds for slapd to start...
указывают на то, что slapd вообще не запустился.
В tests/testrun/slapd.1.log есть полный отчёт о том, что выдавал slapd во время попыток запуска. Уровень журналирования может быть повышен путём задания переменной окружения SLAPD_DEBUG в соответствующее значение; о том, что означают различные уровни журналирования, смотрите loglevel в slapd.conf(5).
Типичная причина такого поведения — проблема компоновки времени исполнения, то есть slapd не может найти некоторые динамические библиотеки, для работы с которыми он скомпонован. Попробуйте запустить ldd(1) на slapd (для тех архитектур, которые поддерживают компоновку времени исполнения).
Также могут быть и другие причины; содержимое файла журнала должно прояснить их.
Тесты, запускающие сразу несколько экземпляров slapd обычно помещают отчёты в tests/testrun/slapd.<n>.log, с различным <n> для каждого экземпляра slapd; такие тесты просматривают tests/testrun/ для назначения возможного значения <n>.
C.2.8. ldap_*: Internal (implementation specific) error (80) — additional info: entry index delete failed (внутренняя ошибка, зависящая от конкретной реализации, дополнительная информация: не удалось удалить индекс записи)
Возможно, это связано с неправильной принадлежностью директории BDB (/var/lib/ldap) и файлов в ней. Эти файлы должны принадлежать пользователю, с правами которого запускается slapd.
chown -R ldap:ldap /var/lib/ldap
устраняет данную ошибку в Debian.
C.2.9. ldap_sasl_interactive_bind_s: Can't contact LDAP server (-1) (не могу соединиться с сервером LDAP)
При использовании SASL, когда клиент соединяется с сервером LDAP, сервис slapd немедленно аварийно завершает работу и клиент получает сообщение об ошибке:
SASL/GSSAPI authentication started ldap_sasl_interactive_bind_s: Can't contact LDAP server (-1)
Если проверить сервис slapd, он окажется остановленным.
Это может произойти из-за использования различных несовместимых между собой версий BerkeleyDB при установке SASL и установке OpenLDAP. Проблема возникает при использовании нескольких версий BerkeleyDB. Решение: проверьте, какая версия BerkeleyDB использовалась при установке Cyrus SASL.
Переустановите OpenLDAP с нужной версией BerkeleyDB.