Passport-WindowsAuth 项目教程

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

passport-windowsauth/
├── lib/
│   ├── index.js
│   ├── strategy.js
├── examples/
│   ├── simple/
│   │   ├── app.js
│   │   ├── package.json
├── test/
│   ├── strategy.test.js
├── .gitignore
├── .npmignore
├── .travis.yml
├── LICENSE
├── README.md
├── package.json

• lib/: 包含项目的主要逻辑文件。
  • index.js: 项目的入口文件。
  • strategy.js: 定义了Windows认证策略。
• examples/: 包含示例应用。
  • simple/: 一个简单的示例应用。
    • app.js: 示例应用的启动文件。
    • package.json: 示例应用的依赖配置文件。
• test/: 包含测试文件。
  • strategy.test.js: 针对策略的测试文件。
• .gitignore: Git忽略文件配置。
• .npmignore: npm忽略文件配置。
• .travis.yml: Travis CI配置文件。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• package.json: 项目依赖和脚本配置文件。

2. 项目的启动文件介绍

在 examples/simple/ 目录下，app.js 是示例应用的启动文件。以下是该文件的简要介绍：

const express = require('express');
const passport = require('passport');
const WindowsStrategy = require('passport-windowsauth');

const app = express();

passport.use(new WindowsStrategy({
  ldap: {
    url: 'ldap://domain.com',
    base: 'dc=domain,dc=com',
    bindDN: '[e-mail]',
    bindCredentials: 'password'
  },
  integrated: false
}, (user, done) => {
  // 认证成功后的处理逻辑
  done(null, user);
}));

app.use(passport.initialize());

app.get('/login', passport.authenticate('WindowsAuthentication'));

app.listen(3000, () => {
  console.log('Example app listening on port 3000!');
});

• 引入依赖: 引入了 express, passport, 和 passport-windowsauth。
• 配置策略: 使用 WindowsStrategy 配置LDAP认证。
• 初始化Passport: 使用 passport.initialize() 初始化Passport。
• 定义路由: 定义 /login 路由进行认证。
• 启动服务器: 监听3000端口。

3. 项目的配置文件介绍

在项目的根目录下，package.json 是主要的配置文件。以下是该文件的简要介绍：

{
  "name": "passport-windowsauth",
  "version": "3.0.0",
  "description": "Windows Authentication strategy for Passport",
  "keywords": [
    "passport",
    "windows",
    "auth",
    "authentication",
    "ldap",
    "ad"
  ],
  "author": "Auth0",
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "git://github.com/auth0/passport-windowsauth.git"
  },
  "bugs": {
    "url": "http://github.com/auth0/passport-windowsauth/issues"
  },
  "main": "./lib",
  "scripts": {
    "test": "mocha"
  },
  "dependencies": {
    "passport-strategy": "1.x.x",
    "ldapjs": "1.0.x"
  },
  "devDependencies": {
    "mocha": "2.x.x",
    "chai": "3.x.x",
    "sinon": "1.x.x",
    "sinon-chai": "2.x.x"
  }
}

• 基本信息: 包含项目名称、版本、