Sunday, December 24, 2006

Sun Java System Application Server 9.x (glassfish) SSL/TLS Authentication Setup

I am providing the basics needed to get a CACert org signed certificate loaded on your application server.

Prerequisites:
  1. You need an account at CACert.org
  2. You need to install and configure Sun Java System Application Server 9.x or Project Glassfish

Instructions:

1. Go to the domains/domain/config directory of the application server installation.

You will find two JKS keystores located in the directory. One is called cacerts.jks and the other is keystore.jks. The cacerts.jks file is used to store the Certification Authority (CA) certificates. The keystore.jks file is used to store locally generated certificates. There is a default key located in both the keystores called s1as which is created when you install the application server.

To view the certificates in the keystore use the keytool utility as follows

keytool -list -v -keystore keystore.jks -storepass changeit

This will display the certificates in the keystore.

2. Import the CACert.org root (class 1) and class 3 certificates from here. Select the PEM format files and save them to the local drive.

NOTE: You will want to import these files into both the cacerts.jks and keystore.jks files. You will need the files in your keystore.jks file to import the signed certificate later.

Import the files as follows:

keytool -import -v -alias cacert -trustcacerts -keystore cacerts.jks -storepass changeit -file root.crt

keytool -import -v -alias cacert -trustcacerts -keystore keystore.jks -storepass changeit -file root.crt

keytool -import -v -alias cacert3 -trustcacerts -keystore cacerts.jks -storepass changeit -file class3.crt

keytool -import -v -alias cacert3 -trustcacerts -keystore keystore.jks -storepass changeit -file class3.crt


3. Create a new certificate for the server using the following

keytool -genkey -keyalg RSA -alias server -keystore keystore.jks -keypass changeit -storepass changeit -noprompt -v -dname "cn=yourdomain.com, ou=Sun Java System Application Server, o=your company name, s=your state, c=your country"

Change the dname values as appropriate. Afterwards check the keystore.

keytool -list -v -alias server -keystore keystore.jks -storepass changeit

You should get an output similar to this accounting for your domain:

Alias name: server Creation date: Dec 24, 2006 Entry type: keyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=yourdomain.com, OU=Sun Java System Application Server, O=your company name, ST=your state, C=your country Issuer: CN=yourdomain.com, OU=Sun Java System Application Server, O=your company name, ST=your state, C=your country Serial number: 458ed092 Valid from: Sun Dec 24 14:10:10 EST 2006 until: Sat Mar 24 15:10:10 EDT 2007 Certificate fingerprints: MD5: 0D:62:DA:52:34:DE:65:40:C5:34:DB:97:EE:58:20:22 SHA1: 2B:AA:0F:A0:6D:C6:DE:C2:20:19:72:85:97:B1:6B:DA:B5:7D:AC:D0

4. Create the Certificate Signing Request (CSR) using the following command:

keytool -certreq -v -alias server -keystore keystore.jks -storepass changeit -file server.csr

5. Copy the contents of the file to the CSR request form on the CACert.org site.



Here is an example of the data in the server.csr file

-----BEGIN NEW CERTIFICATE REQUEST----- MIIBzzCCATgCAQAwgY4xFTATBgNVBAYTDHlvdXIgY291bnRyeTETMBEGA1UECBMKeW91ciBzdGF0 ZTEaMBgGA1UEChMReW91ciBjb21wYW55IG5hbWUxKzApBgNVBAsTIlN1biBKYXZhIFN5c3RlbSBB cHBsaWNhdGlvbiBTZXJ2ZXIxFzAVBgNVBAMTDnlvdXJkb21haW4uY29tMIGfMA0GCSqGSIb3DQEB AQUAA4GNADCBiQKBgQCETXJQCNJz9rDLBuE8RBV/IK4sfVt1MC0DJLd6Ph94uTy+kz9mkVml41KV zd9UORdp4VCFXd9ssS5UiophTvHzcntJpAVONTwjUkdaukYA5bE5HrKsS7BjdnJTYnoeUHJ6g1ig 6NrUt2GouQGQYeiIUCoPfXsB9g8+S/0tPI6X/wIDAQABoAAwDQYJKoZIhvcNAQEEBQADgYEAYjAR My7nevIe3HM2NrilO29ls1PrjP4h6ApppCdaGrvn8RlSaXp4kPIb5s1/vHWbIB6CIeSZvlmXk2NG 649iTBK6+wLw0RTotcQXtCx7S9YnguBeWBA+zb2fJRfdWYJhCwbm9cyAfJbP80N3lyB7/XKyvq/N fjqp30oTQiiq75U=
-----END NEW CERTIFICATE REQUEST-----



5. You should get an immediate response on the site as well as an email with the certificate located in it. Copy the certificate from the site and save it in a file called signed.crt. The file should contain something that looks like the following.
-----BEGIN CERTIFICATE-----
MIIEYjCCAkqgAwIBAgIDAwmZMA0GCSqGSIb3DQEBBQUAMHkxEDAOBgNVBAoTB1Jv
b3QgQ0ExHjAcBgNVBAsTFWh0dHA6Ly93d3cuY2FjZXJ0Lm9yZzEiMCAGA1UEAxMZ
Q0EgQ2VydCBTaWduaW5nIEF1dGhvcml0eTEhMB8GCSqGSIb3DQEJARYSc3VwcG9y
dEBjYWNlcnQub3JnMB4XDTA2MTIyNDE3MDQxNVoXDTA3MDYyMjE3MDQxNVowIDEe
MBwGA1UEAxMVYmx1ZWxvdHVzaG9sZGluZ3MuY29tMIGfMA0GCSqGSIb3DQEBAQUA
A4GNADCBiQKBgQChU0hgVKaULE1W7gDLGaKwmhRXBqUgH7pboozXO61eT6rOwHPi
dEBjYWNlcnQub3JnMB4XDTA2MTIyNDE3MDQxNVoXDTA3MDYyMjE3MDQxNVowIDEe
MBwGA1UEAxMVYmx1ZWxvdHVzaG9sZGluZ3MuY29tMIGfMA0GCSqGSIb3DQEBAQUA
A4GNADCBiQKBgQChU0hgVKaULE1W7gDLGaKwmhRXBqUgH7pboozXO61eT6rOwHPi
dEBjYWNlcnQub3JnMB4XDTA2MTIyNDE3MDQxNVoXDTA3MDYyMjE3MDQxNVowIDEe
MBwGA1UEAxMVYmx1ZWxvdHVzaG9sZGluZ3MuY29tMIGfMA0GCSqGSIb3DQEBAQUA
A4GNADCBiQKBgQChU0hgVKaULE1W7gDLGaKwmhRXBqUgH7pboozXO61eT6rOwHPi
5lWu+N26F+Y0xopIhlechSByXXtwwh2bX5cgock0MHBP0qvwx6pNYglqWArxbnoV
qFoNewxtkM6Riu0uYU31jZadzO7dP8ZR/CrF4AlZ8DKU7I7faWFu5HK0YwIDAQAB
o4HPMIHMMAwGA1UdEwEB/wQCMAAwNAYDVR0lBC0wKwYIKwYBBQUHAwIGCCsGAQUF
BwMBBglghkgBhvhCBAEGCisGAQQBgjcKAwMwCwYDVR0PBAQDAgWgMDIGCCsGAQUF
BwEBBCYwJDAiBggrBgEFBQcwAYYWaHR0cDovL29jc3AuY2FjZXJ0Lm9yZzBFBgNV
HREEPjA8ghVibHVlbG90dXNob2xkaW5ncy5jb22gIwYIKwYBBQUHCAWgFwwVYmx1
ZWxvdHVzaG9sZGluZ3MuY29tMA0GCSqGSIb3DQEBBQUAA4ICAQCTOLgns8xTkgwC
YozYkLqFN+bc6zmR+iu9yWY59Ayu0xR+4e9nxqfm1SsHaKo/1tQX3CyBVGm4MhMg
9uA2sNhjJPPy7y/2oafK2R6olHHkVsLfX6MXddRPNzyjQeGgxeH9FtPz9fd9b3OP
z2fAdCSgeOhH9bn2myvRPAcX7X/wh89Gmybg52jlhl6wgumg1SQlyQ60Ht4zZYyL
7Viu6WWsCPHAWUTLQ1k7XdgLDAY0JMwRBMkCCT0w7CVdC1PkGe2WTsgnEB5RHTF5
c1fQ+fiiJC+giEMI/YwfV0AkSF9ILhm/y9DDdQ6KjkxdQne3WxaUek7cm1H/xdM9
QLBkfyNfLDanySS7dDTZK28pSSItYedpzOGIQHsDY3LfSv1kdqTEEwVGZDXW6OO5
/v/efWTLn6weuypTMVrXWZ4ednz09WP5BQ7RZjPmUX8sE+IZ3SRycCH6cZERp+dN
D3UZYBuRmQ5rWx32XNDf9wY2AiuSWFvWGnDQmpjfCAi47Q4wugk7y63xl7b+LAJC
Bp5YNJnD4zFWgvMPxo8IeJk+Dd0sNcEPAd/VJH9jymqaTbx3Dv9W5ZwGxmdNv7em
3h3544G4dVuuq24ZDbCeFdLVUcS+74407fIBHMgCf3fRXCBhJbaL90srZSAV3sX3
g7DyVvIlt035V+MMwdjgg3wmF55tww==
-----END CERTIFICATE-----

6. We imported the CACert.org certificates so that we could do the next step without issues. We will want to import the new certificate to the keystore and combine it with our private key. We do this by using the same alias we assigned to the private key (keyEntry).

keytool -import -v -trustcacerts -alias server -keystore keystore.jks -keypass changeit -storepass changeit -file signed.crt

7. Delete the cacert and cacert3 certificates from the keystore.jks

keytool -delete -v -alias cacert -keystore keystore.jks -storepass changeit
keytool -delete -v -alias cacert3 -keystore keystore.jks -storepass changeit

8. Configure the application server to use the new key. I try it on the HTTP Service --> HTTP Listeners --> http-listener-2. Select the security enabled, SSL3, TLS, and All supported ciphers checkboxes. Fill in the Certificate Nickname as server. Save and restart the application server.



9. Check the configuration by going to https://localhost:8181

FINISHED

Congratulations you are on SSL. Once I am sure that everything is working, I immediately set the admin site to use SSL/TLS as an important security measure.


12 comments :

Sebastian said...

Thank you very much for the article! I loved it and what is the best - it really works ;-). Please write more java/sjsas tips. I would love to hear more about ie properly configuring a sjsas/glassfish to run a big web application on it - I don't have any experiance on this field. I just wrote an application, you can see it at www.getup.pl.

One more time, thank you!
Sebastian Kapciak
sebastian.kapciak@gmail.com

Oh and one small thing, two '-' before the file argument are missing in second point ;-).

John Yeary said...

Thanks Sebastian. I fixed the file commands. I must not have copied them correctly from the actual server I was working on.

KedarsThoughtsWork said...

Excellent stuff, John.

One question though -- I understand
that you imported the CAcert's root
and class-3 cert in keystore.jks, so that the signed.crt can be
imported without problems.

But for that to happen, it is not
necessary to import these certs
into your server's trust-store,
right?

Can you confirm that you imported
those certificates into your
trust-store (server's trust-store,
i.e. cacerts.jks) because you
trust them anyway (as they are
signed by the CA: CACert.org),
right?

Thanks for a *great* resource!

weblogs.java.net/blog/km

John Yeary said...

Actually, I imported the certs into the trusted store (cacerts.jks) since the CAcert certificate is not one of the certificates that come standard with glassfish.

legolas said...

Hi
Very good article, But in latest steps i faced a very strange problem.

issueing follwoing command shows that i have complete all steps

keytool -list -v -alias server -keystore keystore.jks -storepass changeit

Alias name: server
Creation date: Apr 5, 2005
Entry type: keyEntry
Certificate chain length: 2
Certificate[1]:
Owner: //
Issuer: //
Serial number: db60eaa3ad98f625
Valid from: Tue Apr 05 11:54:29 GMT+03:30 2005 until: Wed Apr 05 11:54:29 GMT+03
:30 2006
Certificate fingerprints:
MD5: 81:8C:A1:76:28:03:76:E9:33:74:44:63:B3:5E:51:06
SHA1: 44:9D:60:98:51:DA:E4:F4:98:16:38:E5:E4:3D:21:AF:FE:D7:5B:A8
Certificate[2]:
Owner: //
Issuer: //
Serial number: db60eaa3ad98f61b
Valid from: Mon Apr 04 11:54:31 GMT+03:30 2005 until: Thu Apr 03 11:54:31 GMT+03
:30 2008
Certificate fingerprints:
MD5: CF:AE:D2:15:2A:2A:65:D8:51:7C:E7:A1:FB:18:92:DC
SHA1: A3:F4:83:F9:72:7D:01:0A:F9:24:E2:CF:52:12:FD:92:E2:61:22:68







but when i start application server it shows following error, do you have any comment?
This error is shown before i do anything in administration console.


java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:585)
at com.sun.enterprise.server.PELaunch.main(PELaunch.java:272)
Caused by: java.lang.ExceptionInInitializerError
at com.sun.enterprise.security.SecurityLifecycle.onInitialization(SecurityLifecycle.java:88)
at com.sun.enterprise.server.ApplicationServer.onInitialization(ApplicationServer.java:240)
at com.sun.enterprise.server.ondemand.OnDemandServer.onInitialization(OnDemandServer.java:93)
at com.sun.enterprise.server.PEMain.run(PEMain.java:316)
at com.sun.enterprise.server.PEMain.main(PEMain.java:260)
... 5 more
Caused by: java.lang.IllegalStateException: java.security.UnrecoverableKeyException: Cannot recover key
at com.sun.enterprise.security.SSLUtils.----clinit----(SSLUtils.java:112)
... 10 more
Caused by: java.security.UnrecoverableKeyException: Cannot recover key
at sun.security.provider.KeyProtector.recover(KeyProtector.java:301)
at sun.security.provider.JavaKeyStore.engineGetKey(JavaKeyStore.java:120)
at java.security.KeyStore.getKey(KeyStore.java:731)
at com.sun.net.ssl.internal.ssl.SunX509KeyManagerImpl.-----init----(SunX509KeyManagerImpl.java:111)
at com.sun.net.ssl.internal.ssl.KeyManagerFactoryImpl$SunX509.engineInit(KeyManagerFactoryImpl.java:41)
at javax.net.ssl.KeyManagerFactory.init(KeyManagerFactory.java:192)
at com.sun.enterprise.security.SSLUtils.initKeyManagers(SSLUtils.java:303)
at com.sun.enterprise.security.SSLUtils.-----clinit-----(SSLUtils.java:89)
... 10 more



Thanks.

John Yeary said...

I have a couple of thoughts and questions:

What version of glassfish are you using?

Have you set the SSL certificate nickname to server like the certificate in the keystore?

Have you checked to make sure that the certificates were imported back into the keystore using the same alias as the original CSR?

I also wonder about your certificates being valid since they have no additional information like OU, C, Owner, Issuer, etc.

legolas said...

Hi
Today finally i could perform all steps without error, and my application server starts correcly.
I am using glassfish v2 b50g.
everything looks to be fine but at the end, i can not view the page by going to https://localhost:8181/
it return an error like the following in the browser:
[b]
The connection was interrupted
...
[/b]

can you please let me know what can i do to resolve it?
there is no sign of any error in server log too.
thanks

John Yeary said...

I am not sure why you can not see the secured port. I am going to write another blog post on the latest version of glassfish. Some of the options and configuration have changed slightly. Stay tuned...

John Yeary said...

I just performed a similar process as above (I used a self signed certificate) and it worked like a champ on V2 B58. I am wondering if you have set the listener correctly. I will add another screen shot for build 58.

poster-boy said...

Hi John

Great Tutorial! Thanks. I tried it out on Windows XP Pro with SJSAS 9 environment and it seems to have worked with a few tweaks. On localhost I can view the cert in IE.

The tweaks were related to CAcerts now issueing certs with the .cer extention rather than .crt

I'm about to try it out in a Production Environment with Windows 2003 Server and SJSAS 9 and I'm wondering if there's a way to return to my original config if anything goes wrong. If I back up both cacerts.jks and keystore.jks and restore them in the event of problems, will that suffice?

I'll also be using a free GeoTrust cert that came with a 1&1 package. Do you expect I'll have to do anything differently? I'm not sure if they have root certs available or if I can skip those steps.

Thanks
-Garry

John Yeary said...

Hello posterboy,

You should have no problems with switching the configuration back as long as you copy the files you mentioned to a safe location.

I don't imagine that you will have any issues with the certs from GeoTrust. You will need to check to see if their certs are part of the CA root store. Otherwise you can add them easily.

VERY COOOOL!!!

Jeff Rodriguez said...

First off thanks for taking the time to figure out this process and give us a how-to. I've scripted the process for CACert and made the code available on my blog.

Popular Posts