AzureAD passport-azure-ad 使用教程

最新推荐文章于 2025-05-14 11:32:00 发布

胡寒侃Joe

最新推荐文章于 2025-05-14 11:32:00 发布

阅读量597

点赞数 17

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00184/article/details/147359140

AzureAD passport-azure-ad 使用教程

passport-azure-ad The code for Passport Azure AD has been moved to the MSAL.js repo. Please open any issues or PRs at the link below. 项目地址: https://gitcode.com/gh_mirrors/pa/passport-azure-ad

1. 项目介绍

passport-azure-ad 是一个开源项目，提供了一套用于集成 Azure Active Directory (Azure AD) 认证和授权的 Passport.js 策略。该项目支持 OpenID Connect、WS-Federation 和 SAML-P 协议，使得 Node.js 应用能够利用 Azure AD 的功能，例如 Web 单点登录（WebSSO）、OAuth 端点保护和 JWT 令牌的签发与验证。

2. 项目快速启动

首先，确保您的 Node.js 环境已经安装并配置正确。

安装

通过 npm 安装 passport-azure-ad：

npm install passport-azure-ad

配置

创建一个新的文件（例如 config.js），并添加以下配置信息：

module.exports = {
  creds: {
    identityMetadata: 'https://login.microsoftonline.com/common/v2.0/.well-known/openid-configuration',
    clientID: 'YOUR_CLIENT_ID',
    audience: 'YOUR_TENANT_ID',
    responseType: 'code',
    responseMode: 'query',
    redirectUrl: 'YOUR_REDIRECT_URL',
    clientSecret: 'YOUR_CLIENT_SECRET',
    validateIssuer: false,
    isB2C: false,
    issuer: 'https://login.microsoftonline.com/YOUR_TENANT_ID/v2.0',
    scope: ['openid', 'profile', 'email'],
    loggingLevel: 'info',
    nonceLifetime: 3600,
    nonceMaxAmount: 10,
    useCookieInsteadOfSession: false,
    cookieSameSite: 'Lax',
    cookieEncryptionKeys: undefined,
    clockSkew: 300,
  }
};

确保替换 YOUR_CLIENT_ID、YOUR_TENANT_ID、YOUR_REDIRECT_URL 和 YOUR_CLIENT_SECRET 为您的 Azure AD 应用程序的实际值。

使用

在你的 Node.js 应用程序的 server.js 或主文件中，引入 passport-azure-ad 并配置策略：

const passport = require('passport');
const OIDCStrategy = require('passport-azure-ad').OIDCStrategy;
const config = require('./config');

const strategy = new OIDCStrategy(config.creds, (iss, sub, profile, cb) => {
  // 在这里，你可以根据 profile 来查找或创建用户
  return cb(null, profile);
});

passport.use(strategy);

// 其余的 Express 应用程序设置...

在 Express 应用程序中，使用 passport 中间件来处理认证：

app.get('/auth/openid', passport.authenticate('azuread-openidconnect', { failureRedirect: '/login' }));
app.post('/auth/openid/callback', passport.authenticate('azuread-openidconnect', { failureRedirect: '/login' }), (req, res) => {
  // 成功认证后的逻辑
});