ADMC

ADMC (AD Management Center) is a Qt-based GUI application for Active Directory management, replicating core functions of Microsoft RSAT "Users and Computers" and "Group Policy Management".

Dependencies

Required:

• ad-integration-themes
• GLIBC (for resolv library)
• Kerberos 5 (libkrb5)
• LDAP (libldap)
• Qt6 (base, core, widgets, help, tools, linguist tools, svg, translations)
• SASL (libsasl2, libsasl2-plugin-gssapi)
• Samba (libsmbclient, libndr)
• libcng-dpapi
• libgkdi
• util-linux (libuuid)

Optional build-time dependencies:

• ClangFormat -- a build-time dependency that is used by the auxiliary clangformat target.
• Doxygen

ALT distributions

On modern ALT Linux distributions the required dependencies can be installed as follows:

$ su -
$ apt-get update
$ apt-get install \
    ad-integration-themes \
    libcng-dpapi-devel \
    libgkdi-devel \
    libkrb5-devel \
    libldap-devel \
    libsasl2-devel \
    libsasl2-plugin-gssapi \
    libsmbclient-devel \
    libuuid-devel \
    qt6-base-devel \
    qt6-linguist \
    qt6-qtbase \
    qt6-svg \
    qt6-tools-devel \
    qt6-translations \
    samba-devel

Building

Getting the ADMC sources

git clone https://github.com/altlinux/admc
cd admc

Manual building

Once dependencies are installed, ADMC can be built by running the following commands in the cloned repository:

$ mkdir build
$ cd build
$ cmake ..
$ make -j$(nproc)

Building RPM packages with Gear

Alternatively ADMC can be built as a set of RPM packages with the help of Gear:

$ gear-rpm -ba

This gear-rpm command produces the following RPM files in ~/RPM/ directory (where <version> is the current ADMC version):

• ~/RPM/SRPMS/admc-<version>-alt1.x86_64.rpm -- source code package.
• ~/RPM/RPMS/x86_64/admc-<version>-alt1.x86_64.rpm -- compiled ADMC binaries.
• ~/RPM/RPMS/x86_64/admc-test-<version>-alt1.x86_64.rpm -- unit tests.
• ~/RPM/RPMS/x86_64/admc-debuginfo-<version>-alt1.x86_64.rpm -- debug information for ADMC.
• ~/RPM/RPMS/x86_64/admc-test-debuginfo-<version>-alt1.x86_64.rpm -- debug information for unit tests.

Source code auto-formatting

You can also format the sources by building clangformat target after cmake is run, for example:

$ make -C build clangformat

Usage

This application requires a working Active Directory domain and for the client machine to be connected and logged into the domain. You can find articles about these topics on ALTLinux wiki.

Launch ADMC from the build directory:

$ ./admc

Testing

Tests also require a domain and a connection to the domain.

Launch tests from the build directory:

$ ./admc-test

Contributing

See CONTRIBUTING.md file for contributing guidelines.

Screenshots