huskarl-core 0.8.1

Base library for huskarl (OAuth2 client) ecosystem.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use std::{borrow::Cow, sync::Arc};

use crate::{
    crypto::signer::{JwsSigner, JwsSignerSelector},
    jwk::PublicJwk,
    platform::MaybeSendBoxFuture,
};

/// A selector for an asymmetric JWS signer.
///
/// This is a refinement of [`JwsSignerSelector`] for asymmetric keys — it
/// additionally requires that the selected signer exposes its public key
/// (via [`AsymmetricJwsSigner`]) and supports selection by JWK thumbprint
/// (used for `DPoP` key confirmation).
///
/// Because `AsymmetricJwsSignerSelector` is a subtrait of `JwsSignerSelector`,
/// any asymmetric selector can be used wherever a plain `JwsSignerSelector` is
/// required (for example as the signer of
/// [`JwtBearer`](crate::client_auth::JwtBearer)). Implement the supertrait's
/// [`select_signer`](JwsSignerSelector::select_signer) by delegating:
/// `Box::pin(async move { self.select_asymmetric_signer().await })` (the `Arc`
/// upcasts).
pub trait AsymmetricJwsSignerSelector: JwsSignerSelector {
    /// Selects the current asymmetric JWS signer to use for signing, refreshing
    /// stale key material first where the implementation supports it.
    fn select_asymmetric_signer(&self) -> MaybeSendBoxFuture<'_, Arc<dyn AsymmetricJwsSigner>>;

    /// Selects the asymmetric JWS signer to use for signing by its thumbprint,
    /// refreshing stale key material first where the implementation supports it.
    fn select_signer_by_thumbprint<'a>(
        &'a self,
        thumbprint: &'a str,
    ) -> MaybeSendBoxFuture<'a, Option<Arc<dyn AsymmetricJwsSigner>>>;
}

/// Trait for asymmetric signers that produce RFC 7515 (JWS) / RFC 7518 (JWA) compatible signatures.
pub trait AsymmetricJwsSigner: JwsSigner {
    /// Returns the public key JWK for this signer.
    fn public_key_jwk(&self) -> Cow<'_, PublicJwk>;
}

impl<T: AsymmetricJwsSignerSelector + ?Sized> AsymmetricJwsSignerSelector for &T {
    fn select_asymmetric_signer(&self) -> MaybeSendBoxFuture<'_, Arc<dyn AsymmetricJwsSigner>> {
        (**self).select_asymmetric_signer()
    }

    fn select_signer_by_thumbprint<'a>(
        &'a self,
        thumbprint: &'a str,
    ) -> MaybeSendBoxFuture<'a, Option<Arc<dyn AsymmetricJwsSigner>>> {
        (**self).select_signer_by_thumbprint(thumbprint)
    }
}

impl<T: AsymmetricJwsSignerSelector + ?Sized> AsymmetricJwsSignerSelector for Box<T> {
    fn select_asymmetric_signer(&self) -> MaybeSendBoxFuture<'_, Arc<dyn AsymmetricJwsSigner>> {
        (**self).select_asymmetric_signer()
    }

    fn select_signer_by_thumbprint<'a>(
        &'a self,
        thumbprint: &'a str,
    ) -> MaybeSendBoxFuture<'a, Option<Arc<dyn AsymmetricJwsSigner>>> {
        (**self).select_signer_by_thumbprint(thumbprint)
    }
}

impl<T: AsymmetricJwsSignerSelector + ?Sized> AsymmetricJwsSignerSelector for Arc<T> {
    fn select_asymmetric_signer(&self) -> MaybeSendBoxFuture<'_, Arc<dyn AsymmetricJwsSigner>> {
        (**self).select_asymmetric_signer()
    }

    fn select_signer_by_thumbprint<'a>(
        &'a self,
        thumbprint: &'a str,
    ) -> MaybeSendBoxFuture<'a, Option<Arc<dyn AsymmetricJwsSigner>>> {
        (**self).select_signer_by_thumbprint(thumbprint)
    }
}

impl<T: AsymmetricJwsSigner + ?Sized> AsymmetricJwsSigner for &T {
    fn public_key_jwk(&self) -> Cow<'_, PublicJwk> {
        (**self).public_key_jwk()
    }
}

impl<T: AsymmetricJwsSigner + ?Sized> AsymmetricJwsSigner for Box<T> {
    fn public_key_jwk(&self) -> Cow<'_, PublicJwk> {
        (**self).public_key_jwk()
    }
}

impl<T: AsymmetricJwsSigner + ?Sized> AsymmetricJwsSigner for Arc<T> {
    fn public_key_jwk(&self) -> Cow<'_, PublicJwk> {
        (**self).public_key_jwk()
    }
}