Nodejs 进阶：express+session 实现简易身份认证

时间 2019-11-17

标签 nodejs 进阶 express+session express session 实现简易身份认证栏目网站开发繁體版

原文原文链接

本文摘录自《Nodejs学习笔记》，更多章节及更新，请访问 github主页地址。欢迎加群交流，群号 197339705。javascript

文档概览

本文基于express、express-session实现了简易的登陆/登出功能，完整的代码示例能够在这里找到。html

环境初始化

首先，初始化项目java

express -e复制代码

而后，安装依赖。node

npm install复制代码

接着，安装session相关的包。jquery

npm install --save express-session session-file-store复制代码

session相关配置

配置以下，并不复杂，能够见代码注释，或者参考官方文档。git

var express = require('express');
var app = express();
var session = require('express-session');
var FileStore = require('session-file-store')(session);

var identityKey = 'skey';

app.use(session({
    name: identityKey,
    secret: 'chyingp',  // 用来对session id相关的cookie进行签名
    store: new FileStore(),  // 本地存储session（文本文件，也能够选择其余store，好比redis的）
    saveUninitialized: false,  // 是否自动保存未初始化的会话，建议false
    resave: false,  // 是否每次都从新保存会话，建议false
    cookie: {
        maxAge: 10 * 1000  // 有效期，单位是毫秒
    }
}));复制代码

实现登陆/登出接口

建立测试帐户数据

首先，在本地建立个文件，来保存可用于登陆的帐户信息，避免建立连接数据库的繁琐。github

// users.js
module.exports = {
    items: [
        {name: 'chyingp', password: '123456'}
    ]
};复制代码

登陆、登出接口实现

实现登陆、登出接口，其中：ajax

登陆：若是用户存在，则经过req.regenerate建立session，保存到本地，并经过Set-Cookie将session id保存到用户侧；
登出：销毁session，并清除cookie；

var users = require('./users').items;

var findUser = function(name, password){
    return users.find(function(item){
        return item.name === name && item.password === password;
    });
};

// 登陆接口
app.post('/login', function(req, res, next){

    var sess = req.session;
    var user = findUser(req.body.name, req.body.password);

    if(user){
        req.session.regenerate(function(err) {
            if(err){
                return res.json({ret_code: 2, ret_msg: '登陆失败'});                
            }

            req.session.loginUser = user.name;
            res.json({ret_code: 0, ret_msg: '登陆成功'});                           
        });
    }else{
        res.json({ret_code: 1, ret_msg: '帐号或密码错误'});
    }   
});

// 退出登陆
app.get('/logout', function(req, res, next){
    // 备注：这里用的 session-file-store 在destroy 方法里，并无销毁cookie
    // 因此客户端的 cookie 仍是存在，致使的问题 --> 退出登录后，服务端检测到cookie
    // 而后去查找对应的 session 文件，报错
    // session-file-store 自己的bug 

    req.session.destroy(function(err) {
        if(err){
            res.json({ret_code: 2, ret_msg: '退出登陆失败'});
            return;
        }

        // req.session.loginUser = null;
        res.clearCookie(identityKey);
        res.redirect('/');
    });
});复制代码

登陆态判断

用户访问 http://127.0.0.1:3000 时，判断用户是否登陆，若是是，则调到用户详情界面（简陋无比）；若是没有登陆，则跳到登陆界面；redis

app.get('/', function(req, res, next){
    var sess = req.session;
    var loginUser = sess.loginUser;
    var isLogined = !!loginUser;

    res.render('index', {
        isLogined: isLogined,
        name: loginUser || ''
    });
});复制代码

UI界面

最后，看下登陆、登出UI相关的代码。数据库

<!DOCTYPE html>
<html>
<head>
    <title>会话管理</title>
</head>
<body>

<h1>会话管理</h1>

<% if(isLogined){ %>
    <p>当前登陆用户：<%= name %>，<a href="/logout" id="logout">退出登录</a></p>
<% }else{ %>
    <form method="POST" action="/login">
        <input type="text" id="name" name="name" value="chyingp" />
        <input type="password" id="password" name="password" value="123456" />
        <input type="submit" value="登陆" id="login" />
    </form>
<% } %> 

<script type="text/javascript" src="/jquery-3.1.0.min.js"></script>
<script type="text/javascript"> $('#login').click(function(evt){ evt.preventDefault(); $.ajax({ url: '/login', type: 'POST', data: { name: $('#name').val(), password: $('#password').val() }, success: function(data){ if(data.ret_code === 0){ location.reload(); } } }); }); </script>

</body>
</html>复制代码