Enabling LDAP(S) authentication and authorization for the Gateway configuration menu

Document ID : KB000042872
Last Modified Date : 01/10/2018
Show Technical Document Details
Introduction:

Solution

Overview

This procedure is designed to integrate Mirosoft Active Directory as an authentication mechanism and identity provider for the CA API Gateway appliance. This will allow users within an Active Directory to authenticate against the Gateway appliance via console or SSH connections in order to access the Gateway configuration menu.

Prerequisites

  1. Windows Domain should have Services for Unix or a similar extension to the schema incorporated.
  2. Create a new user through the Microsoft Management Console's (MMC) Active Directory Users and Computers component.
  3. Define the user as having no password expiry and being unable to change their own credentials.
  4. Set the UNIX attributes for the user to 499 for UID and GID.
  5. Set the home directory to /dev/null and shell to /bin/false.
  6. Import a certificate into the Domain Controller for TLS communications between the Gateway and the AD.

Configuring the required user and group.

  1. Configure the user and group objects for the existing Active Directory entries for POSIX compliance:
  • Open the Active Directory Users and Groups management .
  • Modify a new or existing group object to function as a POSIX group.
  • Right-click and select Properties.
  • Open on the UNIX Attributes tab.
  • Populate the NIS Domain and GID (Groupd ID).
  1. Configure a user object to function as a POSIX user:
  • Open the tab that says UNIX Attributes.
  • Populate the NIS Domain, UID, GID, and Home Directory.
  1. Add the user as a member of the UNIX group.
  • Return to the Group Properties dialog for the Gateway configuration group.
  • Click Add to add the user to this group.
  • Select the user created and click Add.
  • Click OK to save and confirm the changes.

Configuring the Gateway authentication method.

  1. Log into the Gateway as the ssgconfig user through direct console, SSH, or ILOM console redirection.
  2. Select Option #1: Configure system settings.
  3. Select Option #4: Configure authentication method.
  4. Select Option #3: LDAP(S) only.
  5. Specify "Yes" for an encrypted connection, or "No" for an unencrypted connection.
  6. Specify the fully qualified domain name or IP address of the LDAP server.
  7. Specify a port number to use if different from the default.
  8. Specify a base search distinguished name (DN).
  9. Specify anonymous binding. Anonymous binding allows the Gateway to attempt to connect to the LDAP server without providing administrative credentials. An LDAP server can be configured to allow read-only access to anonymous users. Please consult your Active Directory or LDAP administration to verify if this is required. If you can use anonymous binding, steps 10 & 11 can be skipped.
  10. Specify the bind DN to provide read access to the LDAP.
  11. Specify the bind password for the above bind DN.
  12. Specify the name of the group encapsulating users authorized to interact with the Gateway configuration menu.
  13. Specify the GID for the group that should be granted access to the Gateway.
  14. Choose the hashing algorithm used by the LDAP server.
  15. Specify the object type that contains the credentials for a user.
  16. Specify the object type that contains the group assignment for a user.
  17. Specify the object type that contains the shadow entries for a user.
  18. If you opted to use LDAPS, you will be presented with several extra prompts. If not, you can skip to step 28.
  19. Specify if the certificate for the LDAPS server can be reached via URL. If yes, provide the URL. If not, provide the file path.
  20. If you require a customized TLS configuration for connecting to the LDAPS server, specify "Yes." If not, you can skip to step 28.
  21. If you require a specialized process for handling server certificates, specify "Yes." If not, you can skip to step 28.
  22. Choose an option for handling the server certificate from the LDAPS server.
  23. If you require Certificate Revocation List checking, specify "Yes." If not, you can skip to step 28.
  24. If you require a customize client authentication configuration, specify "Yes." If not, you can skip to step 28.
  25. Specify the file path to a PEM-formatted client certificate.
  26. Specify the file path to a PEM-formatted client private key.
  27. If you require a customized PAM login attribute, specify "Yes." If not, you can skip to step 28.
  28. Specify the PAM login attribute.
  29. You will be presented with a summary of the configuration of the Gateway's LDAP(S)-based authentication scheme. Verify the results and press <Enter> to accept.
  30. Select Option X: Exit menu.

Mapping attributes between LDAP(S) and AD.

If your AD infrastructure is different from the default configuration, you may require access to a Domain Controller in order to view and/or modify a users' attributes. Additionally, the properties a generic UNIX LDAP server uses to identify individual user attributes are not named similarly to a Microsoft AD LDAP. In order to facilitate this, values will need to be mapped to bridge the gap between the values expected by the UNIX LDAP and those returned by the AD LDAP.

  1. Select Option #3: Use a privileged shell (root).
  2. Open /etc/ldap.conf in a text editor.
  3. Remove the comment delimiter (#) the following lines
nss_map_objectclass posixAccount user
nss_map_objectclass shadowAccount user
nss_map_attribute uid sAMAccountName
nss_map_attribute homeDirectory unixHomeDirectory
nss_map_attribute shadowLastChange pwdLastSet
nss_map_objectclass posixGroup group
nss_map_attribute uniqueMember member
nss_override_attribute_value loginShell /bin/bash
nss_map_attribute uidNumber uidNumber
pam_login_attribute sAMAccountName
pam_filter objectclass=User
pam_password ad
  1. Review the above attributes with your AD administrators. The values for these objects may need to be changed in the Gateway in order to accommodate for an organization's unique AD infrastructure.

Applying the configuration method to the Gateway

Once the above procedures have been completed, the Gateway appliance will need to be restarted for the changes to take effect. Please restart the appliance and verify proper functionality.

Attachments:

Instructions:
Please Update This Required Field
File Attachments:
TEC0000001082.zip