IIdTokenHintParser Interface

Turns an id_token_hint parameter into the ID token it claims to be, or into the reason it is not one.

public interface IIdTokenHintParser

Derived
↳ IdTokenHintParser

Remarks

Two endpoints take a hint - authorization (OpenID Connect Core 1.0 Section 3.1.2.1) and end session (RP-Initiated Logout 1.0 Section 2) - and what makes a hint believable is the same for both, while what each does with the result is not. Shared here rather than written twice, because the two copies had already begun to differ: one required the expiration time through the validator and the other tested for it by hand.

Methods

IIdTokenHintParser.ParseAsync(string) Method

Validates a hint and returns the ID token, or a description of why it is not acceptable.

System.Threading.Tasks.Task<Abblix.Utils.Result<Abblix.Jwt.JsonWebToken,string>> ParseAsync(string idTokenHint);

Parameters

idTokenHint System.String

The raw parameter value.

Returns

System.Threading.Tasks.Task<Abblix.Utils.Result<JsonWebToken,System.String>>
The validated ID token, or a human-readable reason the caller wraps in its own error shape - the two endpoints report failures as different types.