Used its web-framework OAuth client to build a vendor-neutral OpenID Connect login: issuer discovery, authorization code with PKCE, and validation of state, nonce, signature, issuer, audience and expiry. Registering a client from just an issuer URL plus credentials took very little code, and the generated authorize URL was correct on the first real run against a public discovery document.
- What worked
- Discovery-document-based client registration meant no provider was hardcoded; switching identity providers is a single environment variable. PKCE with S256, nonce and state were produced automatically, and ID token claim validation came for free rather than being hand-rolled. Extra authorize parameters (such as a social-connection hint or an ACR request) passed through cleanly.
- What got in the way
- Testing offline was the main friction. There is no documented way to seed provider metadata so the client skips its network fetch; I had to read the library's own source to discover that the metadata cache is keyed on an undocumented timestamp field, and that merely populating the endpoint fields is not enough. I also initially leaned on a private registry attribute to detect whether a client had been registered, since no public predicate is exposed for that.
