Package com.icodici.crypto

Class PrivateKey

java.lang.Object

com.icodici.crypto.AbstractKey

com.icodici.crypto.PrivateKey

All Implemented Interfaces:

KeyMatcher, net.sergeych.tools.Bindable

public class PrivateKey
extends AbstractKey

Basic private key used in the system. At the moment it is long RSA key ad probably more strong or at least the same than widely used elliptic curves.

Created by sergeych on 02/12/16.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PrivateKey.PasswordProtectedException

Field Summary

Fields inherited from class com.icodici.crypto.AbstractKey

FINGERPRINT_SHA256, FINGERPRINT_SHA384, keyInfo, TYPE_PRIVATE, TYPE_PRIVATE_PASSWORD, TYPE_PRIVATE_PASSWORD_V2, TYPE_PUBLIC

Constructor Summary

Constructors

Constructor	Description
PrivateKey()	Used to load stored keys, see Bindable in AbstractKey.
PrivateKey(byte[] packedBinaryKey)
PrivateKey(byte[] packedBinaryKey, KeyInfo info)
PrivateKey(int bitStrength)

Method Summary

Modifier and Type	Method	Description
boolean	canSign()	If it is an instance of the private key, it will return true, then AbstractKey.getPublicKey() must return valid key.
byte[]	decrypt(byte[] encrypted)
boolean	equals(java.lang.Object obj)
byte[]	fingerprint()	The fingerprint of the key is a uniqie sequence of bytes that matches the key without compromising it.
static PrivateKey	fromPath(java.nio.file.Path path)
PublicKey	getPublicKey()	Return valid public key, for example self, or raise the exception.
int	hashCode()
KeyInfo	info()
boolean	isPrivate()
byte[]	pack()
byte[]	packWithPassword(java.lang.String password)
byte[]	packWithPassword(java.lang.String password, int rounds)
byte[]	sign(java.io.InputStream input, HashType hashType)
static PrivateKey	unpackWithPassword(byte[] packedBinary, java.lang.String password)
Digest	updateDigestWithKeyComponents(Digest digest)	Arbitrary fingerprint calculation.

Methods inherited from class com.icodici.crypto.AbstractKey

address, asKeySource, createAnonymousId, encrypt, fromBinder, getLongAddress, getShortAddress, isMatchingKey, isMatchingKeyAddress, isPublic, matchAnonymousId, matchTag, matchType, packedInfo, packToBase64String, setTag, setTag, sign, toBinder, toString, unpack, updateFrom, verify, verify, verify

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PrivateKey

public PrivateKey(byte[] packedBinaryKey,
                  KeyInfo info)
           throws EncryptionError

Throws:

EncryptionError

PrivateKey

public PrivateKey(byte[] packedBinaryKey)
           throws EncryptionError

Throws:

EncryptionError

PrivateKey

public PrivateKey(int bitStrength)

PrivateKey

public PrivateKey()

Used to load stored keys, see Bindable in AbstractKey.

Never use it directly.

Method Detail

canSign

public boolean canSign()

Description copied from class: AbstractKey

If it is an instance of the private key, it will return true, then AbstractKey.getPublicKey() must return valid key.

Overrides:

canSign in class AbstractKey

Returns:

isPrivate

public boolean isPrivate()

Overrides:

isPrivate in class AbstractKey

decrypt

public byte[] decrypt(byte[] encrypted)
               throws EncryptionError

Overrides:

decrypt in class AbstractKey

Throws:

EncryptionError

getPublicKey

public PublicKey getPublicKey()

Description copied from class: AbstractKey

Return valid public key, for example self, or raise the exception. This implementation returns self if AbstractKey.isPublic() or throws an exception.

Overrides:

getPublicKey in class AbstractKey

Returns:

pack

public byte[] pack()

Overrides:

pack in class AbstractKey

sign

public byte[] sign(java.io.InputStream input,
                   HashType hashType)
            throws EncryptionError,
                   java.io.IOException

Overrides:

sign in class AbstractKey

Throws:

EncryptionError

java.io.IOException

info

public KeyInfo info()

Overrides:

info in class AbstractKey

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

fingerprint

public byte[] fingerprint()

Description copied from class: AbstractKey

The fingerprint of the key is a uniqie sequence of bytes that matches the key without compromising it. In fact, only public keys can have it, for symmetric keys the fingerprint will compromise it.

Therefore, the private key fingerprint is its public key fingerprint. The public key fingerprint is calculated using some hash over it's parameters, see PublicKey.fingerprint()

Overrides:

fingerprint in class AbstractKey

Returns:

fromPath

public static PrivateKey fromPath(java.nio.file.Path path)
                           throws java.io.IOException

Throws:

java.io.IOException

updateDigestWithKeyComponents

public Digest updateDigestWithKeyComponents(Digest digest)

Description copied from class: AbstractKey

Arbitrary fingerprint calculation. As the digest may be different adn it might be useful to include more information than a key to it, it is possible to update some digest instance with key data.

Create any digest you need and call this method to update it with a ket data.

This can and should be used to obtain higher-order composite fingerprints for high security setups.

Overrides:

updateDigestWithKeyComponents in class AbstractKey

Returns:

same digest instance (to chain calls)

packWithPassword

public byte[] packWithPassword(java.lang.String password)
                        throws EncryptionError

Throws:

EncryptionError

packWithPassword

public byte[] packWithPassword(java.lang.String password,
                               int rounds)
                        throws EncryptionError

Throws:

EncryptionError

unpackWithPassword

public static PrivateKey unpackWithPassword(byte[] packedBinary,
                                            java.lang.String password)
                                     throws EncryptionError

Throws:

EncryptionError