Class SM9SigPrivateKeyParameters
- All Implemented Interfaces:
Destroyable, CipherParameters
-
Method Summary
Modifier and TypeMethodDescriptionvoiddestroy()Destroy this object, dropping its reference to the private point ds and zeroizing the identity.static SM9SigPrivateKeyParametersfromEncoded(byte[] enc, SM9SigMasterPublicKeyParameters masterPublicKey, byte[] identity) Rebuild a signature user key from its bare point encoding, under the master public key and identity it was derived for, which the encoding does not carry.byte[]The user's signature private key point ds of G1 in uncompressed form (0x04 || x || y, 65 bytes).byte[]The identity this key was derived for.booleanMethods inherited from class AsymmetricKeyParameter
isPrivate
-
Method Details
-
getPrivatePoint
-
getMasterPublicKey
-
getIdentity
public byte[] getIdentity()The identity this key was derived for. Synchronized withdestroy(), which zeroes the array in place: the flag is set before the clear, but reading a byte the clear has already written does not order the reader after the flag, so an unsynchronized copy could return a partly zeroed identity with the flag still reading false. -
getEncoded
public byte[] getEncoded()The user's signature private key point ds of G1 in uncompressed form (0x04 || x || y, 65 bytes). The master public key and identity are not part of this encoding; supply them viafromEncoded(byte[], SM9SigMasterPublicKeyParameters, byte[])to rebuild a usable key. -
fromEncoded
public static SM9SigPrivateKeyParameters fromEncoded(byte[] enc, SM9SigMasterPublicKeyParameters masterPublicKey, byte[] identity) Rebuild a signature user key from its bare point encoding, under the master public key and identity it was derived for, which the encoding does not carry. The point is refused unless it is a point of G1 other than the point at infinity.The point is also checked against the master public key and identity, by the KGC's own relation e(ds, [H1(ID || hid, N)]P2 + P_pub-s) = e(P1, P_pub-s), which holds exactly when ds = [ks * (H1(ID || hid, N) + ks)^-1]P1 for the ks behind that P_pub-s: a point paired with another master public key, or filed under another identity, is refused with an
IllegalArgumentExceptionrather than imported as a key whose signatures would not verify. ds is secret and the pairing takes its G1 argument to be public, so the relation is checked on [r]ds for a random r, against e(P1, P_pub-s)^r, raised as signing raises it. The check costs a pairing and about what a signature costs.- Parameters:
enc- the encodinggetEncoded()writes.masterPublicKey- the signature master public key the key was derived under.identity- the identity the key was derived for.- Returns:
- the rebuilt key.
-
destroy
public void destroy()Destroy this object, dropping its reference to the private point ds and zeroizing the identity.As the point's coordinates are immutable they cannot be zeroized in place; destruction drops the reference and marks the key destroyed, after which
getPrivatePoint(),getEncoded()andgetIdentity()throwIllegalStateException. The master public key remains available.- Specified by:
destroyin interfaceDestroyable
-
isDestroyed
public boolean isDestroyed()- Specified by:
isDestroyedin interfaceDestroyable
-