com.cybersource.authsdk.util

Class Utility

java.lang.Object

com.cybersource.authsdk.util.Utility

public class Utility
extends Object

Constructor Summary

Constructors

Constructor and Description
Utility()

Method Summary

Modifier and Type	Method and Description
static boolean	checkAuthenticationValidation(String authenticationType) Checks whether the authentication type is rightly entered with no typo error.
static String	extractSerialNumber(X509Certificate x509Certificate)
static X509Certificate	getCertificateByAliasFromPKCS(String filePath, char[] password, String alias) Retrieves a certificate by alias from a PKCS12 keystore.
static String	getFileExtension(String fileName)
static boolean	isP12GeneratedByCyberSource(String filePath, char[] password)
static boolean	isValidBooleanString(String value) Helper method to validate if a string represents a valid boolean value.
static Collection<X509Certificate>	loadCertificatesFromPemFile(String certFilePath) Loads X509 certificates from a PEM file.
static PrivateKey	loadPrivateKeyFromPemFile(String keyFilePath, char[] password)
static PrivateKey	readPrivateKeyFromP12(String p12FilePath, char[] password)
static String	retrieveGetIDFromRequestTarget(String requestTarget)
static X509Certificate	searchCertificateByAlias(Collection<X509Certificate> certs, String keyAlias) Searches for a certificate that matches the given key alias from a collection of certificates.
static void	validateCertificateExpiry(X509Certificate certificate, String keyAlias, String mleCacheKeyIdentifier) Validate the certificate expiry and log a warning if expired or expiring soon.
static void	validatePathAndFile(String filePath, String pathType) Validates that the given file path exists and is not empty.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Utility

public Utility()

Method Detail

checkAuthenticationValidation

public static boolean checkAuthenticationValidation(String authenticationType)

Checks whether the authentication type is rightly entered with no typo error.

Parameters:

authenticationType - HTTP or JWT

Returns:

true if valid authentication type else return false.

retrieveGetIDFromRequestTarget

public static String retrieveGetIDFromRequestTarget(String requestTarget)

Parameters:

requestTarget - : request target from where we will retrieve Id

Returns:

id from request target.

isValidBooleanString

public static boolean isValidBooleanString(String value)

Helper method to validate if a string represents a valid boolean value.

Parameters:

value - the string to validate

Returns:

true if the string is "true" or "false" (case-insensitive), false otherwise

extractSerialNumber

public static String extractSerialNumber(X509Certificate x509Certificate)

validatePathAndFile

public static void validatePathAndFile(String filePath,
                                       String pathType)
                                throws IOException

Validates that the given file path exists and is not empty.

Parameters:

filePath - The file path to validate.

pathType - A description of the path type (e.g., "Input file").

Throws:

IOException - If the file does not exist.

IllegalArgumentException - If the path is null or empty.

loadCertificatesFromPemFile

public static Collection<X509Certificate> loadCertificatesFromPemFile(String certFilePath)
                                                               throws CertificateException,
                                                                      IOException

Loads X509 certificates from a PEM file.

Parameters:

certFilePath - The file path to the PEM certificate file.

Returns:

The loaded X509Certificate(s) as a Collection.

Throws:

CertificateException - If the certificate cannot be parsed or is invalid.

IOException - If the file cannot be read or does not exist.

searchCertificateByAlias

public static X509Certificate searchCertificateByAlias(Collection<X509Certificate> certs,
                                                       String keyAlias)

Searches for a certificate that matches the given key alias from a collection of certificates. The search looks for the alias in the certificate's subject DN (Distinguished Name), specifically in the CN (Common Name) field.

Parameters:

certs - Collection of X509 certificates to search through

keyAlias - The key alias to search for

Returns:

The matching X509Certificate, or null if no match is found

validateCertificateExpiry

public static void validateCertificateExpiry(X509Certificate certificate,
                                             String keyAlias,
                                             String mleCacheKeyIdentifier)
                                      throws MLEException

Validate the certificate expiry and log a warning if expired or expiring soon.

Parameters:

certificate - The X509Certificate to check.

keyAlias - The alias of the key in the keystore.

mleCacheKeyIdentifier - Identifier for the MLE cache key.

Throws:

MLEException - if certificate validation fails.

readPrivateKeyFromP12

public static PrivateKey readPrivateKeyFromP12(String p12FilePath,
                                               char[] password)
                                        throws KeyStoreException,
                                               NoSuchAlgorithmException,
                                               CertificateException,
                                               IOException

Throws:

KeyStoreException

NoSuchAlgorithmException

CertificateException

IOException

loadPrivateKeyFromPemFile

public static PrivateKey loadPrivateKeyFromPemFile(String keyFilePath,
                                                   char[] password)
                                            throws Exception

Throws:

Exception

getCertificateByAliasFromPKCS

public static X509Certificate getCertificateByAliasFromPKCS(String filePath,
                                                            char[] password,
                                                            String alias)
                                                     throws CertificateException,
                                                            IOException,
                                                            KeyStoreException

Retrieves a certificate by alias from a PKCS12 keystore.

Parameters:

filePath - The path to the PKCS12 (.p12) file

password - The password to unlock the keystore

alias - The certificate alias to search for

Returns:

The matching X509Certificate, or null if not found

Throws:

CertificateException - If there's an error parsing certificates

IOException - If the file cannot be read

KeyStoreException - If there's an error accessing the keystore

IllegalArgumentException - If required parameters are invalid

isP12GeneratedByCyberSource

public static boolean isP12GeneratedByCyberSource(String filePath,
                                                  char[] password)

getFileExtension

public static String getFileExtension(String fileName)