Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Настройкаbreadcrumb arrow Настройка управления доступомbreadcrumb arrow Настройка аутентификацииbreadcrumb arrow Интерфейс LDAP

Настройка аутентификации LDAP через пользовательский интерфейс Grafana

Эта страница объясняет, как настроить аутентификацию LDAP в Grafana через пользовательский интерфейс Grafana. Для более подробной информации о настройке аутентификации LDAP с помощью файла конфигурации см. Аутентификация LDAP.

Преимущества использования пользовательского интерфейса Grafana для настройки аутентификации LDAP включают:

  • Нет необходимости вручную редактировать файл конфигурации.
  • Быстрая проверка соединения с сервером LDAP.
  • Нет необходимости перезапускать Grafana после внесения изменений.

Note

Любые изменения конфигурации, сделанные через пользовательский интерфейс Grafana (UI), имеют приоритет над настройками, указанными в файле конфигурации Grafana или через переменные среды. Если вы измените какие-либо настройки конфигурации в интерфейсе, они переопределят любые соответствующие настройки, заданные через переменные среды или определённые в файле конфигурации.

Перед началом

Чтобы следовать этим инструкциям, вам нужно:

  • Знание аутентификации LDAP и того, как она работает.
  • Экземпляр Grafana v11.3.0 или более поздней версии.
  • Разрешения settings:read и settings:write с областью settings:auth.ldap:*.
  • Включённый переключатель функции ssoSettingsLDAP.

Шаги по настройке аутентификации LDAP

Войдите в Grafana и перейдите в Administration > Authentication > LDAP.

1. Заполните обязательные поля

Обязательные поля помечены звёздочкой (*). Заполните следующие поля:

  1. Server host: имя хоста или IP-адрес сервера LDAP.
  2. Search filter: фильтр поиска LDAP находит записи в каталоге.
  3. Search base DNS: список базовых DN для поиска.

2. Заполните необязательные поля

Заполните необязательные поля по мере необходимости:

  1. Bind DN: distinguished name (DN) пользователя для привязки.
  2. Bind password: пароль для сервера.

3. Расширенные настройки

Нажмите кнопку Edit в разделе Advanced settings, чтобы настроить следующие параметры:

1. Разные настройки

Дополнительные настройки для аутентификации LDAP.

  1. Allow sign-up: позволяет новым пользователям регистрироваться при входе.
  2. Port: номер порта сервера LDAP. По умолчанию 389.
  3. Timeout: время в секундах для ожидания ответа от сервера LDAP.

2. Атрибуты

Атрибуты, используемые для сопоставления утверждений пользователя LDAP с атрибутами пользователя Grafana.

  1. Name: имя атрибута утверждения для сопоставления с именем пользователя Grafana.
  2. Surname: имя атрибута утверждения для сопоставления с фамилией пользователя Grafana.
  3. Username: имя атрибута утверждения для сопоставления с именем пользователя (username) Grafana.
  4. Member Of: имя атрибута утверждения для сопоставления с членством пользователя Grafana.
  5. Email: имя атрибута утверждения для сопоставления с электронной почтой пользователя Grafana.

3. Сопоставление групп

Сопоставьте группы LDAP с ролями Grafana.

  1. Skip organization role sync: этот параметр предотвращает синхронизацию ролей организации. Он полезен, когда вы хотите управлять ролями вручную.

  2. Group search filter: фильтр поиска LDAP находит группы в каталоге.

  3. Group search base DNS: список базовых DNS для указания расположения соответствующих групп.

  4. Group name attribute: идентифицирует пользователей внутри записей групп.

  5. Manage group mappings:

    При управлении сопоставлениями групп доступны следующие поля. Чтобы добавить новое сопоставление группы, нажмите кнопку Add group mapping.

    1. Add a group DN mapping: имя ключа, используемого для извлечения ID-токена.
    2. Add an organization role mapping: выберите базовую роль, сопоставленную с этой группой.
    3. Add the organization ID membership mapping: сопоставьте группу с ID организации.
    4. Define Grafana Admin membership: включите привилегии администратора Grafana для группы.

4. Дополнительные настройки безопасности

Дополнительные параметры настроек безопасности для аутентификации LDAP.

  1. Enable SSL: этот параметр включит SSL для подключения к серверу LDAP.
  2. Start TLS: используйте StartTLS для защиты соединения с сервером LDAP.
  3. Min TLS version: выберите минимальную используемую версию TLS. TLS1.2 или TLS1.3
  4. TLS ciphers: перечислите шифры, используемые для соединения. Полный список шифров см. в библиотеке Cipher Go.
  5. Encryption key and certificate provision specification: Этот раздел позволяет указать ключ и сертификат для сервера LDAP. Вы можете предоставить ключ и сертификат двумя способами: base-64 в кодировке или path to files.
    1. Base-64 encoded certificate: Все значения, используемые в этом разделе, должны быть в кодировке base-64.
      1. Root CA certificate content: список корневых сертификатов CA.
      2. Client certificate content: содержимое клиентского сертификата.
      3. Client key content: содержимое клиентского ключа.
    2. Path to files: Путь в файловой системе к файлам ключа и сертификата
      1. Root CA certificate path: путь к корневому сертификату CA.
      2. Client certificate path: путь к клиентскому сертификату.
      3. Client key path: путь к клиентскому ключу.

4. Сохранение конфигурации

После того как вы настроили параметры LDAP, нажмите Save, чтобы сохранить конфигурацию.

Если вы хотите удалить все изменения, сделанные через интерфейс, и вернуться к настройкам файла конфигурации, нажмите значок меню из трёх точек и нажмите Reset to default values.