Установка CLI-клиента для управления DNS (пакет elles-dns-cli)

Клиент elles-dns-cli устанавливается на контроллере домена «Эллес» или отдельной машине под управлением ОС Astra Linux 1.8 с доступом к развернутому серверу REST API elles-dns-api по HTTPS.

Клиент не требует дополнительной настройки, так как все параметры подключения (адрес сервера, Kerberos-аутентификация, TLS) определяются автоматически при запуске:

  1. Убедитесь, что на машине установлен пакет krb5-user и при необходимости установите его:

    sudo apt install -y krb5-user

  2. Проверьте, что в конфигурации клиента Kerberos в файле /etc/krb5.conf содержатся корректные настройки.

    Пример файла:

    [libdefaults]
    default_realm = EXAMPLE.COM
    dns_lookup_realm = false
    dns_lookup_kdc = true

[realms]
    EXAMPLE.COM = {
        kdc = <dc-fqdn>:88
        admin_server = <dc-fqdn>:749
    }

[domain_realm]
    .example.com = EXAMPLE.COM
    example.com = EXAMPLE.COM

    <dc-fqdn> в примере — FQDN целевого контроллера домена.

  3. Установите пакет elles-dns-cli:

    • при установке из репозитория выполните:

      sudo apt install elles-dns-cli -y

    • при установке из локального архива укажите путь к распакованному deb-файлу; например:

      cd /path/to/package
sudo apt install ./elles-dns-cli_1.22.0-1_amd64.deb -y

  4. Проверьте установку и доступность команды:

    elles-dns-cli --help

    Ожидаемый вывод: список доступных команд и глобальных флагов.

  5. Убедитесь, что клиент может аутентифицироваться через Kerberos:

    kinit <username>@<REALM>
klist

    В выводе klist должен содержаться действительный билет Kerberos для krbtgt/<REALM>.

  6. Проверьте работу клиента на базовом запросе:

    elles-dns-cli ZoneList --server <api-fqdn> --insecure

    <api-fqdn> в запросе — FQDN хоста с развернутым сервером elles-dns-api. Ожидаемый вывод: список AD-партиций DNS (DomainDnsZones, ForestDnsZones, System).

При работе с elles-dns-cli учитывайте следующее:

  • клиент работает только при наличии действительного билета Kerberos-тикета;

  • сервер elles-dns-api должен быть доступен по HTTPS (по умолчанию: https://localhost:9443);

  • автоопределение FQDN сервера происходит по localhost; для работы с удаленным сервером обязательно используйте флаг --server <fqdn>.

  • если используется самоподписанный TLS-сертификат, флаг --insecure обязателен — без него запросы будут отклоняться.