Laravel中使用NTLM认证发起HTTP请求的资源咨询与错误排查

可用实现方式 #

Laravel的HTTP客户端底层基于Guzzle，可直接通过Guzzle内置的NTLM认证能力实现，无需额外安装第三方扩展包，也可按需选择社区维护的NTLM工具包辅助开发。 #

现有代码400错误的核心原因 #

• NTLM认证的三次握手必须在同一个TCP持久连接内完成，你当前的两次请求是独立的HTTP连接，第一次请求获取的Type2认证令牌在第二次新连接中无效
• 你直接将服务端返回的WWW-Authenticate头（Type2消息）作为Authorization头发送是错误的，需要结合用户名、密码、域信息将Type2消息加工为Type3认证消息后才能提交
• 手动添加Host、Connection等底层头可能和Guzzle自动生成的头冲突，导致请求格式异常

正确实现示例 #

方案1：直接使用Guzzle内置NTLM认证（推荐） #

依赖PHP的cURL扩展开启NTLM支持，绝大多数PHP环境默认已支持该特性，代码如下：

// 域账号格式为 域名\用户名，无域可直接填用户名
$username = 'DOMAIN\your_username';
$password = 'your_password';

$response = Http::withOptions([
    'auth' => [$username, $password, 'ntlm'],
    'curl' => [
        CURLOPT_HTTPAUTH => CURLAUTH_NTLM
    ]
])->get($MY_URL);

dd($response->body());

方案2：手动实现NTLM握手（需自定义生成Type3消息） #

如果需要自行控制握手流程，需确保连接复用，且引入NTLM消息编解码逻辑处理Type2到Type3的转换：

// 复用同一个客户端实例保证连接不中断
$client = Http::withOptions([
    'persistent' => true,
    'curl' => [
        CURLOPT_HTTPAUTH => CURLAUTH_NTLM
    ]
]);

// 第一步：发送Type1消息
$type1Msg = /* 自行生成NTLM Type1认证消息 */;
$response = $client->withHeaders([
    'Authorization' => "NTLM {$type1Msg}"
])->get($MY_URL);

// 提取Type2消息
$type2Full = $response->header('WWW-Authenticate');
preg_match('/NTLM\s([^\s]+)/', $type2Full, $matches);
$type2Msg = $matches[1] ?? '';

// 第二步：生成Type3消息后发送
$type3Msg = /* 用用户名、密码、$type2Msg生成Type3认证消息 */;
$response = $client->withHeaders([
    'Authorization' => "NTLM {$type3Msg}"
])->get($MY_URL);

dd($response);

400错误排查要点 #

• 检查phpinfo()中cURL模块的Supported HTTP Auth项是否包含NTLM
• 确认账号格式正确，域账号必须带上域前缀，例如COMPANY\zhangsan
• 不要手动指定Host、Connection头，由Guzzle自动生成即可，避免头信息冲突
• 确认请求的目标域名、端口和服务端配置完全一致，不存在跨域、端口映射不一致的问题

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