Nodejs 進階：express+session 實現簡易身份認證

程式猿小卡_casper發表於2017-04-24
NodeJSExpressSession

本文摘錄自《Nodejs學習筆記》，更多章節及更新，請訪問 github主頁地址。歡迎加群交流，群號 197339705。

文件概覽

本文基於express、express-session實現了簡易的登入/登出功能，完整的程式碼示例可以在這裡找到。

環境初始化

首先，初始化專案

express -e複製程式碼

然後，安裝依賴。

npm install複製程式碼

接著，安裝session相關的包。

npm install --save express-session session-file-store複製程式碼

session相關配置

配置如下，並不複雜，可以見程式碼註釋，或者參考官方文件。

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  // 有效期，單位是毫秒
    }
}));複製程式碼

實現登入/登出介面

建立測試賬戶資料

首先，在本地建立個檔案，來儲存可用於登入的賬戶資訊，避免建立連結資料庫的繁瑣。

// users.js
module.exports = {
    items: [
        {name: 'chyingp', password: '123456'}
    ]
};複製程式碼

登入、登出介面實現

實現登入、登出介面，其中：

  • 登入：如果使用者存在，則通過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 時，判斷使用者是否登入，如果是，則調到使用者詳情介面（簡陋無比）；如果沒有登入，則跳到登入介面；

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>複製程式碼

相關連結

github.com/expressjs/s…

相關文章