SignatureList Event
Fires for each signature of the current key when ListSignatures is called.
Syntax
keymgr.on('SignatureList', [callback])
Callback
The 'callback' is called when the 'SignatureList' event is emited.
function(e){ }
The argument 'e' has the following properties:
e.userId e.issuerKeyId e.issuerUserId e.publicKeyAlgorithm e.curve e.hashAlgorithm e.effectiveDate e.signatureClass e.validityStatus
Remarks
This event fires once for each signature of the current key when ListSignatures is called.
UserId holds the current user Id of the key.
The UserId format is:
FirstName LastName (Comment) <Email>Not all values are required when selecting or generating a key, but at least FirstName or Email are required.
IssuerKeyId is the hex-encoded, 4- or-8-byte Id of the issuer's key. It is the same as the last 4 or 8 bytes of the Fingerprint. For instance:
BF52A0AB
IssuerUserId is the user Id of the issuer. If this is empty the issuer's key could not be found in the current keyring.
PublicKeyAlgorithm is the public key algorithm. Possible values are:
- RSA
- DSA
- ECDSA
- EdDSA
Curve is the curve used by the key when PublicKeyAlgorithm is ECDSA or EdDSA. Possible values are:
Value | PublicKeyAlgorithm | Description |
secp256r1 | ECDSA | NIST curve P-256 |
secp384r1 | ECDSA | NIST curve P-384 |
secp521r1 | ECDSA | NIST curve P-521 |
Ed25519 | EdDSA | Ed25519 |
secp256k1 | EdDSA | Secp256k1 |
HashAlgorithm is the hash algorithm used by the signature. Possible values are:
- SHA1
- SHA256
- SHA384
- SHA512
- SHA224
- MD5
EffectiveDate is the date when this signature became valid. The following example illustrates the format of an encoded date:
23-Jan-2000 15:00:00.
SignatureClass is the type of signature. Possible values are:
16 | Generic Signature |
17 | Personal Signature |
18 | Casual Signature |
19 | Positive Signature (self-signed) |
ValidityStatus specifies the current validity status of the signature. Possible values are:
1 | Invalid |
2 | Valid |
3 | Unknown (the issuer's public key could not be found) |