开源项目 `passport-localapikey` 使用教程

1. 项目的目录结构及介绍

passport-localapikey/
├── examples/
│   └── express3/
├── lib/
│   └── passport-localapikey/
├── test/
├── .gitignore
├── .npmignore
├── .travis.yml
├── LICENSE
├── Makefile
├── README.md
├── package.json

• examples/: 包含示例代码，展示如何在Express应用中使用该策略。
• lib/: 包含核心库文件，实现API Key认证策略。
• test/: 包含测试文件，用于验证库的正确性。
• .gitignore: Git忽略文件配置。
• .npmignore: NPM忽略文件配置。
• .travis.yml: Travis CI配置文件。
• LICENSE: 项目许可证。
• Makefile: 用于构建和测试的Makefile。
• README.md: 项目说明文档。
• package.json: 项目配置文件，包含依赖和脚本。

2. 项目的启动文件介绍

项目的启动文件通常位于examples/express3/目录下，示例代码展示了如何在Express应用中使用passport-localapikey策略。

// examples/express3/app.js
var express = require('express');
var passport = require('passport');
var LocalAPIKeyStrategy = require('../../lib/passport-localapikey').Strategy;

var app = express();

passport.use(new LocalAPIKeyStrategy(function(apikey, done) {
  User.findOne({ apikey: apikey }, function (err, user) {
    if (err) { return done(err); }
    if (!user) { return done(null, false); }
    return done(null, user);
  });
}));

app.post('/api/authenticate', passport.authenticate('localapikey', { session: false }), function(req, res) {
  res.json({ message: "Authenticated" });
});

app.listen(3000);

3. 项目的配置文件介绍

项目的配置文件主要是package.json，它包含了项目的依赖、脚本和其他元数据。

{
  "name": "passport-localapikey",
  "version": "1.0.0",
  "description": "Passport strategy for authenticating with a apikey",
  "main": "lib/passport-localapikey",
  "scripts": {
    "test": "make test"
  },
  "dependencies": {
    "passport": "^0.4.1"
  },
  "devDependencies": {
    "mocha": "^8.2.1",
    "chai": "^4.2.0"
  },
  "author": "CholaLabs",
  "license": "MIT"
}

• name: 项目名称。
• version: 项目版本。
• description: 项目描述。
• main: 入口文件。
• scripts: 包含可执行的脚本命令。
• dependencies: 项目运行所需的依赖。
• devDependencies: 开发和测试所需的依赖。
• author: 项目作者。
• license: 项目许可证。