From e9ca8df9567a8d603f068091b71501145607cebd Mon Sep 17 00:00:00 2001 From: Paul Schaub Date: Wed, 25 Jul 2018 22:49:02 +0200 Subject: [PATCH] Add javadoc to MissingPublicKeyCallback --- .../MissingPublicKeyCallback.java | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java b/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java index f41b60ed..ed52dfa4 100644 --- a/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java +++ b/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java @@ -19,6 +19,16 @@ import org.bouncycastle.openpgp.PGPPublicKey; public interface MissingPublicKeyCallback { + /** + * This method gets called if we encounter a signature of an unknown key. + * + * Note: It would be super cool to provide the OpenPgp fingerprint here, but unfortunately signatures only contain + * the key id (see https://tools.ietf.org/html/rfc4880#section-5.2.3.5) + * + * @param keyId ID of the missing key + * + * @return the key or null + */ PGPPublicKey onMissingPublicKeyEncountered(Long keyId); }