History

Nick Craig-Wood 479c803fd9 vendor: update all dependencies		2019-11-14 21:51:34 +00:00
..
.gitignore	vendor: add pkcs8 helpers for decrypting encrypted private keys	2019-09-20 17:15:16 +01:00
.travis.yml	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
cipher.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
cipher_3des.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
cipher_aes.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
kdf_pbkdf2.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
kdf_scrypt.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
LICENSE	vendor: add pkcs8 helpers for decrypting encrypted private keys	2019-09-20 17:15:16 +01:00
pkcs8.go	vendor: update all dependencies	2019-11-14 21:51:34 +00:00
README	vendor: add pkcs8 helpers for decrypting encrypted private keys	2019-09-20 17:15:16 +01:00
README.md	vendor: update all dependencies	2019-11-14 21:51:34 +00:00

README.md

pkcs8

OpenSSL can generate private keys in both "traditional format" and PKCS#8 format. Newer applications are advised to use more secure PKCS#8 format. Go standard crypto package provides a function to parse private key in PKCS#8 format. There is a limitation to this function. It can only handle unencrypted PKCS#8 private keys. To use this function, the user has to save the private key in file without encryption, which is a bad practice to leave private keys unprotected on file systems. In addition, Go standard package lacks the functions to convert RSA/ECDSA private keys into PKCS#8 format.

pkcs8 package fills the gap here. It implements functions to process private keys in PKCS#8 format, as defined in RFC5208 and RFC5958. It can handle both unencrypted PKCS#8 PrivateKeyInfo format and EncryptedPrivateKeyInfo format with PKCS#5 (v2.0) algorithms.

Godoc

Installation

Supports Go 1.10+. Release v1.1 is the last release supporting Go 1.9

go get github.com/youmark/pkcs8

dependency

This package depends on golang.org/x/crypto/pbkdf2 and golang.org/x/crypto/scrypt packages. Use the following command to retrieve them

go get golang.org/x/crypto/pbkdf2
go get golang.org/x/crypto/scrypt