Enum PEM

java.lang.Object
java.lang.Enum<PEM>
com.amazonaws.auth.PEM
All Implemented Interfaces:
Serializable, Comparable<PEM>, java.lang.constant.Constable

public enum PEM extends Enum<PEM>
A PEM utility that can be used to read keys from PEM. With this PEM utility, private keys in either PKCS#1 or PKCS#8 PEM encoded format can be read without the need to depend on the Bouncy Castle library.

Some background information:

  • Interestingly, the creation of a CloudFront Key Pair via the AWS console would result in a private key in PKCS#1 PEM format.
  • Unfortunately, the JDK doesn't provide a means to load PEM key encoded in PKCS#1 without adding the Bouncy Castle to the classpath. The JDK can only load PEM key encoded in PKCS#8 encoding.
  • One the other hand, one can use openssl to convert a PEM file from PKCS#1 to PKCS#8. Example:
     openssl pkcs8 -topk8 -in pk-APKAJM22QV32R3I2XVIQ.pem -inform pem -out pk-APKAJM22QV32R3I2XVIQ_pk8.pem  -outform pem -nocrypt
     
  • Method Details

    • values

      public static PEM[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared
    • valueOf

      public static PEM valueOf(String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null
    • readPrivateKey

      public static PrivateKey readPrivateKey(InputStream is) throws InvalidKeySpecException, IOException
      Returns the first private key that is found from the input stream of a PEM file.
      Throws:
      InvalidKeySpecException - if failed to convert the DER bytes into a private key.
      IllegalArgumentException - if no private key is found.
      IOException
    • readPublicKey

      public static PublicKey readPublicKey(InputStream is) throws InvalidKeySpecException, IOException
      Returns the first public key that is found from the input stream of a PEM file.
      Throws:
      InvalidKeySpecException - if failed to convert the DER bytes into a public key.
      IllegalArgumentException - if no public key is found.
      IOException
    • readPEMObjects

      public static List<PEMObject> readPEMObjects(InputStream is) throws IOException
      A lower level API used to returns all PEM objects that can be read off from the input stream of a PEM file.

      This method can be useful if more than one PEM object of different types are embedded in the same PEM file.

      Throws:
      IOException