Configuring Secure LDAP

To connect Black Duck SCA to a secure LDAP server, you must establish a trust connection by importing the LDAP server certificate into the Black Duck SCA LDAP truststore. This is most commonly required when using a self-signed certificate.

Important: If you have configured custom CA certificates using AUTH_CUSTOM_CA, HUB_PROXY_CERT_FILE, or the certAuthCACertSecretName Helm secret, those certificates are imported into the proxy truststore only. They are not automatically imported into the LDAP truststore. To establish a trust connection for your LDAP or LDAPS server, you must import the server certificate separately using the Black Duck SCA UI, as described below.

Obtaining your LDAP information

Contact your LDAP administrator and gather the following information before proceeding.

LDAP Server Details

This is the information that Black Duck SCA uses to connect to the directory server.

  • (required) The host name or IP address of the directory server, including the protocol scheme and port, on which the instance is listening.

    Example: ldaps://<server_name>.<domain_name>.com:636

  • (optional) If your organization does not use anonymous authentication and requires credentials for LDAP access, the password and either the LDAP name or the absolute LDAP distinguished name (DN) of a user that has permission to read the directory server.

    Example of an absolute LDAP DN: uid=ldapmanager,ou=employees,dc=company,dc=com

    Example of an LDAP name: jdoe

  • (optional) If credentials are required for LDAP access, the authentication type to use: simple or digest-MD5.

LDAP User Attributes

This is the information that Black Duck SCA uses to locate users in the directory server.

  • (required) The absolute base DN under which users can be located.

    Example: dc=example,dc=com

  • (required) The attribute used to match a specific, unique user. The value of this attribute personalizes the user profile icon with the name of the user.

    Example: uid={0}

Test Username and Password

  • (required) The user credentials to test the connection to the directory server.

Importing the server certificate

To import the server certificate:

  1. Log in to Black Duck SCA as a system administrator.

  2. Click Administration icon.

  3. Select Integrations → External Authentication.

  4. Click Lightweight Directory Access Protocol (LDAP).

  5. Check the Enable LDAP Configuration checkbox and complete the information in the LDAP Server Details section, as described above. In the Server URL field, ensure that the protocol scheme is ldaps://.

  6. Complete the information in the LDAP User Attributes section, as described above.

    Optionally, clear the Create user accounts automatically in Black Duck SCA check box to turn off the automatic creation of users when they authenticate with LDAP. This check box is selected by default so that users who do not exist in Black Duck SCA are created automatically when they log in using LDAP. This applies to new installs and upgrades.

  7. Enter the user credentials in the Test Connection, User Authentication and Field Mapping section and click Test Connection.

  8. If there are no issues with the certificate, it is automatically imported and the "Connection Test Succeeded" message appears:



  9. If there is an issue with the certificate, a dialog box listing details about the certificate will appear. Do one of the following:

    • Click Cancel to fix the certificate issues. Once fixed, retest the connection to verify that the issues have been resolved and the certificate has been imported. If successful, the "Connection Test Succeeded" message appears.

    • Click Save to import the certificate as-is. Verify that the certificate has been imported by clicking Test Connection. If successful, the "Connection Test Succeeded" message appears.