Package com.icodici.crypto

Class AbstractPublicKey

java.lang.Object

com.icodici.crypto.AbstractKey

com.icodici.crypto.AbstractAsymmetricKey

com.icodici.crypto.AbstractPublicKey

All Implemented Interfaces:

KeyMatcher, net.sergeych.tools.Bindable, net.sergeych.tools.Hashable

Direct Known Subclasses:

RSAOAEPPublicKey

public abstract class AbstractPublicKey
extends AbstractAsymmetricKey
implements net.sergeych.tools.Hashable

Generic public key interface.

Important: The Key can be in not-initialized state after creation, in which case the depending methods must throw IllegalStateException. Non-initialized state is a transient state between creation and construction from the hash or generation new key.

Created by sergeych on 15/04/16.

Nested Class Summary

Nested classes/interfaces inherited from interface net.sergeych.tools.Hashable

net.sergeych.tools.Hashable.Error

Field Summary

Fields inherited from class com.icodici.crypto.AbstractAsymmetricKey

MAX_SALT_LENGTH

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
AbstractPublicKey()

Method Summary

Modifier and Type	Method	Description
abstract java.lang.String	algorithmTag()	Any encryption type has an unique tag.
abstract boolean	canEncrypt()	Check that this key instance is suitable for encryption too (some keys can provide checkSignature only functionality).
boolean	checkSignature(byte[] input, byte[] signature, HashType hashType)
boolean	checkSignature(byte[] input, byte[] signature, HashType hashType, int saltLength)
boolean	checkSignature(java.io.InputStream input, byte[] signature, HashType hashType)	Check the digital signature.
abstract boolean	checkSignature(java.io.InputStream input, byte[] signature, HashType hashType, int saltLength)	Check the digital signature.
boolean	checkSignature(java.lang.String data, byte[] signature, HashType hashType)
abstract byte[]	encrypt(byte[] plaintext)	Public-key encryption of the block.
byte[]	encrypt(java.lang.String data)	Encrypt data of the string using UTF-8 encoding
abstract int	getBitStrength()
abstract boolean	isInitialized()	True if the key is properly initialized

Methods inherited from class com.icodici.crypto.AbstractAsymmetricKey

getMaxSaltLength

Methods inherited from class com.icodici.crypto.AbstractKey

address, asKeySource, canSign, createAnonymousId, decrypt, fingerprint, fromBinder, getLongAddress, getPublicKey, getShortAddress, info, isMatchingKey, isMatchingKeyAddress, isPrivate, isPublic, matchAnonymousId, matchTag, matchType, pack, packedInfo, packToBase64String, setTag, setTag, sign, sign, toBinder, toString, unpack, updateDigestWithKeyComponents, updateFrom, verify, verify, verify

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sergeych.tools.Hashable

toHash, updateFromHash

Constructor Detail

AbstractPublicKey

public AbstractPublicKey()

Method Detail

canEncrypt

public abstract boolean canEncrypt()

Check that this key instance is suitable for encryption too (some keys can provide checkSignature only functionality).

Returns:

true if this key can encrypt.

getBitStrength

public abstract int getBitStrength()

Returns:

bit strength of the key, e.g. 2048 ro RSA.

isInitialized

public abstract boolean isInitialized()

True if the key is properly initialized

encrypt

public abstract byte[] encrypt(byte[] plaintext)
                        throws EncryptionError

Public-key encryption of the block.

Overrides:

encrypt in class AbstractKey

Parameters:

plaintext - data to encrypt.

Throws:

EncryptionError - if the key can't encrypt, data too large for the key or any other error that prevents data to be encrypted.

checkSignature

public abstract boolean checkSignature(java.io.InputStream input,
                                       byte[] signature,
                                       HashType hashType,
                                       int saltLength)
                                throws java.io.IOException,
                                       java.lang.IllegalStateException

Check the digital signature. As very large documents can be signed, we represent them as streams. The document can be way too large to load the whole into memory, so implementations should calculate the signature by reading portions of it from the stream.

The method must not throw exception if the signature is bad. e.g. improper, has wrong structure and so on. Instead, it must return false.

Parameters:

input - source data

signature - signature to check

Returns:

true if the signature is valid, false if not.

Throws:

java.io.IOException - failed to read the input stream (including empty stream, EOF at start)

java.lang.IllegalStateException

checkSignature

public boolean checkSignature(java.io.InputStream input,
                              byte[] signature,
                              HashType hashType)
                       throws java.io.IOException,
                              java.lang.IllegalStateException

Check the digital signature. As very large documents can be signed, we represent them as streams. The document can be way too large to load the whole into memory, so implementations should calculate the signature by reading portions of it from the stream.

The method must not throw exception if the signature is bad. e.g. improper, has wrong structure and so on. Instead, it must return false.

Parameters:

input - source data

signature - signature to check

Returns:

true if the signature is valid, false if not.

Throws:

java.io.IOException - failed to read the input stream (including empty stream, EOF at start)

java.lang.IllegalStateException

algorithmTag

public abstract java.lang.String algorithmTag()

Any encryption type has an unique tag. For RSAES-OAEP the tag is r1. For elliptic curve variant used in bitcoin, "e1" and so on. The tag is not intended to be human readable, it is used to properly select decryption method and not waste package space.

Returns:

encryption method tag

checkSignature

public boolean checkSignature(byte[] input,
                              byte[] signature,
                              HashType hashType,
                              int saltLength)

Parameters:

input - to check the signature against.

signature - signature to check

hashType - type of the hash function used to create the signature

Returns:

true if the signature is correct.

checkSignature

public boolean checkSignature(byte[] input,
                              byte[] signature,
                              HashType hashType)

Parameters:

input - to check the signature against.

signature - signature to check

hashType - type of the hash function used to create the signature

Returns:

true if the signature is correct.

checkSignature

public boolean checkSignature(java.lang.String data,
                              byte[] signature,
                              HashType hashType)

Parameters:

data - to check the signature against.

signature - signature to check

Returns:

true if the signature is correct.

encrypt

public byte[] encrypt(java.lang.String data)
               throws EncryptionError

Encrypt data of the string using UTF-8 encoding

Parameters:

data - to encrypt

Returns:

encrypted data

Throws:

EncryptionError