This is koa middleware to retrieve information about an authenticated user (the userinfo) given their access token.

See the relevant part of the OpenID specification for details on userinfo.

In a koa app, add as middleware:

app.use(userinfo({ site: 'https://login-test.u5auth.com/userinfo' }))

The middleware fails with a status of 401 if no token is available. This can be ignored by setting the option allowMissingOrInvalidToken: true.

Check the site in the sample and adjust to your userinfo provider (your OAuth2 / OpenID provider). Then:

npm install
npm run sample

This runs a sample server (on port PORT or 3000), which responds with a text representation of your userinfo, if you call it with a valid access token.

Example call:

export TOKEN=123
curl -v -H "Authorization: Bearer $TOKEN" localhost:3000