Method ForIssuer

Namespace

MailFathom.Common.OAuth

Assembly

MailFathom.Common.dll

ForIssuer(string?)

Reports where the discovery document for an issuer is looked for, in the order the MCP authorization specification names.

public static IReadOnlyList<string> ForIssuer(string? issuer)

Parameters

issuer string

The authorization server's issuer identifier.

Returns

IReadOnlyList<string>

The candidate addresses, most specific specification first.

Remarks

An issuer with no path yields two candidates, because the two specifications place the document identically once there is no path to insert it before. An issuer with a path yields three: the two insertion forms and the appended form. A trailing slash on the issuer is not a path, so it produces the two-candidate list rather than a third address containing a doubled separator.

Exceptions

ArgumentException

Thrown when issuer is not usable as an OAuth identifier.