pyjks 0.3.0.1

pyjks
=====

A pure python Java KeyStore file parser, including private key decryption.

Usage examples:

Reading a JKS or JCEKS keystore and dumping out its contents in the PEM format:
```
import sys, base64, textwrap
import jks

def print_pem(data, type):
print "-----BEGIN %s-----" % type
print "\r\n".join(textwrap.wrap(base64.b64encode(data), 64))
print "-----END %s-----" % type

ks = jks.KeyStore.load("keystore.jks", "XXXXXXXX")

for pk in ks.private_keys:
print "Private key: %s" % pk.alias
print_pem(pk.pkey, "RSA PRIVATE KEY")
for c in pk.cert_chain:
print_pem(c[1], "CERTIFICATE")
print

for c in ks.certs:
print "Certificate: %s" % c.alias
print_pem(c.cert, "CERTIFICATE")
print
```


Transforming an encrypted JKS/JCEKS file into an OpenSSL context):
```python
import OpenSSL
import jks

_ASN1 = OpenSSL.crypto.FILETYPE_ASN1

def jksfile2context(jks_file, passphrase):
keystore = jks.KeyStore.load(jks_file, passphrase)
pkey = OpenSSL.crypto.load_privatekey(_ASN1, keystore.private_key.pkey)
trusted_certs = [OpenSSL.crypto.load_certificate(_ASN1, cert.cert)
for cert in keystore.certs]
public_cert = OpenSSL.crypto.load_certificate(
_ASN1, keystore.private_keys[0].cert_chain[0][1])

ctx = OpenSSL.SSL.Context(OpenSSL.SSL.TLSv1_METHOD)
ctx.use_privatekey(pkey)
ctx.use_certificate(public_cert)
#want to know ASAP if there is a problem with the protected
ctx.check_privatekey()
cert_store = ctx.get_cert_store()
for cert in trusted_certs:
cert_store.add_cert(cert)
return ctx

```

The best way to utilize a certificate stored in a jks file up to this point has been
to use the java keytool command to transform to pkcs12, and then openssl to transform to pem.

This is better:

1- no security concerns in passwords going into command line arguments, or unencrypted files being left around

2- no dependency on a JVM