Centrify for Samba (ADBindProxy) 5.6.1 Release Notes
© 2004-2020 Centrify Corporation.
This software is protected by international copyright laws.
All Rights Reserved.
Table of Contents
4.1. Feature Changes in Centrify for Samba 5.6.1
4.2. Feature Changes in Centrify for Samba 5.5.2
5.1. Bug Fixed in Centrify for Samba 5.6.1
5.2. Bug Fixed in Centrify for Samba 5.5.2
8. Additional Information and Support
Centrify for Samba is a proxy agent package that seamlessly integrates the Centrify DirectControl Agent for *NIX in Centrify Zero Trust Privilege Services (previously called Centrify Infrastructure Services) with open source Samba (referred to as stock Samba in this document), enabling the two products to share Active Directory user and group membership and to agree upon Unix identity attributes for Active Directory users. It is a proxy that passes identity management requests from Samba to Centrify DirectControl Agent for *NIX.
The documentation, Samba Integration Guide (centrify-adbindproxy-guide.pdf), is available online to guide customers through the setup and configuration of Centrify for Samba in both new and existing environments.
The latest copies of this release notes as well as the above-mentioned documentation are available online at http://docs.centrify.com.
Centrify software is protected by U.S. Patents 7,591,005; 8,024,360; 8,321,523; 9,015,103; 9,112,846; 9,197,670; 9,378,391 and 9,442,962. (Ref: CS-44575)
The Centrify for Samba bundle package contains the following resources:
· Centrify for Samba software package (e.g. CentrifyDC-adbindproxy-<version#>-<OS>.<architecture>.rpm, or similar platform specific package file)
· Centrify for Samba Release Notes (Centrify-Adbindproxy-Release-Notes.html – this release notes)
The Centrify for Samba bundle package is available on the following OS/platforms in this release:
· HPUX on Itanium
· HPUX on PA-RISC
· IBM AIX on PPC
· Oracle Solaris on SPARC
· Oracle Solaris on x86_64
· Ubuntu on x86_64
· Red Hat Enterprise Linux on PPC
· Red Hat Enterprise Linux on PPC64LE
· Red Hat Enterprise Linux on x86_64
· SUSE Linux Enterprise Server on x86_64
For the OS versions that a Centrify for Samba bundle package supports, please refer to the supported OS versions of the matching Centrify DirectControl Agent for *NIX package of the corresponding Centrify Zero Trust Privilege Services release. Similarly, Centrify for Samba also follows Centrify DirectControl Agent for *NIX’s schedule for End-of-Support platforms and hence please refer to the announcements there.
This release of Centrify for Samba works with Centrify Infrastructure Services 2017 and up.
Added two new parameters to customize the thread pool of adbindd. (Ref: SAMBA-1071)
· "adbindd.threads" sets the number of pre-allocated threads for processing client requests, and
· "adbindd.threads.max" sets the maximum number of threads that the adbindd will allocate for processing client requests.
Added the support of systemd service manager. On Linux where stock Samba services are managed by systemd service manager, the centrifydc-samba service will be installed as a systemd service instead of System V init script. Please use the systemctl command to control the service in this case. (Ref: SAMBA-1075)
This release of Centrify for Samba works with Centrify Infrastructure Services 2017 and up.
As Centrify for Samba follows Centrify DirectControl Agent for *NIX schedule for End-of-Support platforms, the following platforms are removed from this release:
· Debian 7.x x86_64
Added options to allow adbindproxy.pl record or use a response file while running in non-interactive mode. This will simplify or better automate the set-up process especially on multiple machines. (Ref: SAMBA-1042)
Details as follows:
· The default output directory of adbindproxy.pl is changed from /var/centrifydc/samba to /var/centrify/samba, and the default output files for --export option are now /var/centrify/samba/passwd and /var/centrify/samba/group.
· Added 2 new options in adbindproxy.pl, --adjoinExtraOptions and --adleaveExtraOptions, to pass additional options to adjoin and adleave commands respectively.
· Added new options in adbindproxy.pl to automate the adbindproxy.pl script:
- the --record option will save the user input to a response file,
- the --nonInteractive option will use the response file as user input,
- the --responseFile option is used to specify the response file. If not specified, the default is /var/centrify/samba/adbindproxy.pl.rsp.
· Fixed a bug that randomly crashes adbindd. (Ref: SAMBA-1069)
· Fixed a bug that fails to access samba share when the AD user’s samaccountname and unixname are different and "force user" option is defined. Note: All groups that this "force user" belongs to must be zone enabled for this to work. (Ref: SAMBA-1068)
· Fixed a bug that samba share does not work if SELinux is enabled. Now adbindproxy set up script will prompt users to choose whether to grant smbd process access to non samba_share_t type files and directories if SELinux policy is detected. (Ref: SAMBA-1044)
Enhanced the implementation of the command wbinfo to provide consistent results with adquery when getting zone enabled user or group information. The affected command options are listed here (Ref: SAMBA-1015, SAMBA-1033, SAMBA-1039):
· wbinfo --name-to-sid <user/group name>
· wbinfo --user-info <user name>
· wbinfo --group-info <group name>
· wbinfo --domain-users --domain <domain name>
· wbinfo --domain-groups --domain <domain name>
Note:
· By default, wbinfo --domain-users, and wbinfo --domain-groups, will list zone users/groups in the current domain. To list zone users/groups in all domains, query with the option "--domain \*".
· By this change, specifying UPN, or canonical name, in those commands is not supported.
· You may need to re-run adbindproxy.pl manually after upgrade if the winbind separator is not one of the separators specified in the parameter adclient.ntlm.separators in centrifydc.conf.
· Read the centrify-adbindproxy-guide.pdf that is included in this package.
· The following is a summary of the steps to install and configure Centrify for Samba. Please refer to the instructions in centrify-adbindproxy-guide.pdf for details.
- Preparation
- If there is no Samba installed, install stock Samba first. Many Linux OS already include Samba.
- If you are doing a fresh Centrify for Samba installation in an environment with stock Samba running, back up smb.conf just in case.
- If you are upgrading from an existing Centrify Samba environment:
- Back up your smb.conf.
- Uninstall Centrify Samba.
- Install stock Samba and make sure it works in your environment (Note that you will need to replace or merge the smb.conf from stock Samba with your back-up copy. This is especially important if you have file path settings in the original smb.conf).
- Install and configure Centrify for Samba
- Install Centrify DirectControl Agent for *NIX if you have not already done it.
- Install Centrify for Samba package.
- If you are using Centrify DirectControl Agent for *NIX from Centrify Server Suite 2016 on a Redhat 7.x platform, you need to do these extra steps:
- Open a command terminal and run the following commands:
vi /etc/centrifydc/scripts/functions.cdc
- Comment out the two lines containing LD_LIBRARY_PATH, e.g.
- # LD_LIBRARY_PATH=/usr/share/centrifydc/lib64:/user/share/centrifydc/kerberos/lib64:$LD_LIBRARY_PATH
- # export LD_LIBRARY_PATH
- Save the file with the changes
- Modify the symbolic link of adkeytab utility
- cd /sbin
- ls –l adkeytab
- rm adkeytab
- ln –s /usr/share/centrifydc/libexec/adkeytab /sbin/adkeytab
- Join the machine to a zone using adjoin.
- Run adbindproxy.pl to configure the proxy environment.
- Additional steps
- If you have customized any existing smb.conf settings, verify that the new smb.conf still have all the relevant settings.
- Restart stock Samba and Centrify for Samba by running either one of the following commands
- /etc/init.d/centrifydc-samba restart
- service centrifydc-samba restart
- You may want to ensure stock samba’s sbin and bin paths have been set in PATH environment variables
The following sections describe common known issues or limitations associated with this Centrify for Samba release.
· Limitations with stock Samba
In previous Centrify Samba, we modified the following in stock Samba for interoperability. Using stock Samba instead of Centrify Samba, you may see related issues.
- Default Kerberos keytab location, KEYTAB_DEFAULT, from /etc/krb5.keytab to /etc/krb5/krb5.keytab on Solaris (SAMBA-890).
- Default Kerberos cache location, CCNAME, from /tmp/krb5cc_%{uid} to /var/krb5/security/creds/krb5cc_%{uid}" on AIX (SAMBA-892).
· Limitations with RHEL 7.2 PPC (SAMBA-965)
If you are using 64bit Samba on a RHEL 7.2 PPC machine, you may have problem with adclient failed to use the 64bit tdb library come with 64 bit Samba. The symptom can be shown in the error message while trying to access samba server - “session setup failed: NT_STATUS_CANT_ACCESS_DOMAIN_INFO”.
You need to install a 32bit tdb library, e.g. libtdb-1.3.6-2.el7.ppc.rpm in rhel-server-7.2-ppc64-dvd.iso, for adclient to work with, and you need to tell adclient where to get this library by adding a parameter “samba.libtdb.path: /usr/lib/libtdb.so.1” into centrifydc.conf, assuming the path to libtdb is /usr/lib/libtdb.so.1.
· Limitations with AIX7.1 (SAMBA-966)
If you are using Centrify for Samba with stock Samba and Centrify Server Suite 2014 or 2013.3 on an AIX machine, it may not work well due to library problem. The symptom can be shown in the error message while trying to access samba server - “session setup failed: NT_STATUS_NO_LOGON_SERVERS”.
You may try the following changes on Samba tools, e.g. smbd, smbstatus and testparm, to get around it:
- mv /usr/local/samba/sbin/smbd /usr/local/samba/sbin/smbd.x
- vi /usr/local/samba/sbin/smbd
#! /bin/sh
unset _ LD_LIBRARY_PATH
unset _ LD_PRELOAD
LIBPATH=/usr/local/samba/lib:/usr/local/samba/lib/private
export LIBPATH
exec /usr/local/samba/sbin/smbd.x "$@"
In addition to the documentation provided for this package, you can find the answers to common questions and information about any general or platform-specific known limitations as well as tips and suggestions from the Centrify Knowledge Base.
The Centrify Resources web site provides access to a wide range of information including analyst report, best practice brief, case study, datasheet, ebook, white papers, etc., that may help you optimize your use of Centrify products. For more information, see the Centrify Resources web site:
http://www.centrify.com/resources
You can also contact Centrify Support directly with your questions through the Centrify Web site, by email, or by telephone. To contact Centrify Support or to get help with installing or using this version of Centrify for Samba, send email to support@centrify.com or call 1-669-444-5200, option 2. For information about purchasing or evaluating Centrify products, send email to info@centrify.com.