摘要：我們就采用這種方式來進(jìn)行權(quán)限驗(yàn)證。這里我還是使用在中的下新增單頁面博客從前端到后端環(huán)境搭建單頁面博客從前端到后端基于搭建博客前后臺(tái)界面單頁面博客從前端到后端基于和的權(quán)限驗(yàn)證與的設(shè)計(jì)

這里有一篇文章描述的已經(jīng)非常詳盡，闡述了 JWT 驗(yàn)證相比較傳統(tǒng)的持久化 session 驗(yàn)證的優(yōu)勢，以及基于 angular 和 express 驗(yàn)證的簡單流程。

基于Json WebToken的權(quán)限驗(yàn)證

Passport 提供了多種的驗(yàn)證策略，如：

passport-http-bearer - 使用 Bearer tokens 對(duì) HTTP 請(qǐng)求做權(quán)限驗(yàn)證。這個(gè)最適合我們的項(xiàng)目不過了。

passport-local - 本地驗(yàn)證，普通的登陸驗(yàn)證，數(shù)據(jù)庫密碼驗(yàn)證成功即可。

此外還有 passport-github , passport-weixin , passport-qq , passport-weibo … ，這些你都可以在 官網(wǎng) 上找到。

我們就采用這種方式來進(jìn)行權(quán)限驗(yàn)證。

首先需要注意的是使用 Koa@2，Node的版本需要 7.X的版本以上，而且啟動(dòng)時(shí)需要加上 --harmony 或者 —harmony-async-await 
最近 Node 8.0 已經(jīng)上線，我直接采用的是 Node v8.0.0 
nvm install 8.0.0
nvm alias default 8.0.0

blog/server基本的目錄結(jié)構(gòu)

server
├─ bin / www      # 入口文件
├─ config         # server配置文件
├─ controller     # 控制器文件夾
|  └─ user.js     
├─ lib            
|  ├─ auth.js     # 認(rèn)證邏輯
|  └─ db.js       # 數(shù)據(jù)庫 連接等
├─ models         # Mongoose Models
├─ routes         # Koa router
├─ utils          # 工具方法
├─ index.js       
└─ package.json  

我們?cè)谌肟谖募?server/bin/www 來連接 MongoDB

(async () => {
    // 測試連接 MongoDB
    try {
        const info = await connect(dbConfig)
        console.log(`Success to connect to MongoDB at ${info.host}:${info.port}/${info.name}`)
    } catch (err) {
        console.error(err)
        process.exit()
    }
    // 開啟服務(wù)進(jìn)程
    try {
        app.listen(port)
        console.log(`Server is running at http://localhost:${port}`)
    } catch (err) {
        console.error(err)
    }
})()

server/lib/db.js 下對(duì)應(yīng)的 connect 方法

exports.connect = function (config) {
    return new Promise((resolve, reject) => {
        mongoose.connection
            .on("error", err => reject(err))
            .on("close", () => console.log("MongoDB connection closed! "))
            .on("open", () => resolve(mongoose.connections[0]))
        mongoose.connect(`mongodb://${config.host}:${config.port}/${config.database}`, config.options)
    })
}

在 server/config/index.js 增加 MongoDB 的配置

const base = {
    admin: {
        username: "whistleyz",
        password: "admin123",
        email: "whistleyz@163.com",
        level: 51  // >50 超管
    }
}
const dev = Object.assign(base, {
    db: {
        host: "127.0.0.1",
        port: 27017,
        database: "fullblog",
        options: {
            user: "",
            pass: ""
        }
    }
})
const prod = Object.assign(base, {})
const env = process.env.NODE_ENV || "development"
const _config = {
    development: dev,
    production: prod
}
// 數(shù)據(jù)庫配置
module.exports = _config[env]

由于線上和我們開發(fā)甚至是測試環(huán)境，配置都會(huì)有些許不同，我們可以用 process.env.NODE_ENV 來區(qū)分這些配置

新建 server/lib/auth.js

// serialize deserialize user objects into the session
passport.serializeUser((user, done) => done(null, user.username))
passport.deserializeUser(async (username, done) => {
    const user = await UserModel.findOne({username})
    done(null, user)
})
/**
 * 基于 Bearer、Local 的認(rèn)證方式 
 * 下面導(dǎo)出的路由中間件走的就是這里的邏輯 
 * passport-http-bearer 會(huì)自動(dòng)解析出 headers 中的 token
 * https://github.com/jaredhanson/passport-http-bearer/blob/master/lib/strategy.js#L89
 */
passport.use(new BearerStrategy(async (token, done) => {
    try {
        console.log(token)
        const accessToken = await AccessToken.findOne({token}).populate("user")
        accessToken ? done(null, accessToken.user) : done(null, false, {type: "error", message: "授權(quán)失敗！"})
    } catch (err) {
        done(err)
    }
}))

/**
 * 默認(rèn)從 req.body 或者 req.query 中取出 username, password 字段
 * https://github.com/jaredhanson/passport-local/blob/master/lib/strategy.js#L49
 */
passport.use(new LocalStrategy(async (username, password, done) => {
    try {
        const user = await UserModel.findOne({username})
        if (user && user.validPassword(password)) {
            done(null, user)
        } else {
            done(null, false)
        }
    } catch (err) {
        done(err)
    }
}))
// 導(dǎo)出中間件 
exports.isBearerAuthenticated = function () {
    return passport.authenticate("bearer", {session: false})
}
exports.isLocalAuthenticated = function () {
    return passport.authenticate("local", {session: false})
}
exports.passport = passport

新建 server/routes/api.js ：

const Router = require("koa-router")
const User = require("../controllers/user")
const { isBearerAuthenticated, isLocalAuthenticated } = require("../lib/auth")
const router = new Router()
router.use(async (ctx, next) => {
    try {
        await next()
    } catch (error) {
        console.error(error)
        ctx.status = 400
        ctx.body = {
            code: error.code,
            message: error.message || error.errmsg || error.msg || "unknown_error",
            error
        }
    }
})
// 初始化用戶數(shù)據(jù)
User.seed()
// Auth 認(rèn)證
router.post("/auth", isLocalAuthenticated(), User.signToken)
router.get("/auth", isBearerAuthenticated(), User.getUserByToken)
module.exports = router.routes()

那么我們?cè)?server/controller/user.js 下的處理邏輯久變得簡單：

// LocalStrategy 的中間件驗(yàn)證通過，會(huì)把 user 儲(chǔ)存在 req 中
exports.signToken = async function (ctx, next) {
    const { user } = ctx.req
    // 重新請(qǐng)求 token 需要?jiǎng)h除上一次生成的 token
    await TokenModel.findOneAndRemove({user: user._id})
    const result = await TokenModel.create({
        // md5加密
        token: genHash(user.username + Date.now()),
        user: user._id
    })
    ctx.status = 200
    ctx.body = {
        success: true,
        data: result
    }
}
// LocalStrategy 的中間件驗(yàn)證Token有效，會(huì)把 user 儲(chǔ)存在 req 中
exports.getUserByToken = async function (ctx, next) {
    ctx.status = 200
    ctx.body = {
        success: true,
        data: ctx.req.user
    }
}
// 當(dāng)數(shù)據(jù)庫中user表示空的時(shí)候，創(chuàng)建超級(jí)管理員
exports.seed = async function (ctx, next) {
    const users = await UserModel.find({})
    const adminInfo = config.admin
    if (users.length === 0) {
        const _admin = new UserModel(adminInfo)
        const adminUser = await _admin.save()
    }
}

我們可以借助 mongoose 還控制 Token 的壽命
比如設(shè)置 7 天后過期，expires: 60 * 60 * 24 * 7

到這里我們的后端邏輯基本實(shí)現(xiàn)，為了和前端 webpack-dev-server 本地服務(wù)器進(jìn)行數(shù)據(jù)模擬，我們可以開啟 devServer 的 proyx ，以及開啟 koa 的跨域支持

task/config ：

config.devServer = {
    hot: true,
    contentBase: path.resolve(__dirname, "../dist"),
    publicPath: "/",
    proxy: {
        "/api/v1": "http://localhost:8082"
    }
}

這樣，前端的任何 /api/v1 下的請(qǐng)求，都會(huì)被代理到 http://localhost:8082 而 8082 就是 koa 服務(wù)器的監(jiān)聽端口。

// koa 跨域
const logger = require("koa-logger")
const app = new koa()
app.use(kcors())

在下一篇文章中，我們會(huì)深入 dva 的框架核心實(shí)現(xiàn)。我們先來看看 dav 的基本使用

新建 src/model/app.js

import { doLogin, getUserByToken } from "../service/app"
import { LocalStorage } from "../utils"
import { message } from "antd"
export default {
    namespace: "app",
    state: {
        isLogin: false,
        user: null
    },
    subscriptions: {},
    effects: {
        *checkToken({next}, {call, put}){
            const Token = LocalStorage.getItem("token")
            if (Token) {
                yield put({type: "loginSuccess"})
            } else {
                message.error("你還沒有登陸哦！")
            }
        },
        *doLogin({payload}, {call, put}){
            try {
                const { success, data } = yield call(doLogin, payload)
                if (success) {
                    LocalStorage.setItem("token", data.token)
                    yield put({type: "requireAuth"})
                }
            } catch (err) {
                message.error("授權(quán)失敗！")
                yield put({type: "authErr"})
            }
        },
        *getUserByToken({}, {call, put}){
            try {
                const { success, data } = yield call(getUserByToken)
                if (success) {
                    yield put({type: "authSuccess", payload: data})
                }
            } catch (err) {
                message.error(err.message)
                yield put({type: "authErr"})
            }
        }
    },
    reducers: {
        loginSuccess(state){
            return {
                ...state, isLogin: true
            }
        },
        authErr(state){
            return {
                ...state, isLogin: false, user: null
            }
        },
        authSuccess(state, {payload}){
            return {
                ...state, user: payload
            }
        }
    }
}

對(duì)于 redux-saga 的 effect 等的用法，可以參考 文檔

這里我們對(duì) localStorage 做了一次封裝，看了源碼相信你就知道目的是什么了：

/**
 * src/utils/localStorage.js
 * Custom window.localStorage
 */
const STORE_PREFIX = "blog"
export function getItem (key) {
    return window.localStorage.getItem(STORE_PREFIX + "-" + key)
}
export function setItem (key, value) {
    window.localStorage.setItem(STORE_PREFIX + "-" + key, value)
}
export function removeItem (key) {
    window.localStorage.removeItem(STORE_PREFIX + "-" + key)
}

封裝 src/utils/request.js

import fetch from "dva/fetch"
import * as LocalStorage from "./localStorage"
const URL_PREFIX = "/api/v1"
const TOKEN_NAME = "token"
function checkStatus(response) {
    if (response.status >= 200 && response.status < 300) {
        return response;
    }
    const error = new Error(response.statusText);
    error.response = response;
    throw error;
}
/**
 * Requests a URL, returning a promise.
 *
 * @param  {string} url       The URL we want to request
 * @param  {object} [options] The options we want to pass to "fetch"
 * @return {object}           An object containing either "data" or "err"
 */
export default function request(url, options) {
    options = Object.assign({
        headers: new Headers({
            "Content-Type": "application/json"
        })
    }, options)
    return fetch(URL_PREFIX + url, options)
        .then(checkStatus)
        .then(res => res.json())
        .then(data => data)
}
/**
 * Request width token
 * @param  {[type]} url    
 * @param  {[type]} options
 * @return {[type]}        
 */
export function requestWidthToken (url, options) {
        const TOKEN = LocalStorage.getItem(TOKEN_NAME)
        options = Object.assign({
            headers: new Headers({
                "Content-Type": "application/json",
                "Authorization": `Bearer ${TOKEN}`
            })
        }, options)
        return request(url, options)
}

dva/fetch 直接導(dǎo)出了 fetch
fetch 的用法很簡單，參考 github地址

這里我們把 url 的 prefix、token name 提取出來用作常量保存，以便于我們修改，最好的方法是提取出來用一個(gè)文件保存

還記得我們的展示組件嗎，現(xiàn)在我們讓它 connect 到我們的 model

import { connect } from "dva"
const { Header, Content, Footer } = Layout
const { HeaderRight } = HeaderComponent
const App = ({children, routes, app, doLogin}) => {
    const { isLogin, user } = app
    return (
        
            

                
                    {isLogin ?  :  }
                
            
           ...
    )
}
function mapStateToProps ({app}, ownProps) {
    return {
        app
    }
}
function mapDispatchToProps (dispatch) {
    return {
        doLogin({username, password}){
            dispatch({type: "app/doLogin", payload: {username, password}})
        }
    }
}

export default connect(mapStateToProps, mapDispatchToProps)(App)

唯一需要注意的就是action 的 type 屬性了，如 app/doLogin 前綴 app 就是 dva.model 的 namespace

從 dva/createDva.js at master · dvajs/dva · GitHub 中可以看到，dva 會(huì)把 model.namespace 最為 reducer , effects  的 prefix 拼接

然后我們就可以在 LoginComponent 中，監(jiān)聽登陸的相應(yīng)事件來調(diào)用對(duì)應(yīng)的方法了。

在寫后端的時(shí)，難免遇到很多錯(cuò)誤，我們可以使用 supervisor 、pm2 來監(jiān)聽文件變動(dòng)來自動(dòng)重啟 nodejs 。鑒于后期我們會(huì)使用 pm2 部署項(xiàng)目。這里我還是使用 pm2

在 server/package.json 中的 scripts 下新增：
"start": "pm2 start bin/www --watch --name blog && pm2 log blog",

【單頁面博客從前端到后端】環(huán)境搭建

【單頁面博客從前端到后端】基于 DVA+ANTD 搭建博客前后臺(tái)界面

【單頁面博客從前端到后端】基于 Passport 和 Koa@2 的權(quán)限驗(yàn)證與 DVA 的 Model 設(shè)計(jì)