Struct ClientId 

pub struct ClientId(/* private fields */);

A client’s identifier at its authorization server.

Two forms, and they are not interchangeable. RFC 7591 hands out an opaque string; a Client ID Metadata Document uses the URL the document is served from. verify_metadata_document checks the second form’s defining property.

Implementations

impl ClientId

pub fn opaque(value: impl AsRef<str>) -> Self

An opaque identifier, as RFC 7591’s client_id response member is.

pub fn metadata_url(value: impl AsRef<str>) -> Result<Self, ClientIdError>

The client_id of a Client ID Metadata Document.

Errors

ClientIdError::NotHttps if the URL is not https. The draft requires an HTTPS URL, and a client_id that is not one is a configuration mistake worth naming rather than a value to discover at the authorization server.

pub fn as_str(&self) -> &str

The identifier as it goes on the wire.

pub fn verify_metadata_document( &self, document_client_id: &str, ) -> Result<(), ClientIdError>

Check that a metadata document vouches for this client_id.

The draft requires the document’s client_id property to “match the URL of the document using simple string comparison as defined in RFC 3986 Section 6.2.1” — the same discipline check_response_issuer applies to RFC 9207’s iss, and for the same reason. Normalising here would let a document served at one URL claim the identity of another.

Errors

ClientIdError::DocumentMismatch when the document’s client_id is not this URL by simple string comparison.

Trait Implementations

impl Clone for ClientId

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientId

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ClientId

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ClientId

impl Hash for ClientId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ClientId

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ClientId