skleeschulte/basic-to-sharepoint-auth-http-proxy

basic-to-sharepoint-auth-http-proxy

这是一个HTTP代理服务器，能够访问使用SharePoint HTTP认证的资源，认证凭据由HTTP Basic认证提供。

该代理主要用于通过仅支持HTTP Basic认证的WebDAV客户端访问Microsoft OneDrive for Business。若需通过Basic认证访问个人版OneDrive，请查看https://github.com/skleeschulte/basic-to-passport-auth-http-proxy%E3%80%82

运行代理

代理服务器基于Node.js开发，可通过Docker容器或直接使用Node.js运行。

配置通过环境变量设置：

• PROXY_TARGET 必填 代理目标URL，例如：https://example-my.sharepoint.com/
• PROXY_PORT 可选 代理监听端口，默认值为3000
• SHAREPOINT_AUTH_URL 可选 用于SharePoint认证的独立URL，默认与PROXY_TARGET相同
• AUTH_TYPE 可选 SharePoint认证类型，可选值：online、fba、tmg、adfs，默认值为online
• DEBUG 可选 调试日志配置（见下文）

当AUTH_TYPE设为adfs时，需额外设置以下环境变量：

• ADFS_DOMAIN 可选
• ADFS_RELYING_PARTY 必填
• ADFS_URL 必填
• ADFS_COOKIE 可选

代理使用node-sp-auth模块实现SharePoint认证，AUTH_TYPE对应模块的认证方式：

• online: SharePoint Online（基于SAML的用户凭据认证）
• fba: 本地SharePoint（2013/2016）表单认证（FBA）
• tmg: 本地SharePoint（2013/2016）Forefront TMG反向代理认证
• adfs: ADFS用户凭据认证

Docker运行方式

1. 在Docker Hub查看最新镜像标签：https://hub.docker.com/r/skleeschulte/basic-to-sharepoint-auth-http-proxy
2. 拉取镜像：
   docker pull skleeschulte/basic-to-sharepoint-auth-http-proxy:TAG（替换TAG为实际标签）
3. 运行镜像：
   docker run --name sharepoint-proxy -d -p 3000:3000 -e PROXY_TARGET=https://example-my.sharepoint.net/ --restart always skleeschulte/basic-to-sharepoint-auth-http-proxy:TAG（替换TAG）
4. 检查运行状态：
   docker logs sharepoint-proxy（正常输出应为proxy:info Proxy server listening: { address: '::', family: 'IPv6', port: 3000 }）

Node.js运行方式

确保安装合适的Node.js版本（开发时使用v10.16.0）：

1. 克隆仓库（选择版本标签后下载）
2. 进入目录并安装依赖：npm ci --only=production
3. 设置环境变量：
   Linux：export PROXY_TARGET=https://example-my.sharepoint.net/
   Windows：set PROXY_TARGET=https://example-my.sharepoint.net/
4. 启动服务器：node lib/server.js

使用方法

在客户端软件中配置代理服务器的主机名和端口，选择HTTP Basic认证方式，输入用户名和密码即可访问资源。

访问OneDrive for Business

访问OneDrive for Business时，PROXY_TARGET不应包含路径。例如，若SharePoint URL为https://example-my.sharepoint.com/personal/account_name/Documents，则PROXY_TARGET设为https://example-my.sharepoint.com/，客户端需访问http://localhost:3000/personal/account_name/Documents（根据客户端可能需调整格式）。

安全注意事项

当前代理仅支持HTTP入站连接，客户端到代理的凭据会以明文传输，建议仅在可信网络（如本地）使用。代理依赖node-sp-auth管理认证数据，支持多用户并行访问。

日志与调试

服务器使用debug库记录日志，命名空间为proxy：

• proxy:error（STDERR）：错误日志
• proxy:info（STDOUT）：监听地址和端口
• proxy:debug（STDOUT）：请求处理详情
• proxy:trace（STDOUT）：原始HTTP消息（含敏感信息）

默认启用proxy:error和proxy:info，可通过DEBUG变量调整：DEBUG=proxy:*启用所有代理日志，DEBUG=*启用所有日志（含第三方库）。