SharePoint 2013本地版NTLM V2认证调用REST API失败求助

针对你遇到的SharePoint 2013本地版配置NTLMv2后，调用REST API返回401未授权，且ntlm-client抛出未处理Promise拒绝错误的问题，我整理了几个关键排查点和解决方案：

1. 检查ntlm-client的参数配置细节 #

很多时候认证失败是因为参数没匹配到SharePoint的要求，你需要确保：

• 必须填写完整的域名，不能省略，比如domain: "CORP"
• 用户名用短格式（不要带域名前缀），比如username: "joe"而非CORP\joe
• 密码如果包含特殊字符，尝试用JS原始字符串（String.raw）避免转义问题
• 请求URL必须是完整绝对路径，包含HTTP/HTTPS前缀，比如http://sp2013-site/_api/web/lists

示例正确配置代码：

const ntlm = require('ntlm-client');

const authOptions = {
  url: 'http://your-sp-site/_api/web',
  username: 'your-account',
  password: 'your-password',
  domain: 'YOUR-DOMAIN',
  workstation: 'YOUR-PC-NAME' // 可选，但部分域环境要求填写
};

// 回调写法
ntlm.send(authOptions, function(err, res) {
  if(err) {
    console.error('认证出错:', err);
    return;
  }
  console.log('API响应:', res.body);
});

2. 强制启用NTLMv2协议并处理错误捕获 #

你遇到的UnhandledPromiseRejectionWarning是因为异步操作的错误没被捕获，同时可以尝试强制指定NTLM版本为v2：

如果用async/await写法，一定要加try/catch：

const ntlm = require('ntlm-client');

async function fetchSPData() {
  try {
    const res = await ntlm.send({
      url: 'http://your-sp-site/_api/web',
      username: 'your-account',
      password: 'your-password',
      domain: 'YOUR-DOMAIN',
      ntlmVersion: 2 // 强制使用NTLMv2
    });
    console.log(res.body);
  } catch (err) {
    console.error('认证失败详情:', err.message);
    // 可以打印完整堆栈排查：console.error(err.stack)
  }
}

fetchSPData();

3. 验证IIS的NTLMv2配置 #

确保SharePoint所在的IIS站点身份验证配置正确：

• 打开IIS管理器，找到目标站点 → 进入身份验证
• 右键Windows身份验证 → 选择高级设置
• 确认启用内核模式身份验证已勾选，然后进入提供程序，把Negotiate:NTLMv2移到最上方
• 检查站点绑定的端口、主机头是否和代码中请求的URL一致

4. 测试域环境的NTLMv2兼容性 #

先排除环境问题：

• 打开命令提示符，运行klist purge清除缓存的域票据
• 用浏览器直接访问SharePoint的REST API地址，输入域账户密码，看是否能正常返回JSON
• 如果浏览器能访问但代码不行，说明问题出在代码的认证实现细节上

内容的提问来源于stack exchange，提问作者Joe