При использовании Google Cloud Directory Sync (GCDS) вы можете столкнуться со следующими сообщениями об ошибках. Воспользуйтесь таблицей ниже для устранения неполадок.
Попробуйте анализатор логов
Этот инструмент способен выявить большинство проблем в течение нескольких мгновений после отправки запроса.
- Отправьте свои журналы трассировки (в несжатом виде или в формате ZIP) в анализатор журналов Google Admin Toolbox .
- Для углубленного анализа логов отправляйте несжатые файлы в Log Analyzer 2 .
Получите подробную информацию о том, как включить трассировочное логирование .
Сообщения об ошибках и способы их устранения
| Сообщение об ошибке | Описание и решение |
|---|---|
Проблема с сетью: Не удалось подключиться к указанному LDAP-серверу: сбой простой привязки: servername:636, причина: SSLHandshakeException - Отсутствуют альтернативные имена субъекта. Проблема с сетью: Не удалось подключиться к указанному LDAP-серверу: сбой простой привязки: servername:636, причина: SSLHandshakeException - Не найдено альтернативное DNS-имя субъекта, соответствующее servername. | Общее имя (CN) и альтернативное имя субъекта (SAN) сертификата не совпадают с именем LDAP-сервера в вашем конфигурационном файле GCDS. Чтобы это исправить, можно сделать следующее:
В качестве временного решения можно отключить идентификацию конечных точек, добавив новую строку в файлы config-manager.vmoptions и sync-cmd.vmoptions в папке установки GCDS. Удалите разрыв строки перед добавлением в файлы: -Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true |
sun.security.provider.certpath.SunCertPathBuilder Exception: не удалось найти действительный путь сертификации к запрошенному целевому объекту Функция ldap_simple_bind_s() завершилась с ошибкой: Требуется надежная аутентификация. | Выполните действия, описанные в разделе «Устранение неполадок, связанных с сертификатами» . |
| InvalidCipherTextException: Недопустимые параметры шифрования. Соль/Итерация/Вектор инициализации | Если вы используете GCDS на компьютере без графического интерфейса, возможно, вы неправильно импортировали ключ. Инструкции см. в разделе «Как авторизовать GCDS на компьютере без графического интерфейса?». |
| java.lang.RuntimeException: Обнаружена неустранимая ошибка SQLException. В базе данных состояния указан " путь к папке \syncState\ имя папки " | Найдите и удалите папку, указанную в сообщении. Затем запустите синхронизацию заново. |
| java.sql.SQLException: Неверная контрольная сумма на странице | Ещё один процесс — это одновременный доступ к папке или файлам кэша и GCDS. Для устранения неполадок загрузите и запустите Process Monitor от Microsoft и создайте фильтр. В параметрах фильтра используйте Path , Contains и path-to-folder \syncState, чтобы определить процессы, которые обращаются к папке или файлам. Для получения более подробной информации перейдите в раздел «Монитор процессов» . |
| Неверный ввод: запрос | В поле «Поисковый запрос пользователей» вы ввели недопустимый запрос. Удалите поисковый запрос или убедитесь, что он соответствует рекомендациям по поиску пользователей . Для получения дополнительной информации о поисковых запросах пользователей перейдите в раздел «Исключение данных с помощью правил и запросов исключения» . |
| SocketException - Соединение сброшено | Если при подключении к LDAP-серверу вы получаете это сообщение, значит, сервер разорвал соединение. Возможные причины:
|
| Замок не удалось получить в запрошенные сроки. | Для устранения этой проблемы:
|
| Ошибка 400: invalid_request: В используемой вами версии приложения отсутствуют новейшие функции безопасности для защиты. Пожалуйста, убедитесь, что вы загружаете приложение из надежного источника и обновляете его до последней, наиболее безопасной версии. | Убедитесь, что вы используете последнюю версию GCDS. Подробности см. в разделе «Обновление GCDS» . |
| java.sql.SQLException: Невозможно создать каталог <directory>. | Для ведения базы данных состояния синхронизации GCDS требуются полные права доступа к каталогу. Эта ошибка может появиться, если:
|
| org.jdom.input. JDOMParseException: Ошибка в строке 1: Содержимое в прологе недопустимо | GCDS пытается загрузить файл конфигурации с неподдерживаемой кодировкой символов. GCDS использует UTF-8 в качестве кодировки символов по умолчанию. Вам следует использовать ту же кодировку для файлов конфигурации, хотя другие кодировки также совместимы. Для решения этой проблемы:
Наиболее распространенными неподдерживаемыми кодировками являются UTF-7 и UTF-8 BOM. |
| javax.net.ssl. SSLHandshakeException: соединение во время рукопожатия | Проблема с сетевым подключением помешала GCDS завершить процедуру установления SSL-соединения с сервером Google. Причиной этой проблемы может быть слишком медленная маршрутизация пакетов компьютером или временное отключение интернет-провайдера. GCDS пытается завершить SSL-рукопожатие до 3 раз. Если в логах вы видите следующее сообщение, значит, GCDS успешно завершил рукопожатие при последующих попытках, и никаких дальнейших действий не требуется: [usersyncapp.sync.FullSyncAgent] Различий не обнаружено, никаких изменений не требуется. Обратитесь к локальному сетевому администратору, чтобы выяснить, что может вызывать сетевые таймауты. |
| Квота для текущего запроса превышена. | Если в логах появляется эта ошибка, это означает, что GCDS временно заблокирован для использования API Google. GCDS повторит попытку подключения к API, и синхронизация должна продолжиться, как и ожидалось. Если в отчете о синхронизации отображается ошибка и синхронизация не завершилась корректно, обратитесь в службу поддержки. Для получения более подробной информации перейдите по ссылке «Какая информация GCDS мне нужна перед обращением в службу поддержки?». |
| java.lang.RuntimeException: Неизвестная область действия правила поиска LDAP: "null" | В одном из следующих разделов Configuration Manager отсутствует правило:
Для получения более подробной информации перейдите в раздел «Настройка синхронизации с Configuration Manager» . |
| Недопустимая длина дайджеста для пароля. | Метод шифрования паролей для синхронизации паролей настроен некорректно в Configuration Manager, или ваш LDAP-сервер использует метод шифрования, не поддерживаемый GCDS. Поддерживаемые методы: обычный текст, Base64, MD5 и SHA1. Для синхронизации паролей с Microsoft Active Directory используйте функцию синхронизации паролей . Для получения более подробной информации перейдите в разделы «Как вы будете синхронизировать пароли?» и «Обновить GCDS» . |
| 0 вложенных групп | GCDS некорректно различает пользователей и вложенные группы на вашем LDAP-сервере. Для решения этой проблемы:
|
| Приостановить действие учетной записи пользователя | GCDS может попытаться внести неожиданные изменения, если вы выполните синхронизацию с файлом конфигурации, который был скопирован вне Configuration Manager. Новый файл конфигурации обращается к тому же кэшу, что и исходный файл конфигурации, и несоответствия между ними могут привести к блокировке пользователей. Для создания копии файла конфигурации GCDS всегда используйте опцию «Сохранить как» в диспетчере конфигураций. Это гарантирует, что новый файл конфигурации будет иметь собственный кэш. Для получения более подробной информации перейдите в раздел «Работа с конфигурационными файлами» . |
| Пропуск неизвестного участника | Вы используете устаревший XML-файл конфигурации GCDS, и GCDS обнаружил участника группы, который не включен в правила поиска пользователей в вашей конфигурации. Вам следует включить всех участников группы и владельцев в правила поиска пользователей, даже если вы не хотите синхронизировать этих пользователей с доменом Google. GCDS необходимо извлечь адреса электронной почты этих пользователей для корректной обработки групп. В качестве альтернативы создайте новый пустой XML-файл конфигурации. В этом случае GCDS включит независимую синхронизацию групп, которая заставит GCDS определять членов группы независимо от правил синхронизации пользователей. Если вы не уверены, это рекомендуемый вариант. При внесении любых изменений в конфигурацию или создании нового конфигурационного файла обязательно проведите моделирование и проанализируйте результаты, прежде чем запускать полную синхронизацию. Для получения более подробной информации перейдите в раздел «Определение списка пользователей» . |
| com.google.data.client. GoogleServiceException: Неверные учетные данные | Указанная вами в Configuration Manager учетная запись администратора не является учетной записью администратора, или же имя пользователя и пароль указаны неверно. В диспетчере конфигураций перейдите в раздел «Домен Google» . Для получения более подробной информации перейдите в раздел «Настройка параметров вашего домена Google» . |
| com.google.gdata.util. ResourceNotFoundException: | Атрибут ключа синхронизации, указанный в разделе «Общие контакты» диспетчера конфигурации, возвращает пустые значения с вашего LDAP-сервера. Выберите атрибут на LDAP-сервере, который содержит значение ключа синхронизации для каждого ресурса и никогда не возвращает значение null или пустую строку. |
| Вычисленные различия превышают настроенные ограничения на удаление, не вносить изменения | Достигнут лимит удаления или приостановки, установленный в GCDS. Измените параметр «Лимит удаления» в GCDS, чтобы избежать этой ошибки, или просмотрите журнал синхронизации для получения более подробной информации о том, что было бы удалено или приостановлено, и решите, нужно ли изменить лимит. |
| InvalidEmail | GCDS пытается создать пользователя или псевдоним электронной почты, существующий в домене, который не является частью вашей учетной записи Google. Попробуйте следующие варианты:
|
| Достигнут лимит пользователей домена. | GCDS синхронизирует больше пользователей, чем предусмотрено вашей учетной записью. Попробуйте следующие варианты:
|
| java.lang.RuntimeException: javax.naming.InvalidNameException: [LDAP: код ошибки 34 - недопустимый DN] | Базовое DN, указанное в Configuration Manager, может указывать на объект, которого нет на вашем LDAP-сервере. Проверьте базовое DN, указанное в разделах фильтров LDAP-подключения, пользователей, групп, профилей и общих контактов. Убедитесь, что в качестве базового DN для каждого из них используется существующий объект. |
| java.security.cert. CertPathValidatorException: Проверка статуса отзыва не пройдена: CRL не найден | Другая служба или сетевое устройство препятствует связи GCDS с центром сертификации HTTPS-сертификата, используемого для API. Проверьте правила брандмауэра или прокси-сервера, которые могут ограничивать подключения с машины, на которой запущен GCDS. Если для доступа к веб-сайту с компьютера, на котором запущен GCDS, требуется прокси-сервер, его необходимо правильно настроить. Для решения этой проблемы можно отключить проверку списка отзыва сертификатов (CRL). Чтобы отключить проверку CRL, добавьте следующие строки в файлы config-manager.vmoptions и sync-cmd.vmoptions в каталоге установки GCDS: Для получения более подробной информации перейдите по ссылке «Как GCDS проверяет списки аннулированных сертификатов» . |
| javax.naming.directory. InvalidSearchFilterException: Несбалансированная скобка; оставшаяся часть имени | Запросы, указанные на одной или нескольких из следующих страниц Configuration Manager, не имеют сбалансированных скобок:
|
| Основная ошибка связана с javax.naming. CommunicationException: имя сервера : 389 | GCDS не может разрешить указанное имя LDAP-сервера. Убедитесь, что вы ввели полное доменное имя для LDAP-сервера, и проверьте, что компьютер, на котором запущен GCDS, может его разрешить. Примечание: При использовании Active Directory в качестве имени сервера используйте полное доменное имя вашего домена. |
| SSL-соединение завершилось некорректно. | Проблема обычно возникает из-за того, что трафик принудительно проходит через прокси-сервер. Если вы используете прокси, вам необходимо настроить параметры прокси-сервера GCDS. Убедитесь, что GCDS может подключаться к указанным URL-адресам и портам, выполнив действия, описанные в разделе «Разрешить доступ к URL-адресам и портам» . Программы безопасности на локальном компьютере могут вызывать проблемы с подключением. Попросите администратора отключить все программы безопасности на клиентском компьютере и попробуйте снова. |
| У вас нет разрешения на доступ к этому API. | Убедитесь, что необходимые API Google включены. Для получения более подробной информации перейдите по ссылке «Авторизуйте свой аккаунт Google» . |
| Превышен лимит пользователей домена. | Вы попытались добавить больше пользователей, чем у вас есть лицензий. Свяжитесь со своим торговым представителем, чтобы приобрести дополнительные лицензии. Или измените ваши LDAP-запросы для синхронизации меньшего количества пользователей. |
| java.lang.RuntimeException: Не удалось выполнить запрос, поскольку объект по базовому DN: "DC=domain,DC=com" отсутствует или недоступен. | Для начала проверьте DN как на вкладке «Конфигурация LDAP» , так и в любых правилах поиска, где вы определили переопределение базового DN. Если это не решит проблему, и вы уверены, что DN действителен, проблема может быть связана с разрешением DNS. В журнале могут появиться дополнительные сведения об ошибках, например:
Эти ошибки указывают на то, что хост отклоняет соединение или истекает время ожидания. Попробуйте выполнить поиск DNS для этого хоста и убедитесь, что все возвращаемые адреса действительны и разрешают соединения на настроенном вами порту. Примечание : Эти ошибки могут возникать, даже если вы указали допустимое имя хоста или IP-адрес в конфигурации GCDS. Active Directory может отправить ответ LDAP-переадресации, направляя GCDS на подключение через имя хоста. Эта переадресация в конечном итоге может вести к имени хоста, которое не удается разрешить. Вы можете избежать этих переадресаций, подключившись к серверу Active Directory через порт глобального каталога, который по умолчанию равен 3268. Для получения более подробной информации обратитесь к документации Microsoft. |
| Символ в этом месте недопустим. | Часть информации в пользовательской схеме недействительна. Чтобы проверить ограничения, применяемые к пользовательской схеме, перейдите в раздел Directory API: Пользовательские поля . Если у вас включены журналы трассировки, вы также можете просмотреть полный HTTP-запрос для пользовательской схемы. |
| java.util.concurrent. ExecutionException: java.lang.OutOfMemoryError: GC Превышен лимит накладных расходов. | Был превышен установленный лимит памяти. Это событие привело к сбою синхронизации. Для решения этой проблемы перейдите в раздел «Что делать, если я вижу ошибки, связанные с памятью?» |
| Не удалось подключиться к указанному LDAP-серверу. | GCDS не может подключиться к LDAP-серверу. Убедитесь в следующем:
|
| Проблема с сетью: Не удается подключиться к указанному LDAP-серверу. | GCDS не может найти LDAP-сервер. Убедитесь, что компьютер, на котором запущен GCDS, имеет доступ к указанному хосту и порту. |
| Проблема аутентификации: Невозможно подключиться, используя предоставленные учетные данные. | LDAP-сервер отклоняет запросы GCDS из-за проблемы с аутентификацией. Убедитесь, что авторизованный пользователь и его пароль указаны верно. Добавлять авторизованного пользователя следует, используя его полный DN. Подробную информацию о добавлении авторизованного пользователя см. в разделе «Настройки подключения LDAP» . |
| Не удалось выполнить запрос по базовому DN <base-dn> . | GCDS не может подключиться к базовому DN. Убедитесь в следующем:
|
| Не удалось выполнить запрос по базовому DN <base-dn> для атрибута: <attribute> , причина: NameNotFoundException | GCDS не удаётся получить информацию с LDAP-сервера. Убедитесь в следующем:
|
Участник уже существует | Эта ошибка может появиться, если:
Снимите флажок или измените одно из псевдонимов пользователей. Если в журналах также появляется следующее сообщение: "Ошибка при добавлении участника user-email-address в группу group-email-address из-за конфликта адресов", проверьте, не произошло ли следующее:
|
| Неверный ввод: INVALID_OU_ID | GCDS пытается привязать пользователя к организационному подразделению, которого нет в учетной записи Google вашей организации. Измените правила поиска пользователей и повторите попытку. Подробности см. в разделе «Правила поиска пользователей» . |
| Превышена квота по метрике «Запросы» и лимиту «Запросы в минуту на пользователя» для сервиса «licensing.googleapis.com» "причина": "rateLimitExceeded" | В конфигурационном XML-файле GCDS убедитесь, что значение <maxResults> установлено на 500. При необходимости измените его на 500 и повторно выполните синхронизацию. |
Связанная тема
Устранение распространенных проблем GCDS
Google, Google Workspace, а также связанные с ними знаки и логотипы являются товарными знаками Google LLC. Все остальные названия компаний и продуктов являются товарными знаками компаний, с которыми они связаны.