Утилита aldpro-join

Описание

Графическая утилита aldpro-join.exe предназначена для присоединения компьютера под управлением ОС Windows к домену ALD Pro (FreeIPA). Подробную инструкцию и готовую версию приложения вы найдете в релизах

История изменений

Версия 2.3

Исправлена синхронизация времени с контроллером домена. Синхронизация происходит с тем контроллером домена (КД), с которым взаимодействуем в момент ввода в домен.

Версия 2.2

Обновлена команда для изменения настроек NetBIOS для работы в старых версиях pwsh (Windows 10 до 21H1).

Версия 2.1

Добавлено задание Планировщика, которое исправляет имена в формате Pre-Windows для возможности входа с использованием значения домена по умолчанию.

Версия 2.0

Выполнен рефакторинг для упрощения поддержки программного кода и улучшения пользовательского опыта.

Версия 1.0

Реализован базовый функционал утилиты, обеспечивающий ввод Windows машины в домен FreeIPA

Сборка утилиты

Для работы с проектом требуется установить Python 3. Дистрибутив можно скачать с официального сайта.

При установке выберите “Добавить Python в переменную PATH”. Если вы этого не сделали, то переменную PATH можно задать вручную с помощью следующей команды:

setx /M path "%PATH%;C:\Users\Administrator\AppData\Local\Programs\Python\Python312;C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Scripts"

После установки python требуется установить зависимости:

pip install -r requirements.txt

Для запуска утилиты из исходников нужно в папке проекта выполнить следующую команду:

python ..\aldpro-join

Для корректной сборки утилиты в исполняемый exe-файл необходимо установить MIT Kerberos для Windows и добавить C:\Program Files\MIT\Kerberos\bin в PATH, затем в папке проекта выполнить следующую команду:

pyinstaller --name "aldpro-join.exe" --icon ".\resources\astra.ico" --add-data ".\resources:resources" --uac-admin --onefile --windowed --noconfirm --clean  .\__main__.py

где
--name         Задает имя, которое нужно использовать для собранного приложения (по умолчанию: имя первого скрипта).
--icon         Установить значок для Windows приложения
--add-data     Встроить файлы в приложение, формат «source:dest_dir», где «source — это путь на диске, а dest_dir - это каталог внутри приложения
--uac-admin    Запрашивать повышение прав при запуске приложения.
--onefile      Создать один исполняемый файл
--windowed     Не предоставлять консольное окно для стандартного ввода-вывода.
--noconfirm    Заменить выходной каталог без запроса подтверждения (по умолчанию: SPECPATH\dist\SPECNAME).
--clean        Очистить кеш PyInstaller и удалить временные файлы перед сборкой.

Исполняемый файл станет доступен по адресу .\dist\aldpro-join.exe

Предварительные требования

• Компьютеру должен быть назначен IP адрес из локальной сети.
• В качестве DNS должен быть указан адрес контроллера домена ALD Pro (FreeIPA).

© 2025 ПАО Группа Астра