TDM Portal data model scanning fails with 'CredentialsRetrievalFailureException' for custom security plugin

Products

• CA Test Data Manager (Data Finder / Grid Tools)

Issue/Introduction

When performing a Data Model Scanning step in TDM Portal for a connection profile using a custom security plugin, the scan fails with the following error: 
The Scan cannot be completed. Exception raised: connection profile: [Profile_Name] cannot be used: CredentialsRetrievalFailureException: Credentials retrieval failed

Environment

• Product: CA Test Data Manager (TDM) Portal
• Version: 5.0.x
• Component: TDM Model Service / Connection Profiles

Cause

Technical Details (TDMModelService.log): The logs show an underlying IllegalStateException or NoClassDefFoundError related to Kerberos or security libraries: java.lang.IllegalStateException: The native Kerberos library was not loaded, check the cause for details java.lang.NoClassDefFoundError: Could not initialize class ms.request.auth.MSSPNegoHelper

The error typically occurs because the TDM Model Service cannot locate the necessary Kerberos or security-related JAR files required by the custom security plugin (e.g., SecureCredentialsVault or msjava libraries). Even if the connection itself is NTLM-based, the initialization of the security plugin may trigger a search for these native libraries.

Resolution

To resolve the issue, ensure all required security and Kerberos dependencies are available to the TDM Portal services:

1. Identify Missing Libraries: Check your custom security plugin documentation for required third-party JAR files (e.g., Kerberos or vault-specific libraries).
2. Copy JARs to Tomcat: Copy the missing .jar files to the following directory on the TDM Portal server:
   • C:\Program Files\CA\CA Test Data Manager Portal\tomcat\lib\
3. Restart Services: Restart the CA Test Data Manager Portal service to load the new libraries.
4. Verify Scan: Attempt the Data Model Scanning step again.

Additional Information

Create Custom Security Plugins for TDM