Package net.i2p.crypto

Class SigUtil

java.lang.Object

net.i2p.crypto.SigUtil

public final class SigUtil
extends Object

Utilities for Signing keys and Signatures

Since:

0.9.9, public since 0.9.12

Method Summary

Modifier and Type	Method	Description
static NativeBigInteger[]	aSN1ToBigInteger(byte[] asn, int len)	See above.
static void	clearCaches()
(package private) static byte[]	combine(BigInteger x, BigInteger y, int len)	Combine two BigIntegers of nominal length = len / 2
static SigningPrivateKey	fromJavaKey(DSAPrivateKey pk)
static SigningPublicKey	fromJavaKey(DSAPublicKey pk)
static SigningPrivateKey	fromJavaKey(ECPrivateKey pk, SigType type)
static SigningPublicKey	fromJavaKey(ECPublicKey pk, SigType type)
static SigningPrivateKey	fromJavaKey(RSAPrivateKey pk, SigType type)	As of 0.9.31, if pk is a RSAPrivateCrtKey, this will return a RSASigningPrivateCrtKey.
static SigningPublicKey	fromJavaKey(RSAPublicKey pk, SigType type)
static SigningPrivateKey	fromJavaKey(PrivateKey pk)	Use if SigType is unknown.
static SigningPrivateKey	fromJavaKey(PrivateKey pk, SigType type)	Use if SigType is known.
static SigningPublicKey	fromJavaKey(PublicKey pk)	Use if SigType is unknown.
static SigningPublicKey	fromJavaKey(PublicKey pk, SigType type)	Use if SigType is known.
static SigningPrivateKey	fromJavaKey(EdDSAPrivateKey pk, SigType type)
static SigningPublicKey	fromJavaKey(EdDSAPublicKey pk, SigType type)
static Signature	fromJavaSig(byte[] asn, SigType type)
static PrivateKey	importJavaPrivateKey(File file, SigType type)
static PublicKey	importJavaPublicKey(File file, SigType type)
static int	intToASN1(byte[] d, int idx, int val)	Output an length or integer value in ASN.1 Does NOT output the tag e.g.
static byte[]	rectify(BigInteger bi, int len)
static byte[]	sigBytesToASN1(BigInteger r, BigInteger s)	http://download.oracle.com/javase/1.5.0/docs/guide/security/CryptoSpec.html
static DSAPrivateKey	toJavaDSAKey(SigningPrivateKey pk)
static DSAPublicKey	toJavaDSAKey(SigningPublicKey pk)
static ECPrivateKey	toJavaECKey(SigningPrivateKey pk)
static ECPublicKey	toJavaECKey(SigningPublicKey pk)
static EdDSAPrivateKey	toJavaEdDSAKey(SigningPrivateKey pk)
static EdDSAPublicKey	toJavaEdDSAKey(SigningPublicKey pk)
static PrivateKey	toJavaKey(SigningPrivateKey pk)
static PublicKey	toJavaKey(SigningPublicKey pk)
static RSAPrivateKey	toJavaRSAKey(SigningPrivateKey pk)	As of 0.9.31, if pk is a RSASigningPrivateCrtKey, this will return a RSAPrivateCrtKey.
static RSAPublicKey	toJavaRSAKey(SigningPublicKey pk)	Deprecated. unused
static byte[]	toJavaSig(Signature sig)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

toJavaKey

public static PublicKey toJavaKey(SigningPublicKey pk)
                           throws GeneralSecurityException

Returns:

JAVA key!

Throws:

GeneralSecurityException

toJavaKey

public static PrivateKey toJavaKey(SigningPrivateKey pk)
                            throws GeneralSecurityException

Returns:

JAVA key!

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPublicKey fromJavaKey(PublicKey pk)
                                    throws GeneralSecurityException

Use if SigType is unknown. For efficiency, use fromJavakey(pk, type) if type is known.

Parameters:

pk - JAVA key!

Throws:

IllegalArgumentException - on unknown type

GeneralSecurityException

Since:

0.9.18

fromJavaKey

public static SigningPublicKey fromJavaKey(PublicKey pk,
                                           SigType type)
                                    throws GeneralSecurityException

Use if SigType is known.

Parameters:

pk - JAVA key!

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPrivateKey fromJavaKey(PrivateKey pk)
                                     throws GeneralSecurityException

Use if SigType is unknown. For efficiency, use fromJavakey(pk, type) if type is known.

Parameters:

pk - JAVA key!

Throws:

IllegalArgumentException - on unknown type

GeneralSecurityException

Since:

0.9.18

fromJavaKey

public static SigningPrivateKey fromJavaKey(PrivateKey pk,
                                            SigType type)
                                     throws GeneralSecurityException

Use if SigType is known.

Parameters:

pk - JAVA key!

Throws:

GeneralSecurityException

toJavaECKey

public static ECPublicKey toJavaECKey(SigningPublicKey pk)
                               throws GeneralSecurityException

Returns:

JAVA key!

Throws:

GeneralSecurityException

toJavaECKey

public static ECPrivateKey toJavaECKey(SigningPrivateKey pk)
                                throws GeneralSecurityException

Returns:

JAVA key!

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPublicKey fromJavaKey(ECPublicKey pk,
                                           SigType type)
                                    throws GeneralSecurityException

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPrivateKey fromJavaKey(ECPrivateKey pk,
                                            SigType type)
                                     throws GeneralSecurityException

Throws:

GeneralSecurityException

toJavaEdDSAKey

public static EdDSAPublicKey toJavaEdDSAKey(SigningPublicKey pk)
                                     throws GeneralSecurityException

Returns:

JAVA EdDSA public key!

Throws:

GeneralSecurityException

Since:

0.9.15

toJavaEdDSAKey

public static EdDSAPrivateKey toJavaEdDSAKey(SigningPrivateKey pk)
                                      throws GeneralSecurityException

Returns:

JAVA EdDSA private key!

Throws:

GeneralSecurityException

Since:

0.9.15

fromJavaKey

public static SigningPublicKey fromJavaKey(EdDSAPublicKey pk,
                                           SigType type)
                                    throws GeneralSecurityException

Throws:

GeneralSecurityException

Since:

0.9.15

fromJavaKey

public static SigningPrivateKey fromJavaKey(EdDSAPrivateKey pk,
                                            SigType type)
                                     throws GeneralSecurityException

Throws:

GeneralSecurityException

Since:

0.9.15

toJavaDSAKey

public static DSAPublicKey toJavaDSAKey(SigningPublicKey pk)
                                 throws GeneralSecurityException

Throws:

GeneralSecurityException

toJavaDSAKey

public static DSAPrivateKey toJavaDSAKey(SigningPrivateKey pk)
                                  throws GeneralSecurityException

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPublicKey fromJavaKey(DSAPublicKey pk)
                                    throws GeneralSecurityException

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPrivateKey fromJavaKey(DSAPrivateKey pk)
                                     throws GeneralSecurityException

Throws:

GeneralSecurityException

toJavaRSAKey

public static RSAPublicKey toJavaRSAKey(SigningPublicKey pk)
                                 throws GeneralSecurityException

Deprecated.

unused

Throws:

GeneralSecurityException

toJavaRSAKey

public static RSAPrivateKey toJavaRSAKey(SigningPrivateKey pk)
                                  throws GeneralSecurityException

As of 0.9.31, if pk is a RSASigningPrivateCrtKey, this will return a RSAPrivateCrtKey.

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPublicKey fromJavaKey(RSAPublicKey pk,
                                           SigType type)
                                    throws GeneralSecurityException

Throws:

GeneralSecurityException

fromJavaKey

public static SigningPrivateKey fromJavaKey(RSAPrivateKey pk,
                                            SigType type)
                                     throws GeneralSecurityException

As of 0.9.31, if pk is a RSAPrivateCrtKey, this will return a RSASigningPrivateCrtKey.

Throws:

GeneralSecurityException

toJavaSig

public static byte[] toJavaSig(Signature sig)

Returns:

ASN.1 representation

fromJavaSig

public static Signature fromJavaSig(byte[] asn,
                                    SigType type)
                             throws SignatureException

Parameters:

asn - ASN.1 representation

Returns:

a Signature with SigType type

Throws:

SignatureException

importJavaPublicKey

public static PublicKey importJavaPublicKey(File file,
                                            SigType type)
                                     throws GeneralSecurityException,
                                            IOException

Returns:

JAVA key!

Throws:

GeneralSecurityException

IOException

importJavaPrivateKey

public static PrivateKey importJavaPrivateKey(File file,
                                              SigType type)
                                       throws GeneralSecurityException,
                                              IOException

Returns:

JAVA key!

Throws:

GeneralSecurityException

IOException

combine

static byte[] combine(BigInteger x,
                      BigInteger y,
                      int len)
               throws InvalidKeyException

Combine two BigIntegers of nominal length = len / 2

Returns:

array of exactly len bytes

Throws:

InvalidKeyException

Since:

0.9.9, package private since 0.9.31

rectify

public static byte[] rectify(BigInteger bi,
                             int len)
                      throws InvalidKeyException

Parameters:

bi - non-negative

Returns:

array of exactly len bytes

Throws:

InvalidKeyException

sigBytesToASN1

public static byte[] sigBytesToASN1(BigInteger r,
                                    BigInteger s)

http://download.oracle.com/javase/1.5.0/docs/guide/security/CryptoSpec.html

  Signature Format: ASN.1 sequence of two INTEGER values: r and s, in that order:
                                SEQUENCE ::= { r INTEGER, s INTEGER }

  http://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One
  30 -- tag indicating SEQUENCE
  xx - length in octets

  02 -- tag indicating INTEGER
  xx - length in octets
  xxxxxx - value

r and s are always non-negative. Only supports sigs up to about 65530 bytes. See code to fix BER encoding for this before you add a SigType with bigger signatures.

Throws:

IllegalArgumentException - if too big

Since:

0.9.25, split out from sigBytesToASN1(byte[])

intToASN1

public static int intToASN1(byte[] d,
                            int idx,
                            int val)

Output an length or integer value in ASN.1 Does NOT output the tag e.g. 0x02 / 0x30

Parameters:

val - 0-65535

Returns:

the new index

Since:

0.9.25

aSN1ToBigInteger

public static NativeBigInteger[] aSN1ToBigInteger(byte[] asn,
                                                  int len)
                                           throws SignatureException

See above. Only supports sigs up to about 65530 bytes. See code to fix BER encoding for bigger than that.

Parameters:

len - nominal length of each BigInteger

Returns:

two BigIntegers

Throws:

SignatureException

Since:

0.9.25

clearCaches

public static void clearCaches()