identity_storage 1.5.1

Abstractions over storage for cryptographic keys used in DID Documents
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

// Copyright 2020-2023 IOTA Stiftung
// SPDX-License-Identifier: Apache-2.0

use identity_core::common::Object;
use identity_core::common::Url;

/// Options for creating a JSON Web Signature.
#[non_exhaustive]
#[derive(Debug, Default, serde::Serialize, serde::Deserialize, Eq, PartialEq, Clone)]
#[serde(rename_all = "camelCase")]
#[serde(default)]
pub struct JwsSignatureOptions {
  /// Whether to attach the public key in the corresponding method
  /// to the JWS header.
  pub attach_jwk: bool,

  /// Whether to Base64url encode the payload or not.
  ///
  /// [More Info](https://tools.ietf.org/html/rfc7797#section-3)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub b64: Option<bool>,

  /// The Type value to be placed in the protected header.
  ///
  /// [More Info](https://tools.ietf.org/html/rfc7515#section-4.1.9)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub typ: Option<String>,

  /// Content Type to be placed in the protected header.
  ///
  /// [More Info](https://tools.ietf.org/html/rfc7515#section-4.1.10)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub cty: Option<String>,

  /// The URL to be placed in the protected header.
  ///
  /// [More Info](https://tools.ietf.org/html/rfc8555#section-6.4.1)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub url: Option<Url>,

  /// The nonce to be placed in the protected header.
  ///
  /// [More Info](https://tools.ietf.org/html/rfc8555#section-6.5.2)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub nonce: Option<String>,

  /// The kid to set in the protected header.
  ///
  /// If unset, the kid of the JWK with which the JWS is produced is used.
  ///
  /// [More Info](https://www.rfc-editor.org/rfc/rfc7515#section-4.1.4)
  #[serde(skip_serializing_if = "Option::is_none")]
  pub kid: Option<String>,

  /// Whether the payload should be detached from the JWS.
  ///
  /// [More Info](https://www.rfc-editor.org/rfc/rfc7515#appendix-F).
  pub detached_payload: bool,

  /// Additional header parameters.
  #[serde(skip_serializing_if = "Option::is_none")]
  pub custom_header_parameters: Option<Object>,
}

impl JwsSignatureOptions {
  /// Creates a new [`JwsSignatureOptions`].
  pub fn new() -> Self {
    Self::default()
  }

  /// Replace the value of the `attach_jwk` field.
  pub fn attach_jwk_to_header(mut self, value: bool) -> Self {
    self.attach_jwk = value;
    self
  }

  /// Replace the value of the `b64` field.
  pub fn b64(mut self, value: bool) -> Self {
    self.b64 = Some(value);
    self
  }

  /// Replace the value of the `typ` field.
  pub fn typ(mut self, value: impl Into<String>) -> Self {
    self.typ = Some(value.into());
    self
  }

  /// Replace the value of the `cty` field.
  pub fn cty(mut self, value: impl Into<String>) -> Self {
    self.cty = Some(value.into());
    self
  }

  /// Replace the value of the `url` field.
  pub fn url(mut self, value: Url) -> Self {
    self.url = Some(value);
    self
  }

  /// Replace the value of the `nonce` field.
  pub fn nonce(mut self, value: impl Into<String>) -> Self {
    self.nonce = Some(value.into());
    self
  }

  /// Replace the value of the `kid` field.
  pub fn kid(mut self, value: impl Into<String>) -> Self {
    self.kid = Some(value.into());
    self
  }

  /// Replace the value of the `detached_payload` field.
  pub fn detached_payload(mut self, value: bool) -> Self {
    self.detached_payload = value;
    self
  }

  /// Adds additional header parameters.
  pub fn custom_header_parameters(mut self, value: Object) -> Self {
    self.custom_header_parameters = Some(value);
    self
  }
}