[−][src]Struct sequoia_openpgp::parse::stream::DetachedVerifier
Verifies a detached signature.
Signature verification requires processing the whole message first. Therefore, OpenPGP implementations supporting streaming operations necessarily must output unverified data. This has been a source of problems in the past. To alleviate this, we buffer up to 25 megabytes of net message data first, and verify the signatures if the message fits into our buffer. Nevertheless it is important to treat the data as unverified and untrustworthy until you have seen a positive verification.
Example
extern crate sequoia_openpgp as openpgp; use std::io::{self, Read}; use openpgp::{KeyID, Cert, Result}; use openpgp::parse::stream::*; use sequoia_openpgp::policy::StandardPolicy; let p = &StandardPolicy::new(); // This fetches keys and computes the validity of the verification. struct Helper {}; impl VerificationHelper for Helper { fn get_public_keys(&mut self, _ids: &[openpgp::KeyHandle]) -> Result<Vec<Cert>> { Ok(Vec::new()) // Feed the Certs to the verifier here... } fn check(&mut self, structure: MessageStructure) -> Result<()> { Ok(()) // Implement your verification policy here. } } let signature = b"-----BEGIN PGP SIGNATURE----- wnUEABYKACcFglt+z/EWoQSOjDP6RiYzeXbZeXgGnAw0jdgsGQmQBpwMNI3YLBkA AHmUAP9mpj2wV0/ekDuzxZrPQ0bnobFVaxZGg7YzdlksSOERrwEA6v6czXQjKcv2 KOwGTamb+ajTLQ3YRG9lh+ZYIXynvwE= =IJ29 -----END PGP SIGNATURE-----"; let data = b"Hello World!"; let h = Helper {}; let mut v = DetachedVerifier::from_bytes(p, signature, h, None)?; v.verify_bytes(data)?;
Implementations
impl<'a, H: VerificationHelper> DetachedVerifier<'a, H>
[src]
pub fn from_reader<S, T>(
policy: &'a dyn Policy,
signature_reader: S,
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
S: Read + 'a,
H: VerificationHelper,
T: Into<Option<SystemTime>>,
[src]
policy: &'a dyn Policy,
signature_reader: S,
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
S: Read + 'a,
H: VerificationHelper,
T: Into<Option<SystemTime>>,
Creates a Verifier
from the given readers.
Signature verifications are done relative to time t
, or the
current time, if t
is None
.
pub fn from_file<S, T>(
policy: &'a dyn Policy,
signature_path: S,
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
S: AsRef<Path>,
H: VerificationHelper,
T: Into<Option<SystemTime>>,
[src]
policy: &'a dyn Policy,
signature_path: S,
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
S: AsRef<Path>,
H: VerificationHelper,
T: Into<Option<SystemTime>>,
Creates a Verifier
from the given files.
Signature verifications are done relative to time t
, or the
current time, if t
is None
.
pub fn from_bytes<T>(
policy: &'a dyn Policy,
signature_bytes: &'a [u8],
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
H: VerificationHelper,
T: Into<Option<SystemTime>>,
[src]
policy: &'a dyn Policy,
signature_bytes: &'a [u8],
helper: H,
t: T
) -> Result<DetachedVerifier<'a, H>> where
H: VerificationHelper,
T: Into<Option<SystemTime>>,
Creates a Verifier
from the given buffers.
Signature verifications are done relative to time t
, or the
current time, if t
is None
.
pub fn verify_reader<R: Read>(&mut self, reader: R) -> Result<()>
[src]
Verifies the given data.
pub fn verify_file<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
[src]
Verifies the given data.
pub fn verify_bytes<B: AsRef<[u8]>>(&mut self, buf: B) -> Result<()>
[src]
Verifies the given data.
pub fn helper_ref(&self) -> &H
[src]
Returns a reference to the helper.
pub fn helper_mut(&mut self) -> &mut H
[src]
Returns a mutable reference to the helper.
pub fn into_helper(self) -> H
[src]
Recovers the helper.
Auto Trait Implementations
impl<'a, H> !RefUnwindSafe for DetachedVerifier<'a, H>
impl<'a, H> !Send for DetachedVerifier<'a, H>
impl<'a, H> !Sync for DetachedVerifier<'a, H>
impl<'a, H> Unpin for DetachedVerifier<'a, H> where
H: Unpin,
H: Unpin,
impl<'a, H> !UnwindSafe for DetachedVerifier<'a, H>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,