Class CertificateManagementService


  • @Named
    @Singleton
    public class CertificateManagementService
    extends java.lang.Object
    Service for managing certificates in keystores using Java KeyStore API. Follows Single Responsibility Principle (SOLID-S).
    Since:
    2.0
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static org.slf4j.Logger log  
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void deleteAlias​(java.io.File keystoreFile, java.lang.String keystoreType, char[] keystorePassword, java.lang.String alias)
      Delete an alias from keystore.
      void exportCertificate​(java.io.File keystoreFile, java.lang.String keystoreType, char[] keystorePassword, java.lang.String alias, java.io.File outputFile)
      Export a certificate from keystore to file.
      void importCertificate​(java.io.File keystoreFile, java.lang.String keystoreType, char[] keystorePassword, java.lang.String alias, java.io.File certificateFile, boolean skipIfAliasExists, char[] keyPassword)
      Import a certificate into a keystore.
      private java.security.cert.Certificate loadCertificate​(java.io.File certificateFile)
      Load certificate from file.
      private java.security.KeyStore loadOrCreateKeyStore​(java.io.File keystoreFile, java.lang.String keystoreType, char[] password)
      Load or create keystore.
      private void saveKeyStore​(java.security.KeyStore keystore, java.io.File keystoreFile, char[] password)
      Save keystore to file.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • log

        private static final org.slf4j.Logger log
    • Constructor Detail

      • CertificateManagementService

        public CertificateManagementService()
    • Method Detail

      • importCertificate

        public void importCertificate​(java.io.File keystoreFile,
                                      java.lang.String keystoreType,
                                      char[] keystorePassword,
                                      java.lang.String alias,
                                      java.io.File certificateFile,
                                      boolean skipIfAliasExists,
                                      char[] keyPassword)
                               throws java.security.KeyStoreException,
                                      java.io.IOException,
                                      java.security.NoSuchAlgorithmException,
                                      java.security.cert.CertificateException
        Import a certificate into a keystore.

        This method supports two scenarios:

        • Importing a trusted certificate (new alias or replacing a trusted certificate)
        • Importing a certificate reply to replace the certificate chain of an existing key pair
        Parameters:
        keystoreFile - keystore file
        keystoreType - keystore type (e.g., "JKS", "PKCS12")
        keystorePassword - keystore password
        alias - certificate alias
        certificateFile - certificate file to import
        skipIfAliasExists - if true, skip import if alias already exists
        keyPassword - password for the private key (if different from keystore password); may be null
        Throws:
        java.security.KeyStoreException - if keystore operation fails
        java.io.IOException - if file operations fail
        java.security.NoSuchAlgorithmException - if algorithm is not available
        java.security.cert.CertificateException - if certificate is invalid
      • exportCertificate

        public void exportCertificate​(java.io.File keystoreFile,
                                      java.lang.String keystoreType,
                                      char[] keystorePassword,
                                      java.lang.String alias,
                                      java.io.File outputFile)
                               throws java.lang.Exception
        Export a certificate from keystore to file.
        Parameters:
        keystoreFile - keystore file
        keystoreType - keystore type
        keystorePassword - keystore password
        alias - certificate alias
        outputFile - output file for certificate
        Throws:
        java.lang.Exception - if operation fails
      • deleteAlias

        public void deleteAlias​(java.io.File keystoreFile,
                                java.lang.String keystoreType,
                                char[] keystorePassword,
                                java.lang.String alias)
                         throws java.lang.Exception
        Delete an alias from keystore.
        Parameters:
        keystoreFile - keystore file
        keystoreType - keystore type
        keystorePassword - keystore password
        alias - alias to delete
        Throws:
        java.lang.Exception - if operation fails
      • loadOrCreateKeyStore

        private java.security.KeyStore loadOrCreateKeyStore​(java.io.File keystoreFile,
                                                            java.lang.String keystoreType,
                                                            char[] password)
                                                     throws java.security.KeyStoreException,
                                                            java.io.IOException,
                                                            java.security.NoSuchAlgorithmException,
                                                            java.security.cert.CertificateException
        Load or create keystore.
        Throws:
        java.security.KeyStoreException
        java.io.IOException
        java.security.NoSuchAlgorithmException
        java.security.cert.CertificateException
      • loadCertificate

        private java.security.cert.Certificate loadCertificate​(java.io.File certificateFile)
                                                        throws java.io.IOException,
                                                               java.security.cert.CertificateException
        Load certificate from file.
        Throws:
        java.io.IOException
        java.security.cert.CertificateException
      • saveKeyStore

        private void saveKeyStore​(java.security.KeyStore keystore,
                                  java.io.File keystoreFile,
                                  char[] password)
                           throws java.security.KeyStoreException,
                                  java.io.IOException,
                                  java.security.NoSuchAlgorithmException,
                                  java.security.cert.CertificateException
        Save keystore to file.
        Throws:
        java.security.KeyStoreException
        java.io.IOException
        java.security.NoSuchAlgorithmException
        java.security.cert.CertificateException