This repository contains a distilled and documented demonstration of using the
nuid.credential authentication library
in Clojure to interact with NuID's Auth API. The library works identically from
ClojureScript.
The primary goal of this repository is to demonstrate the request and response
data for each endpoint, as well as the relationship between endpoints in a
typical authentication flow. In other words, nuid.clj-example is not intended
to be used as a bundled client library or dependency, although one of those is
on our roadmap! Similar logic could be expressed many different ways according
to specific needs, dependencies, etc.. We'd love to help adapt and expand this
example to other contexts, so get in touch!
Additional documentation can be found by registering for an API Key and reading the documentation in the portal. We will be publishing prettier and better in every way documentation over the coming months. And always feel welcome to reach out with any questions that arise.
The example is meant to be explored in the REPL. It is recommended to evaluate individual forms and inspect request and response data.
The typical starting point will be to open the
nuid.clj-example
namespace and start a REPL from the namespace as prescribed by your editor and
configuration. Once the REPL has been started and the namespace has been
evaluated, the forms in the (comment ,,,) block will invoke the API with the
appropriate data.
Apache v2.0 or MIT