davmail.http

Class SelfSignedCertificateGenerator

java.lang.Object

davmail.http.SelfSignedCertificateGenerator

public class SelfSignedCertificateGenerator
extends Object

Self-signed PKCS12 certificate generator for DavMail SSL. Uses reflection to access sun.security.x509.* internal APIs for compatibility across Java 8, 11, and 17+.

Usage on Java 11+:

java --add-exports java.base/sun.security.x509=ALL-UNNAMED -cp davmail.jar davmail.DavGateway -generateCert

On Java 8, the --add-exports flag is not needed.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_KEYSTORE_PASSWORD

Method Summary

Modifier and Type	Method and Description
static void	generate(String configFilePath) Generate a self-signed certificate, save it next to the DavMail settings file, and update settings with the keystore configuration.
static void	generateAndSave(String keystoreFilename, String keystorePassword) Generate a self-signed PKCS12 keystore file.
static String	resolveKeystorePath(String configFilePath) Resolve keystore path: place davmail.p12 next to the given config file.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_KEYSTORE_PASSWORD

public static final String DEFAULT_KEYSTORE_PASSWORD

See Also:

Constant Field Values

Method Detail

resolveKeystorePath

public static String resolveKeystorePath(String configFilePath)

Resolve keystore path: place davmail.p12 next to the given config file.

Parameters:

configFilePath - path to the DavMail properties file

Returns:

resolved keystore file path

generate

public static void generate(String configFilePath)

Generate a self-signed certificate, save it next to the DavMail settings file, and update settings with the keystore configuration. Called from DavGateway with -generateCert option.

Parameters:

configFilePath - path to the DavMail properties file

generateAndSave

public static void generateAndSave(String keystoreFilename,
                                   String keystorePassword)
                            throws GeneralSecurityException,
                                   IOException

Generate a self-signed PKCS12 keystore file.

Parameters:

keystoreFilename - output filename (e.g., "davmail.p12")

keystorePassword - password for the keystore and key entry

Throws:

GeneralSecurityException - if certificate generation fails

IOException - if keystore file cannot be written