Koa.js - 身份验证



身份验证是一个过程,在这个过程中,提供的凭据与本地操作系统或身份验证服务器中授权用户的信息数据库中保存的凭据进行比较。如果凭据匹配,则该过程完成,并且授予用户访问权限。

我们将创建一个非常基本的身份验证系统,该系统将使用基本 HTTP 身份验证。这是实施访问控制的最简单方法,因为它不需要 Cookie、会话或任何其他东西。要使用此功能,客户端必须在其发出的每个请求中发送 Authorization 标头。用户名和密码未加密,而是像下面这样连接在一个字符串中。

username:password

此字符串使用 Base64 编码,并且在该值之前添加了单词 Basic。例如,如果您的用户名为 Ayush,密码为 India,则字符串“Ayush:India”将作为编码发送到授权标头中。

Authorization: Basic QXl1c2g6SW5kaWE=

要在您的 koa 应用程序中实现此功能,您需要 koa-basic-auth 中间件。使用以下命令安装它:

$ npm install --save koa-basic-auth

现在打开您的 app.js 文件并在其中输入以下代码。

//This is what the authentication would be checked against
var credentials = { name: 'Ayush', pass: 'India' }

var koa = require('koa');
var auth = require('koa-basic-auth');
var _ = require('koa-router')();

var app = koa();

//Error handling middleware
app.use(function *(next){
   try {
      yield next;
   } catch (err) {
      if (401 == err.status) {
         this.status = 401;
         this.set('WWW-Authenticate', 'Basic');
         this.body = 'You have no access here';
      } else {
         throw err;
      }
   }
});

// Set up authentication here as first middleware. 
// This returns an error if user is not authenticated.
_.get('/protected', auth(credentials), function *(){
   this.body = 'You have access to the protected area.';
   yield next;
});

// No authentication middleware present here.
_.get('/unprotected', function*(next){
   this.body = "Anyone can access this area";
   yield next;
});

app.use(_.routes());
app.listen(3000);

我们创建了一个错误处理中间件来处理所有与身份验证相关的错误。然后,我们创建了 2 个路由:

  • /protected - 只有在用户发送正确的身份验证标头时才能访问此路由。对于所有其他情况,它将给出错误。

  • /unprotected - 任何人都可以访问此路由,无论是否进行身份验证。

现在,如果您在没有身份验证标头或使用错误的凭据向 /protected 发送请求,您将收到错误。例如:

$ curl https://127.0.0.1:3000/protected

您将收到以下响应:

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic
Content-Type: text/plain; charset=utf-8
Content-Length: 28
Date: Sat, 17 Sep 2016 19:05:56 GMT
Connection: keep-alive

Please authenticate yourself

但是,使用正确的凭据,您将获得预期的响应。例如:

$ curl -H "Authorization: basic QXl1c2g6SW5kaWE=" https://127.0.0.1:3000/protected -i

您将收到以下响应:

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 38
Date: Sat, 17 Sep 2016 19:07:33 GMT
Connection: keep-alive

You have access to the protected area.

/unprotected 路由仍然可以被所有人访问。

广告