Tips for finding Knowledge Articles

  • - Enter just a few key words related to your question or problem
  • - Add Key words to refine your search as necessary
  • - Do not use punctuation
  • - Search is not case sensitive
  • - Avoid non-descriptive filler words like "how", "the", "what", etc.
  • - If you do not find what you are looking for the first time,reduce the number of key words you enter and try searching again.
  • - Minimum supported Internet Explorer version is IE9
Home  >

KB-4291: What files are modified by Centrify DirectControl or DirectAudit during install & adjoin process

Authentication Service ,  

12 April,16 at 11:44 AM

Applies to: Centrify DirectControl 5.0.x on all platforms

What files are modified by Centrify's adclient during an install and join operation. The below KB does not have sufficient information.

KB-1748: What are the list of system files changed by Centrify unix/linux agent installation?

This article describes the system files that DirectControl 5.0.2 modifies for its operation.

Files modified during install:
For AIX platform:
1. During install, on AIX 6 or later, as part of install, DirectControl will re-arrange /usr/lib/security/methods.cfg so it points to the copy in /etc/centrifydc/methods.cfg. This is for WPAR support.
2. In methods.cfg, under CENTRIFYDC stanza, adjoin code puts
options = noprompt
because Centrify's loadable authentication module will be responsible for password prompt
Please see more detail from IBM Knowledge Center:
No other system files are changed at install time. 

For all other OSes:
No system files are changed at install time.

Files modified during adjoin process:
  1. adjoin creates /var/centrifydc boot strap files for adclient. It does not modify system files directly.
  2. adclient on startup performs autoedit functions to modify the various system files to hook itself in. This is configurable.
  3. PAM (Pluggable Authentication Modules) - different OS are done differently:
    1. For older version of Solaris, HPUX and AIX, there is /etc/pam.conf. 
    2. For Linux, Mac and the new Solaris 11.1, it is the files in /etc/pam.d representing the various PAM services. 
    3. For pam.conf, for selected services, adclient will insert lines in the beginning of the file to make sure pam_centrifydc is invoked first - for authenticating AD users, and validate AD user accounts. The same goes for /etc/pam.d/ files. However, there are various new include facilities. for example, on RH (and variant), most services include /etc/pam.d/system-auth. In this case, CentrifyDC only have to modify system-auth.
    4. On SLES and Ubuntu, there is common-auth, common-account, common-password, and common-session. 
  4. NSS (/etc/nsswitch.conf)
    1. adclient modifies the lines: passwd, shadow and group to ensure centifydc is first in line to answer NSS queries for AD users. 
    2. Solaris 11.1, this is done with svccfg in later releases. For Solaris, there is additional (optional) support for other services like auth_attr, user_attr, etc. ​
    3. AIX does not have NSS. it relies on LAM​:
      1. adclient modifies /usr/lib/security/methods.cfg to add mapping for LAM libraries of CENTRIFYDC to point to /usr/lib/security/CENTRIFYDC (ditto for 64-bit). 
      2. adclient modifies /etc/security/user to fix default stanza SYSTEM directive to make sure CENTRIFYDC is invoked first. 
      3. in older release, we fix root stanza so it goes through CENTRIFYDC as well, but in suite 2014 (5.1.3), this is changed such that by default, root is left alone. 
      4. adclient modifies /etc/security/login.cfg to add /usr/bin/dzsh to the login shells. 
    4. For SLES platforms:
      1. When AppArmor is installed, adclient will modify /etc/apparmor.d/abstractions/authentication and nameservice to include centrifydc,so that client processes can communicate with adclient.
      2. There are other optional NIS maps that can be specified so that adclient will support them in NSS.  These are not normally enabled, and thus does not have any impact. They are quite involved, and are not described in this document.
  5. Kerberos (krb5.conf, krb5.keytab)
    1. Every 28 days, by default, adclient will try to change machine password. As a result, it will generate a new set of keytab entries - these include the UPN, DOM name (samAccountName@domain), and all known SPNs from the computer account. One set of entries per defined encryption type. 
  6.  For CentrifyDA 2.0.x, for user login session auditing, it works by the login shell symlink to cdash. it does not modify system configuration files for this purpose.For per user auditing, /etc/shells (AIX, /etc/security/login.cfg) are modified to include cdash as login shell.
  7. Additionally, adclient on start up, and every 8 hours, will (re)examine all of the trusts that has discovered from AD (and NOT told to ignore). 
    1. For each trust, it will try to locate and identify the useable DCs of the domain in the trust. 
    2. For cross forest transitive trust, it will actually do one more level of look up. 
    3. The resulting REALM names, and DCs are used to update krb5.conf for the various Kerberized applications to use. 
  8. Note: GP update is run about every 90 minutes or so. if customer has configured, and enabled some of the GP to update system configuration files, it will do so - for example, sshd configuration (if enabled).