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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
use chrono::NaiveDate;
use serde::{Deserialize, Serialize};
use url::Url;
use validator::Validate;
use crate::{Address, StandardClaimsSubject, deserializers::bool_from_str_or_bool};
/// The userinfo struct contains all possible userinfo fields regardless of
/// scope.
///
/// See: [OpenID Connect Core 1.0: Standard Claims](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims)
#[derive(Debug, Default, Deserialize, Serialize, Validate, Clone, Eq, PartialEq)]
pub struct Userinfo {
/// Subject Identifier.
///
/// A locally unique and never reassigned identifier within the Issuer for
/// the End-User, which is intended to be consumed by the Client, e.g.,
/// `24400320` or `AItOawmwtWwcT0k51BayewNvutrJUqsvl6qs7A4`. It MUST NOT
/// exceed 255 ASCII [RFC20] characters in length. The `sub` value is a
/// case-sensitive string.
pub sub: String,
/// End-User's full name in displayable form including all name parts,
/// possibly including titles and suffixes, ordered according to the
/// End-User's locale and preferences.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub name: Option<String>,
/// Given name(s) or first name(s) of the End-User. Note that in some
/// cultures, people can have multiple given names; all can be present, with
/// the names being separated by space characters.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub given_name: Option<String>,
/// Surname(s) or last name(s) of the End-User. Note that in some cultures,
/// people can have multiple family names or no family name; all can be
/// present, with the names being separated by space characters.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub family_name: Option<String>,
/// Middle name(s) of the End-User. Note that in some cultures, people can
/// have multiple middle names; all can be present, with the names being
/// separated by space characters. Also note that in some cultures, middle
/// names are not used.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub middle_name: Option<String>,
/// Casual name of the End-User that may or may not be the same as the
/// given_name. For instance, a nickname value of Mike might be returned
/// alongside a given_name value of Michael.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub nickname: Option<String>,
/// Shorthand name by which the End-User wishes to be referred to at the RP,
/// such as janedoe or j.doe. This value MAY be any valid JSON string
/// including special characters such as @, /, or whitespace. The RP MUST
/// NOT rely upon this value being unique, as discussed in Section 5.7.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub preferred_username: Option<String>,
/// URL of the End-User's profile page. The contents of this Web page SHOULD
/// be about the End-User.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub profile: Option<Url>,
/// URL of the End-User's profile picture. This URL MUST refer to an image
/// file (for example, a PNG, JPEG, or GIF image file), rather than to a Web
/// page containing an image. Note that this URL SHOULD specifically
/// reference a profile photo of the End-User suitable for displaying when
/// describing the End-User, rather than an arbitrary photo taken by the
/// End-User.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub picture: Option<Url>,
/// URL of the End-User's Web page or blog. This Web page SHOULD contain
/// information published by the End-User or an organization that the
/// End-User is affiliated with.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub website: Option<Url>,
/// End-User's preferred e-mail address. Its value MUST conform to the RFC
/// 5322 [RFC5322] addr-spec syntax. The RP MUST NOT rely upon this value
/// being unique, as discussed in Section 5.7.
#[serde(default, skip_serializing_if = "Option::is_none")]
#[validate(email)]
pub email: Option<String>,
/// True if the End-User's e-mail address has been verified; otherwise
/// false. When this Claim Value is true, this means that the OP took
/// affirmative steps to ensure that this e-mail address was controlled by
/// the End-User at the time the verification was performed. The means by
/// which an e-mail address is verified is context-specific, and dependent
/// upon the trust framework or contractual agreements within which the
/// parties are operating.
#[serde(default, deserialize_with = "bool_from_str_or_bool")]
pub email_verified: bool,
// Isn't required to be just male or female
/// End-User's gender. Values defined by this specification are female and
/// male. Other values MAY be used when neither of the defined values are
/// applicable.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub gender: Option<String>,
// ISO 9601:2004 YYYY-MM-DD or YYYY.
/// End-User's birthday, represented as an ISO 8601:2004 [ISO8601‑2004]
/// YYYY-MM-DD format. The year MAY be 0000, indicating that it is omitted.
/// To represent only the year, YYYY format is allowed. Note that depending
/// on the underlying platform's date related function, providing just year
/// can result in varying month and day, so the implementers need to take
/// this factor into account to correctly process the dates.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub birthdate: Option<NaiveDate>,
// Region/City codes. Should also have a more concrete serializer form.
/// String from zoneinfo [zoneinfo] time zone database representing the
/// End-User's time zone. For example, Europe/Paris or America/Los_Angeles.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub zoneinfo: Option<String>,
// Usually RFC5646 langcode-countrycode, maybe with a _ sep, could be arbitrary
/// End-User's locale, represented as a BCP47 [RFC5646] language tag. This
/// is typically an ISO 639-1 Alpha-2 [ISO639‑1] language code in lowercase
/// and an ISO 3166-1 Alpha-2 [ISO3166‑1] country code in uppercase,
/// separated by a dash. For example, en-US or fr-CA. As a compatibility
/// note, some implementations have used an underscore as the separator
/// rather than a dash, for example, en_US; Relying Parties MAY choose to
/// accept this locale syntax as well.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub locale: Option<String>,
// Usually E.164 format number
/// End-User's preferred telephone number. E.164 [E.164] is RECOMMENDED as
/// the format of this Claim, for example, +1 (425) 555-1212 or +56 (2) 687
/// 2400. If the phone number contains an extension, it is RECOMMENDED that
/// the extension be represented using the RFC 3966 [RFC3966] extension
/// syntax, for example, +1 (604) 555-1234;ext=5678.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub phone_number: Option<String>,
/// True if the End-User's phone number has been verified; otherwise false.
/// When this Claim Value is true, this means that the OP took affirmative
/// steps to ensure that this phone number was controlled by the End-User at
/// the time the verification was performed. The means by which a phone
/// number is verified is context-specific, and dependent upon the trust
/// framework or contractual agreements within which the parties are
/// operating. When true, the phone_number Claim MUST be in E.164 format and
/// any extensions MUST be represented in RFC 3966 format.
#[serde(default, deserialize_with = "bool_from_str_or_bool")]
pub phone_number_verified: bool,
/// End-User's preferred postal address. The value of the address member is
/// a JSON [RFC4627] structure containing some or all of the members defined
/// in Section 5.1.1.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub address: Option<Address>,
/// Time the End-User's information was last updated. Its value is a JSON
/// number representing the number of seconds from 1970-01-01T0:0:0Z as
/// measured in UTC until the date/time.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub updated_at: Option<i64>,
}
impl StandardClaimsSubject for Userinfo {
fn sub(&self) -> Result<&str, crate::error::StandardClaimsSubjectMissing> {
Ok(self.sub.as_ref())
}
}
impl biscuit::CompactJson for Userinfo {}