utilities.pgpBatchUpload

Class MutualAuthUploadUtility

java.lang.Object

utilities.pgpBatchUpload.MutualAuthUploadUtility

public class MutualAuthUploadUtility
extends Object

Utility class for uploading encrypted PGP files using mutual TLS authentication.

Supports multiple authentication mechanisms including JKS, P12/PFX, and direct private key/certificate usage. Uses OkHttp for HTTP communication and supports multipart file uploads.

Constructor Summary

Constructors

Constructor and Description
MutualAuthUploadUtility()

Method Summary

Modifier and Type	Method and Description
static ApiResponse<String>	handleUploadOperationUsingP12orPfx(byte[] encryptedPgpBytes, String endpointUrl, String fileName, String p12FilePath, char[] p12FilePassword, String serverTrustCertPath) Handles file upload operation using P12/PFX keystore and PEM server certificate(s) for mutual authentication
static ApiResponse<String>	handleUploadOperationUsingPrivateKeyAndCerts(byte[] encryptedPgpBytes, String endpointUrl, String fileName, PrivateKey clientPrivateKey, X509Certificate clientCert, Collection<X509Certificate> serverTrustCerts) Handles file upload operation using provided private key and certificates for mutual authentication.
static ApiResponse<String>	handleUploadOperationWithJKS(byte[] encryptedPgpBytes, String endpointUrl, String fileName, String keystorePath, char[] keystorePassword, String truststorePath, char[] truststorePassword) Handles file upload operation using JKS keystore and truststore for mutual authentication.
static void	setDisableSslVerification(boolean disable) Sets whether SSL verification should be disabled.

Methods inherited from class java.lang.Object

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

Constructor Detail

MutualAuthUploadUtility

public MutualAuthUploadUtility()

Method Detail

handleUploadOperationWithJKS

public static ApiResponse<String> handleUploadOperationWithJKS(byte[] encryptedPgpBytes,
                                                               String endpointUrl,
                                                               String fileName,
                                                               String keystorePath,
                                                               char[] keystorePassword,
                                                               String truststorePath,
                                                               char[] truststorePassword)
                                                        throws IOException,
                                                               KeyStoreException,
                                                               NoSuchAlgorithmException,
                                                               CertificateException,
                                                               KeyManagementException,
                                                               UnrecoverableKeyException

Handles file upload operation using JKS keystore and truststore for mutual authentication.

Parameters:

encryptedPgpBytes - The encrypted PGP file content as byte array

endpointUrl - The target URL endpoint for file upload

fileName - The name of the file to be uploaded (will be suffixed with .pgp)

keystorePath - The file path to the JKS keystore containing client certificates

keystorePassword - The password for the JKS keystore

truststorePath - (Optional) The file path to the JKS truststore containing trusted server certificates. Can be null if not required.

truststorePassword - The password for the JKS truststore

Returns:

ApiResponse containing the upload response details

Throws:

IOException - If file operations or network communication fails

KeyStoreException - If keystore operations fail

NoSuchAlgorithmException - If required cryptographic algorithms are not available

CertificateException - If certificate processing fails

KeyManagementException - If SSL key management fails

UnrecoverableKeyException - If private key cannot be recovered from keystore

handleUploadOperationUsingP12orPfx

public static ApiResponse<String> handleUploadOperationUsingP12orPfx(byte[] encryptedPgpBytes,
                                                                     String endpointUrl,
                                                                     String fileName,
                                                                     String p12FilePath,
                                                                     char[] p12FilePassword,
                                                                     String serverTrustCertPath)
                                                              throws IOException,
                                                                     KeyStoreException,
                                                                     NoSuchAlgorithmException,
                                                                     CertificateException,
                                                                     KeyManagementException,
                                                                     UnrecoverableKeyException

Handles file upload operation using P12/PFX keystore and PEM server certificate(s) for mutual authentication

Parameters:

encryptedPgpBytes - The encrypted PGP file content as a byte array

endpointUrl - The target URL endpoint for file upload

fileName - The name of the file to be uploaded (will be suffixed with .pgp)

p12FilePath - The file path to the P12/PFX keystore containing client certificates

p12FilePassword - The password for the P12/PFX keystore

serverTrustCertPath - (Optional) The file path to the PEM file containing one or more server trust certificates. Can be null if not required

Returns:

ApiResponse containing the upload response details

Throws:

IOException - If file operations or network communication fails

KeyStoreException - If keystore operations fail

NoSuchAlgorithmException - If required cryptographic algorithms are not available

CertificateException - If certificate processing fails

KeyManagementException - If SSL key management fails

UnrecoverableKeyException - If private key cannot be recovered from keystore

handleUploadOperationUsingPrivateKeyAndCerts

public static ApiResponse<String> handleUploadOperationUsingPrivateKeyAndCerts(byte[] encryptedPgpBytes,
                                                                               String endpointUrl,
                                                                               String fileName,
                                                                               PrivateKey clientPrivateKey,
                                                                               X509Certificate clientCert,
                                                                               Collection<X509Certificate> serverTrustCerts)
                                                                        throws KeyStoreException,
                                                                               NoSuchAlgorithmException,
                                                                               CertificateException,
                                                                               IOException,
                                                                               UnrecoverableKeyException,
                                                                               KeyManagementException

Handles file upload operation using provided private key and certificates for mutual authentication.

Parameters:

encryptedPgpBytes - The encrypted PGP file content as byte array

endpointUrl - The target URL endpoint for file upload

fileName - The name of the file to be uploaded (will be suffixed with .pgp)

clientPrivateKey - The client's private key for authentication

clientCert - The client's X509 certificate

serverTrustCerts - (Optional) A collection of server's trusted X509 certificates (can be a certificate chain). Can be null or empty if not required.

Returns:

ApiResponse containing the upload response details

Throws:

KeyStoreException - If keystore operations fail

NoSuchAlgorithmException - If required cryptographic algorithms are not available

CertificateException - If certificate processing fails

IOException - If file operations or network communication fails

UnrecoverableKeyException - If private key cannot be recovered

KeyManagementException - If SSL key management fails

setDisableSslVerification

public static void setDisableSslVerification(boolean disable)

Sets whether SSL verification should be disabled.

Parameters:

disable - true to disable SSL verification, false to enable By default, SSL verification is enabled.