From 17914ae50938d67745cf288c28651e67009178d6 Mon Sep 17 00:00:00 2001
From: oxmc <67136658+oxmc@users.noreply.github.com>
Date: Mon, 31 Mar 2025 05:57:33 -0400
Subject: [PATCH] SSL Fix

---
 build.gradle                                  |   2 +-
 src/main/java/net/montoyo/mcef/MCEF.java      |   3 +-
 .../net/montoyo/mcef/SSLCertificateAdder.java |  87 ++++++++++--------
 .../resources/assets/cas/google/roots.jks     | Bin 29113 -> 0 bytes
 4 files changed, 53 insertions(+), 39 deletions(-)
 delete mode 100644 src/main/resources/assets/cas/google/roots.jks

diff --git a/build.gradle b/build.gradle
index e28d998..8288f63 100644
--- a/build.gradle
+++ b/build.gradle
@@ -14,7 +14,7 @@ apply plugin: 'net.minecraftforge.gradle'
 apply plugin: 'eclipse'
 apply plugin: 'maven-publish'
 
-version = '1.12.2-1.42'
+version = '1.12.2-1.43'
 group = 'net.montoyo.mcef'
 archivesBaseName = 'mcef-legacy'
 
diff --git a/src/main/java/net/montoyo/mcef/MCEF.java b/src/main/java/net/montoyo/mcef/MCEF.java
index e64a041..9b24e69 100644
--- a/src/main/java/net/montoyo/mcef/MCEF.java
+++ b/src/main/java/net/montoyo/mcef/MCEF.java
@@ -15,7 +15,7 @@ import java.util.List;
 @Mod(modid = "mcef", name = "MCEF", version = MCEF.VERSION)
 public class MCEF {
 
-    public static final String VERSION = "1.42";
+    public static final String VERSION = "1.43";
     public static boolean ENABLE_EXAMPLE;
     public static boolean SKIP_UPDATES;
     public static boolean WARN_UPDATES;
@@ -76,6 +76,7 @@ public class MCEF {
         // Add certificates if needed
         // This is a workaround for Java 7u111 and 8u101, which have issues with Let's Encrypt certificates or google trust services
         try {
+            Log.info("PREINT, Adding certificates...");
             SSLCertificateAdder.validateAndInstall();
         } catch (Exception e) {
             Log.error("Failed to add a certificate: " + e.getMessage());
diff --git a/src/main/java/net/montoyo/mcef/SSLCertificateAdder.java b/src/main/java/net/montoyo/mcef/SSLCertificateAdder.java
index c2c93ce..00a4cde 100644
--- a/src/main/java/net/montoyo/mcef/SSLCertificateAdder.java
+++ b/src/main/java/net/montoyo/mcef/SSLCertificateAdder.java
@@ -11,6 +11,7 @@ import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.security.KeyStore;
+import java.security.KeyStoreException;
 import java.security.cert.*;
 import java.util.*;
 import java.util.regex.Matcher;
@@ -41,53 +42,45 @@ public class SSLCertificateAdder {
     private static final List<CertificateInfo> CERTIFICATES = Arrays.asList(
         new CertificateInfo("lets-encrypt-x3-cross-signed", "X.509", "/assets/cas/letsencrypt/lets-encrypt-x3-cross-signed.der", 7, 110, "https://helloworld.letsencrypt.org"),
         new CertificateInfo("lets-encrypt-isrgrootx1", "X.509", "/assets/cas/letsencrypt/isrgrootx1.der", 7, 110, "https://helloworld.letsencrypt.org"),
-        new CertificateInfo("google-trust-services", "X.509", "/assets/google/root.pem", 7, 110, "https://www.google.com"),
-        new CertificateInfo("google-trust-jks", "JKS", "/assets/cas/google/roots.jks", 7, 110, "https://www.google.com")
+        new CertificateInfo("google-trust-services", "X.509", "/assets/cas/google/roots.pem", 7, 110, "https://www.google.com")
     );
 
-    public static void addCertificates() {
-        for (CertificateInfo certInfo : CERTIFICATES) {
-            try {
-                Log.info("[SSLCert] Adding certificate: " + certInfo.name);
-                addCertificate(certInfo);
-                Log.info("[SSLCert] Certificate added successfully. Checking connection...");
-                checkConnection(certInfo.testUrl, "[" + certInfo.name + " SSL]");
-            } catch (Exception e) {
-                Log.error("[SSLCert] Failed to add certificate: " + certInfo.name, e);
-            }
-        }
-    }
-
-    private static void addCertificate(CertificateInfo certInfo) throws Exception {
+    private static void addCertificate(CertificateInfo certInfo, KeyStore keyStore) throws Exception {
         try (InputStream certStream = SSLCertificateAdder.class.getResourceAsStream(certInfo.filePath)) {
             if (certStream == null) {
                 throw new FileNotFoundException("Certificate file not found: " + certInfo.filePath);
             }
-
-            KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
-            try (InputStream ksInputStream = Files.newInputStream(ksPath)) {
-                keyStore.load(ksInputStream, KEYSTORE_PASSWORD.toCharArray());
-            }
-
+    
             CertificateFactory cf = CertificateFactory.getInstance(certInfo.type);
             Collection<? extends Certificate> certificates;
+    
             try (BufferedInputStream caInput = new BufferedInputStream(certStream)) {
-                certificates = cf.generateCertificates(caInput);
+                if (certInfo.filePath.endsWith(".pem")) {
+                    // Handle PEM format
+                    certificates = cf.generateCertificates(caInput);
+                } else {
+                    // Handle DER format
+                    Certificate cert = cf.generateCertificate(caInput);
+                    certificates = Collections.singletonList(cert);
+                }
             }
-
+    
             int count = 0;
             for (Certificate cert : certificates) {
                 String alias = certInfo.name + "-" + count++;
                 keyStore.setCertificateEntry(alias, cert);
                 Log.info("[SSLCert] Added certificate with alias: " + alias);
             }
-
-            TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
-            tmf.init(keyStore);
-
-            SSLContext sslContext = SSLContext.getInstance("TLS");
-            sslContext.init(null, tmf.getTrustManagers(), null);
-            SSLContext.setDefault(sslContext);
+        } catch (FileNotFoundException e) {
+            Log.error("[SSLCert] Certificate file not found: " + certInfo.filePath, e);
+        } catch (CertificateException e) {
+            Log.error("[SSLCert] Failed to parse certificate from file: " + certInfo.filePath, e);
+        } catch (IOException e) {
+            Log.error("[SSLCert] I/O error while processing the certificate file: " + certInfo.filePath, e);
+        } catch (KeyStoreException e) {
+            Log.error("[SSLCert] KeyStore error while adding the certificate: " + certInfo.name, e);
+        } catch (Exception e) {
+            Log.error("[SSLCert] Unexpected error while adding the certificate: " + certInfo.name, e);
         }
     }
 
@@ -130,17 +123,37 @@ public class SSLCertificateAdder {
             Log.info("[SSLCert] Failed to parse Java version. Applying fix anyway.");
         }
 
-        for (CertificateInfo certInfo : CERTIFICATES) {
-            if ((majorVersion >= certInfo.minVersion && majorVersion <= certInfo.maxVersion)) {
+        KeyStore keyStore = null;
+        
+        try {
+            // Initialize the KeyStore once
+            keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
+            try (InputStream ksInputStream = Files.newInputStream(ksPath)) {
+                keyStore.load(ksInputStream, KEYSTORE_PASSWORD.toCharArray());
+            }
+
+            // Add each certificate to the keystore
+            for (CertificateInfo certInfo : CERTIFICATES) {
                 try {
-                    Log.info("[SSLCert] Adding " + certInfo.name + "...");
-                    addCertificate(certInfo);
-                    Log.info("[SSLCert] " + certInfo.name + " added successfully. Checking connection...");
+                    Log.info("[SSLCert] Adding certificate: " + certInfo.name);
+                    addCertificate(certInfo, keyStore);
+                    Log.info("[SSLCert] Certificate added successfully. Checking connection...");
                     checkConnection(certInfo.testUrl, "[" + certInfo.name + " SSL]");
                 } catch (Exception e) {
-                    Log.error("[SSLCert] Error adding " + certInfo.name, e);
+                    Log.error("[SSLCert] Failed to add certificate: " + certInfo.name, e);
                 }
             }
+
+            // Now set the SSLContext globally after all certificates have been added
+            TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
+            tmf.init(keyStore);
+
+            SSLContext sslContext = SSLContext.getInstance("TLS");
+            sslContext.init(null, tmf.getTrustManagers(), null);
+            SSLContext.setDefault(sslContext);
+
+        } catch (Exception e) {
+            Log.error("[SSLCert] Error adding certificates", e);
         }
     }
 }
diff --git a/src/main/resources/assets/cas/google/roots.jks b/src/main/resources/assets/cas/google/roots.jks
deleted file mode 100644
index 667111de50db25de7e971461a7c05c9a42ac4f1f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 29113
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
AqW}N^