koa-basic-auth

Add simple "blanket" basic auth with username / password. If you require anything more specific just use the basic-auth module.

v4.x+ Breaking Change: This package no longer requires both a username and a password. Either or is supported, see #39 for more insight.

Installation

1$ npm install koa-basic-auth

Example

Password protect downstream middleware:

1const auth = require('koa-basic-auth');
2const Koa = require('koa');
3const app = new Koa();
4
5// custom 401 handling
6app.use(async (ctx, next) => {
7  try {
8    await next();
9  } catch (err) {
10    if (401 == err.status) {
11      ctx.status = 401;
12      ctx.set('WWW-Authenticate', 'Basic');
13      ctx.body = 'cant haz that';
14    } else {
15      throw err;
16    }
17  }
18});
19
20// require auth
21app.use(auth({ name: 'tj', pass: 'tobi' }));
22
23// secret response
24app.use(async (ctx) => {
25  ctx.body = 'secret';
26});
27
28app.listen(3000, function () {
29  console.log('listening on port 3000');
30});

Example request:

$ curl -H "Authorization: basic dGo6dG9iaQ==" http://localhost:3000/ -i
HTTP/1.1 200 OK
X-Powered-By: koa
Content-Type: text/plain; charset=utf-8
Content-Length: 6
Date: Sat, 30 Nov 2013 19:35:17 GMT
Connection: keep-alive

secret

Using the mount middleware you may specify auth for a given prefix:

1const mount = require('koa-mount');
2const auth = require('koa-basic-auth');
3
4app.use(mount('/admin', auth({ name: 'tobi', pass: 'ferret' })));

License

MIT