/*
* Copyright (c) 2011-2019 Contributors to the Eclipse Foundation
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
* which is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
*/
package io.vertx.core.net.impl.pkcs1;
import io.vertx.core.VertxException;
import io.vertx.core.buffer.Buffer;
import java.io.UnsupportedEncodingException;
import java.math.BigInteger;
import java.security.spec.PKCS8EncodedKeySpec;
import java.security.spec.RSAPrivateCrtKeySpec;
import java.util.Arrays;
This code is copies and modifies over from net.oauth.java.jmeter:ApacheJMeter_oauth
Source is from https://web.archive.org/web/20110827064643/http://oauth.googlecode.com:80/svn/code/branches/jmeter/jmeter/src/main/java/org/apache/jmeter/protocol/oauth/sampler/PrivateKeyReader.java
which is licensed under the APL (see also https://web.archive.org/web/20120202095848/http://code.google.com:80/p/jmeter-oauth/)
All credits go to the original author Zhihong Zhang (zhihong@gmail)
/**
* This code is copies and modifies over from net.oauth.java.jmeter:ApacheJMeter_oauth
* <p/>
* Source is from https://web.archive.org/web/20110827064643/http://oauth.googlecode.com:80/svn/code/branches/jmeter/jmeter/src/main/java/org/apache/jmeter/protocol/oauth/sampler/PrivateKeyReader.java
* which is licensed under the APL (see also https://web.archive.org/web/20120202095848/http://code.google.com:80/p/jmeter-oauth/)
* <p/>
* All credits go to the original author Zhihong Zhang (zhihong@gmail)
*/
public class PrivateKeyParser {
ASN.1 OID for RSA public key.
/**
* ASN.1 OID for RSA public key.
*/
private static final byte[] OID_RSA_PUBLIC_KEY = { 0x2A, (byte) 0x86, 0x48, (byte) 0x86, (byte) 0xF7, 0x0D, 0x01,
0x01, 0x01 };
ASN.1 OID for EC public key.
/**
* ASN.1 OID for EC public key.
*/
private static final byte[] OID_EC_PUBLIC_KEY = { 0x2A, (byte) 0x86, 0x48, (byte) 0xCE, 0x3D, 0x02, 0x01 };
Gets the algorithm used by a PKCS#8 encoded private key.
Params: - encodedKey – The encoded private key.
Throws: - VertxException – if the key is not PKCS#8 encoded or uses an unsupported
algorithm.
Returns: The algorithm name, either RSA or EC, depending on
the algorithm identifier found in the encoded key.
/**
* Gets the algorithm used by a PKCS#8 encoded private key.
*
* @param encodedKey The encoded private key.
* @return The algorithm name, either <em>RSA</em> or <em>EC</em>, depending on
* the algorithm identifier found in the encoded key.
* @throws VertxException if the key is not PKCS#8 encoded or uses an unsupported
* algorithm.
*/
public static String getPKCS8EncodedKeyAlgorithm(byte[] encodedKey) {
DerParser parser = new DerParser(encodedKey);
Asn1Object sequence = parser.read();
if (sequence.getType() != DerParser.SEQUENCE) {
throw new VertxException("Invalid PKCS8 encoding: not a sequence");
}
parser = sequence.getParser();
BigInteger version = parser.read().getInteger();
if (version.intValue() != 0) {
throw new VertxException("Unsupported version, expected 0 but found " + version.intValue());
}
sequence = parser.read();
if (sequence.getType() != DerParser.SEQUENCE) {
throw new VertxException("Invalid PKCS8 encoding: could not read Algorithm Identifier");
}
parser = sequence.getParser();
byte[] algorithmIdentifier = parser.read().getObjectIdentifier();
if (Arrays.equals(OID_RSA_PUBLIC_KEY, algorithmIdentifier)) {
return "RSA";
} else if (Arrays.equals(OID_EC_PUBLIC_KEY, algorithmIdentifier)) {
return "EC";
} else {
throw new VertxException("Unsupported algorithm identifier");
}
}
Convert PKCS#1 encoded private key into RSAPrivateCrtKeySpec.
The ASN.1 syntax for the private key with CRT is
--
-- Representation of RSA private key with information for the CRT algorithm.
--
RSAPrivateKey ::= SEQUENCE {
version Version,
modulus INTEGER, -- n
publicExponent INTEGER, -- e
privateExponent INTEGER, -- d
prime1 INTEGER, -- p
prime2 INTEGER, -- q
exponent1 INTEGER, -- d mod (p-1)
exponent2 INTEGER, -- d mod (q-1)
coefficient INTEGER, -- (inverse of q) mod p
otherPrimeInfos OtherPrimeInfos OPTIONAL
}
Params: - keyBytes – PKCS#1 encoded key
Throws: Returns: KeySpec
/**
* Convert PKCS#1 encoded private key into RSAPrivateCrtKeySpec.
* <p/>
* <p/>The ASN.1 syntax for the private key with CRT is
* <p/>
* <pre>
* --
* -- Representation of RSA private key with information for the CRT algorithm.
* --
* RSAPrivateKey ::= SEQUENCE {
* version Version,
* modulus INTEGER, -- n
* publicExponent INTEGER, -- e
* privateExponent INTEGER, -- d
* prime1 INTEGER, -- p
* prime2 INTEGER, -- q
* exponent1 INTEGER, -- d mod (p-1)
* exponent2 INTEGER, -- d mod (q-1)
* coefficient INTEGER, -- (inverse of q) mod p
* otherPrimeInfos OtherPrimeInfos OPTIONAL
* }
* </pre>
*
* @param keyBytes PKCS#1 encoded key
* @return KeySpec
* @throws VertxException
*/
public static RSAPrivateCrtKeySpec getRSAKeySpec(byte[] keyBytes) throws VertxException {
DerParser parser = new DerParser(keyBytes);
Asn1Object sequence = parser.read();
if (sequence.getType() != DerParser.SEQUENCE) {
throw new VertxException("Invalid DER: not a sequence");
}
// Parse inside the sequence
parser = sequence.getParser();
parser.read(); // Skip version
BigInteger modulus = parser.read().getInteger();
BigInteger publicExp = parser.read().getInteger();
BigInteger privateExp = parser.read().getInteger();
BigInteger prime1 = parser.read().getInteger();
BigInteger prime2 = parser.read().getInteger();
BigInteger exp1 = parser.read().getInteger();
BigInteger exp2 = parser.read().getInteger();
BigInteger crtCoef = parser.read().getInteger();
return new RSAPrivateCrtKeySpec(
modulus, publicExp, privateExp, prime1, prime2,
exp1, exp2, crtCoef);
}
A bare-minimum ASN.1 DER decoder, just having enough functions to
decode PKCS#1 private keys. Especially, it doesn't handle explicitly
tagged types with an outer tag.
This parser can only handle one layer. To parse nested constructs, get a new parser for each layer using Asn1Object.getParser()
.
There are many DER decoders in JRE but using them will tie this
program to a specific JCE/JVM.
Author: zhang
/**
* A bare-minimum ASN.1 DER decoder, just having enough functions to
* decode PKCS#1 private keys. Especially, it doesn't handle explicitly
* tagged types with an outer tag.
* <p/>
* <p/>This parser can only handle one layer. To parse nested constructs,
* get a new parser for each layer using {@code Asn1Object.getParser()}.
* <p/>
* <p/>There are many DER decoders in JRE but using them will tie this
* program to a specific JCE/JVM.
*
* @author zhang
*/
static class DerParser {
// Classes
private final static int UNIVERSAL = 0x00;
private final static int APPLICATION = 0x40;
private final static int CONTEXT = 0x80;
private final static int PRIVATE = 0xC0;
// Constructed Flag
private final static int CONSTRUCTED = 0x20;
// Tag and data types
private final static int ANY = 0x00;
private final static int BOOLEAN = 0x01;
private final static int INTEGER = 0x02;
private final static int BIT_STRING = 0x03;
private final static int OCTET_STRING = 0x04;
private final static int NULL = 0x05;
private final static int OBJECT_IDENTIFIER = 0x06;
private final static int REAL = 0x09;
private final static int ENUMERATED = 0x0a;
private final static int SEQUENCE = 0x10;
private final static int SET = 0x11;
private final static int NUMERIC_STRING = 0x12;
private final static int PRINTABLE_STRING = 0x13;
private final static int VIDEOTEX_STRING = 0x15;
private final static int IA5_STRING = 0x16;
private final static int GRAPHIC_STRING = 0x19;
private final static int ISO646_STRING = 0x1A;
private final static int GENERAL_STRING = 0x1B;
private final static int UTF8_STRING = 0x0C;
private final static int UNIVERSAL_STRING = 0x1C;
private final static int BMP_STRING = 0x1E;
private final static int UTC_TIME = 0x17;
private Buffer in;
private int pos;
Create a new DER decoder from an input stream.
Params: - in – The DER encoded stream
/**
* Create a new DER decoder from an input stream.
*
* @param in The DER encoded stream
*/
DerParser(Buffer in) throws VertxException {
this.in = in;
}
Create a new DER decoder from a byte array.
Params: - bytes – The encoded bytes
Throws:
/**
* Create a new DER decoder from a byte array.
*
* @param bytes The encoded bytes
* @throws VertxException
*/
DerParser(byte[] bytes) throws VertxException {
this(Buffer.buffer(bytes));
}
private int readByte() throws VertxException {
if (pos + 1 >= in.length()) {
throw new VertxException("Invalid DER: stream too short, missing tag");
}
return in.getUnsignedByte(pos++);
}
private byte[] readBytes(int len) throws VertxException {
if (pos + len > in.length()) {
throw new VertxException("Invalid DER: stream too short, missing tag");
}
Buffer s = in.slice(pos, pos + len);
pos += len;
return s.getBytes();
}
Read next object. If it's constructed, the value holds encoded content and it should be parsed by a new parser from Asn1Object.getParser
. Throws: Returns: A object
/**
* Read next object. If it's constructed, the value holds
* encoded content and it should be parsed by a new
* parser from {@code Asn1Object.getParser}.
*
* @return A object
* @throws VertxException
*/
public Asn1Object read() throws VertxException {
int tag = readByte();
int length = getLength();
byte[] value = readBytes(length);
return new Asn1Object(tag, length, value);
}
Decode the length of the field. Can only support length
encoding up to 4 octets.
In BER/DER encoding, length can be encoded in 2 forms,
- Short form. One octet. Bit 8 has value "0" and bits 7-1
give the length.
- Long form. Two to 127 octets (only 4 is supported here).
Bit 8 of first octet has value "1" and bits 7-1 give the
number of additional length octets. Second and following
octets give the length, base 256, most significant digit first.
Throws: Returns: The length as integer
/**
* Decode the length of the field. Can only support length
* encoding up to 4 octets.
* <p/>
* <p/>In BER/DER encoding, length can be encoded in 2 forms,
* <ul>
* <li>Short form. One octet. Bit 8 has value "0" and bits 7-1
* give the length.
* <li>Long form. Two to 127 octets (only 4 is supported here).
* Bit 8 of first octet has value "1" and bits 7-1 give the
* number of additional length octets. Second and following
* octets give the length, base 256, most significant digit first.
* </ul>
*
* @return The length as integer
* @throws VertxException
*/
private int getLength() throws VertxException {
int i = readByte();
// A single byte short length
if ((i & ~0x7F) == 0) {
return i;
}
int num = i & 0x7F;
// We can't handle length longer than 4 bytes
if (i >= 0xFF || num > 4) {
throw new VertxException("Invalid DER: length field too big ("
+ i + ")");
}
byte[] bytes = readBytes(num);
return new BigInteger(1, bytes).intValue();
}
}
An ASN.1 TLV. The object is not parsed. It can
only handle integers and strings.
Author: zhang
/**
* An ASN.1 TLV. The object is not parsed. It can
* only handle integers and strings.
*
* @author zhang
*/
static class Asn1Object {
protected final int type;
protected final int length;
protected final byte[] value;
protected final int tag;
Construct a ASN.1 TLV. The TLV could be either a
constructed or primitive entity.
The first byte in DER encoding is made of following fields,
-------------------------------------------------
|Bit 8|Bit 7|Bit 6|Bit 5|Bit 4|Bit 3|Bit 2|Bit 1|
-------------------------------------------------
| Class | CF | + Type |
-------------------------------------------------
- Class: Universal, Application, Context or Private
- CF: Constructed flag. If 1, the field is constructed.
- Type: This is actually called tag in ASN.1. It
indicates data type (Integer, String) or a construct
(sequence, choice, set).
Params: - tag – Tag or Identifier
- length – Length of the field
- value – Encoded octet string for the field.
/**
* Construct a ASN.1 TLV. The TLV could be either a
* constructed or primitive entity.
* <p/>
* <p/>The first byte in DER encoding is made of following fields,
* <pre>
* -------------------------------------------------
* |Bit 8|Bit 7|Bit 6|Bit 5|Bit 4|Bit 3|Bit 2|Bit 1|
* -------------------------------------------------
* | Class | CF | + Type |
* -------------------------------------------------
* </pre>
* <ul>
* <li>Class: Universal, Application, Context or Private
* <li>CF: Constructed flag. If 1, the field is constructed.
* <li>Type: This is actually called tag in ASN.1. It
* indicates data type (Integer, String) or a construct
* (sequence, choice, set).
* </ul>
*
* @param tag Tag or Identifier
* @param length Length of the field
* @param value Encoded octet string for the field.
*/
public Asn1Object(int tag, int length, byte[] value) {
this.tag = tag;
this.type = tag & 0x1F;
this.length = length;
this.value = value;
}
public int getType() {
return type;
}
public int getLength() {
return length;
}
public byte[] getValue() {
return value;
}
public boolean isConstructed() {
return (tag & DerParser.CONSTRUCTED) == DerParser.CONSTRUCTED;
}
For constructed field, return a parser for its content.
Throws: Returns: A parser for the construct.
/**
* For constructed field, return a parser for its content.
*
* @return A parser for the construct.
* @throws VertxException
*/
public DerParser getParser() throws VertxException {
if (!isConstructed()) {
throw new VertxException("Invalid DER: can't parse primitive entity");
}
return new DerParser(value);
}
Get the value as integer
Throws: Returns: BigInteger
/**
* Get the value as integer
*
* @return BigInteger
* @throws VertxException
*/
public BigInteger getInteger() throws VertxException {
if (type != DerParser.INTEGER) {
throw new VertxException("Invalid DER: object is not integer");
}
return new BigInteger(value);
}
public byte[] getObjectIdentifier() throws VertxException {
switch(type) {
case DerParser.OBJECT_IDENTIFIER:
return value;
default:
throw new VertxException("Invalid DER: object is not an Object Identifier");
}
}
Get value as string. Most strings are treated
as Latin-1.
Throws: Returns: Java string
/**
* Get value as string. Most strings are treated
* as Latin-1.
*
* @return Java string
* @throws VertxException
*/
public String getString() throws VertxException {
String encoding;
switch (type) {
// Not all are Latin-1 but it's the closest thing
case DerParser.NUMERIC_STRING:
case DerParser.PRINTABLE_STRING:
case DerParser.VIDEOTEX_STRING:
case DerParser.IA5_STRING:
case DerParser.GRAPHIC_STRING:
case DerParser.ISO646_STRING:
case DerParser.GENERAL_STRING:
encoding = "ISO-8859-1";
break;
case DerParser.BMP_STRING:
encoding = "UTF-16BE";
break;
case DerParser.UTF8_STRING:
encoding = "UTF-8";
break;
case DerParser.UNIVERSAL_STRING:
throw new VertxException("Invalid DER: can't handle UCS-4 string");
default:
throw new VertxException("Invalid DER: object is not a string");
}
try {
return new String(value, encoding);
} catch (UnsupportedEncodingException e) {
throw new VertxException(e);
}
}
}
}