AD Bridge User Guide
Total Page:16
File Type:pdf, Size:1020Kb
AD Bridge User Guide May 2019 Legal Notice © Copyright 2019 Micro Focus or one of its affiliates. The only warranties for products and services of Micro Focus and its affiliates and licensors (“Micro Focus”) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. For additional information, such as certification-related notices and trademarks, see http://www.microfocus.com/about/legal/. Contents About This Guide 5 1 Getting Started 7 2 Installing AD Bridge 9 Linux Requirements and Supported Platforms . 9 Linux Requirements . 9 Supported Linux Platforms. 10 Installing the AD Bridge Linux Agent. 11 Licensing the Linux Agent . 12 Joining Active Directory - Post Installation . 13 Installing the AD Bridge GPEdit Extension . 13 3 Managing Linux GPO Settings 15 Accessing or Creating Group Policy Objects . 15 Configuring Linux GPO Settings . 16 Managing Linux Agent Services with GPOs . 17 Importing Custom Configuration File Settings. 18 Managing Linux Applications with GPOs . 18 Managing User Logins with GPOs . 19 Viewing Policy Injection on a Linux Agent. 20 A Appendix 21 Linux Agent GPO Settings . 21 Linux Agent Commands and Lookups . 22 GPO Best Practices . 23 Contents 3 4 About This Guide The AD Bridge User Guide provides information to help you understand, install, configure, and employ the Micro Focus AD Bridge product to help manage your enterprise environment. Audience This guide is written for administrators and users who will use Micro Focus AD Bridge to more effectively manage Active Directory and group policies in a cross-platform environment. Feedback We want to hear your comments and suggestions about this manual and the other documentation included with this product. Please use the User Comments feature at the bottom of each page of the online documentation. Additional Documentation AD Bridge is supported by other documentation (in both PDF and HTML formats) that you can use to learn about and implement the product. For additional documentation, see the AD Bridge documentation website. About This Guide 5 6 About This Guide 1 1Getting Started AD Bridge is a solution that extends Active Directory (AD) capabilities by enabling domain controllers to add Linux servers to the AD environment to interface with identity services, group policies, and domain resources. This is accomplished with the installation of an AD Bridge Agent on Linux computers and a GPMC snap-in tool “AD Bridge GPEdit Extension” on the domain controller. After the AD Bridge Agent and GPEdit Extension are installed on their respective computers, you can configure built-in and custom group policies for Linux agents via the Group Policy Management Console on the domain controller. This capability enables the following group policy options for agent computers: Configure Allow and Deny controls for Firewall settings Start, stop, or restart agent services Import and manage Open SSH and Custom Configuration files Modify and control agent application files Configure Active Directory login controls For more information about these settings, see the Linux Agent GPO Settings. Reference the graphic below for a visual depiction of how AD Bridge will work with your Active Directory environment. Getting Started 7 8 Getting Started 2 2Installing AD Bridge This section contains information that will help you understand the following: AD Bridge Agent requirements for Linux distributions Supported Linux distributions How to install the AD Bridge Agent on a Linux server Prerequisites for the AD Bridge GPMC snap-in “GPEdit Extension” How to install the AD Bridge GPEdit Extension on the domain controller Linux Requirements and Supported Platforms Review the information in this section before installing the AD Bridge Agent on a Linux server. Linux Requirements The following requirements must be met to install the Linux Agent and join Active Directory: Install the Linux Agent with “root” (requires administrator password) DNS name servers on the Linux Agent must list the Active Directory DNS servers The Active Directory domain is listed as one of the default search domains Prerequisite Linux packages are able to download and install from respective vendors during the Linux Agent installation. Otherwise, the following Linux packages must be installed prior to running the Linux Agent installation: Linux Distribution Required Linux Packages All distributions .NetCore system update to install .NetCore 2.1 and its prerequisites. For more information, see Linux distribution dependencies. RHEL 6, RHEL 7, CentOS 6, CentOS 7, Oracle 6, samba Oracle 7 samba-client samba-winbind samba-winbind-clients cifs-utils openldap-clients SLES 12, SLES 15 realmd adcli sssd sssd-tools sssd-ad samba-client krb5-client openldap2-client Installing AD Bridge 9 Linux Distribution Required Linux Packages Ubuntu 18.04 realmd sssd sssd-tools libnss-sss libpam-sss adcli samba-common-bin oddjob oddjob-mkhomedir packagekit krb5-user cifs-utils keyutils Ubuntu 16.04 ntpdate samba krb5-config krb5-user winbind libpm-winbind libnss-winbind cifs-utils NOTE: If a prerequisite package check or installation fails, the failure notice will identify any missing prerequisites. Supported Linux Platforms The following Linux platforms are supported by AD Bridge: Linux Distribution Version Red Hat Enterprise (RHEL) RHEL 6 RHEL 7 SUSE Linux Enterprise (SLES) SLES 12 SLES 15 CentOS Enterprise Linux CentOS 6 CentOS 7 Ubuntu Ubuntu 16 Ubuntu 18 Oracle Enterprise Linux Oracle 6 Oracle 7 10 Installing AD Bridge Installing the AD Bridge Linux Agent When you download the AD Bridge Linux Agent installer, you will need to unpack the installer for your specific Linux distribution. An example of the files included with the final distribution installer is shown below: agent-rhel-centos-sles-1.0.rpm install.sh uninstall.sh To install the AD Bridge Linux Agent on a Linux machine: 1 Download the AD Bridge installer onto a Windows device and extract the zipped contents. 2 Copy the Linux Agent installer file applicable to your distribution onto the Linux machine. Installer file Linux distribution ADBridge_Agent.tar.gz RHEL CentOS SUSE Oracle ADBridge_Ubuntu_Agent.tar.gz Ubuntu 3 On the command line, log in as the root user and type the following command to unpack the applicable installation package from the table above: tar xvzf <file name> 4 For all distributions except Ubuntu, type the command again using the file name specific to your platform from the table below. For example: tar xvf <file name> Installer file Linux distribution RHEL7_CentOS7_SLES.tar RHEL 7 CentOS 7 SUSE 12 & 15 Oracle 6 & 7 RHEL6_CentOS6.tar RHEL 6 CentOS 6 Oracle 6 & 7 NOTE: You can use either of the installation files above for Oracle 6 or Oracle 7. 5 Verify the installer files are on the machine with a list command: # ls 6 Run the install.sh script file with root to set up the Linux Agent. For example: # ./install.sh #bash install.sh Installing AD Bridge 11 Installation time will vary depending on your environment and the prerequisites that need to be installed. Warning messages during the installation are informational and do not necessarily require action unless you experience an installation failure. IMPORTANT: For SUSE installations, you may receive a confirmation prompt y/n before the installation will start. For SUSE 15 installations, the dotnet-runtime-2.1 installation displays a problem dependency for libicu52-1. Enter 2 to ignore the dependency and enter y when prompted to install “NEW packages.” 7 Enter y when prompted to join Active Directory. NOTE: This step and the following step are optional if you want to join Active Directory at a later time. For information about joining Active Directory after installation, see Joining Active Directory - Post Installation. 8 When prompted, provide the full domain name, the AD account that has permission to join a domain, and the AD account password. For example: myCompany.com administrator <password> During the installation, the Linux Agent will be added by default to the Computers OU in Active Directory. After the installation is complete, the Linux Agent service will be running on the Linux system, as demonstrated in the example below of an installation on a Red Hat distribution. NOTE: For information on how to start the Linux Agent Service or verify that it is running, see Linux Agent Commands and Lookups the Appendix. Licensing the Linux Agent The AD Bridge Linux Agent installation is provided with a 30-day evaluation period. To continue using AD Bridge after 30 days, purchase the product and install the license before the 30 days elapses. For more information, contact Micro Focus Sales. To download this product, go to the Micro Focus Downloads or Customer Center website. To activate the AD Bridge license subscription: 1 Copy the license XML file into the Linux Agent directory at usr/local/bin/agent. 12 Installing AD Bridge 2 Restart the Linux Agent Service. See Start the Linux Agent Service in the Appendix. Restarting the service replaces the temporary license with the new active license and enables all AD Bridge functionality. NOTE: If your license subscription is approaching the expiration date, you will follow the same steps above to renew the license. Joining Active Directory - Post Installation