TrustPin Kotlin SDK/cloud.trustpin.kotlin.sdk/TrustPinError/ConfigurationValidationFailed

ConfigurationValidationFailed

object ConfigurationValidationFailed : TrustPinError(source)

Thrown when the configuration payload failed validation (e.g., signature mismatch or invalid structure).

This error occurs when the configuration validation fails for the downloaded pinning configuration. This indicates either a security issue or a configuration problem with the credentials.

Common Causes

Credential mismatch: Public key doesn't match the signature
Corrupted payload: Network issues corrupted the downloaded configuration
Tampering: Potential man-in-the-middle attack on configuration
Service issues: Problems with TrustPin service signing
Clock skew: Timestamp validation failures due to incorrect system time

Security Implications

High severity: Configuration integrity compromised
Potential attack: Configuration may have been tampered with
Service disruption: Cannot proceed with pinning validation
Trust breakdown: Fundamental security validation failed

Resolution Steps

Verify credentials: Ensure public key matches TrustPin dashboard
Check system time: Verify device clock is accurate
Test connectivity: Ensure clean network path to TrustPin service
Retry operation: Attempt fresh configuration download
Contact support: If persistent, contact TrustPin support

Diagnostic Information

try {
    trustPin.setup(/* credentials */)
 } catch (e: TrustPinError.ConfigurationValidationFailed) {
     println("Configuration validation failed - check credentials and network")
     // Log additional context:
     // - System time
     // - Network conditions
     // - Credential sources
 }