.NET 6环境下对接本地SharePoint 2016：REST API/CSOM使用及表单认证令牌获取方案咨询

嗨，针对你遇到的两个问题——.NET 6客户端对接本地SharePoint，以及SPA+ASP.NET Core后端上传文件到SP2016的表单认证难题，我来分享下实际可行的方案：

一、先解决核心痛点：表单认证（FBA）获取SharePoint认证凭证 #

SharePoint 2016的REST API依赖Cookie认证，所以第一步要先通过FBA登录接口拿到认证后的Cookie容器，后续所有请求都需要带上这个容器。以下是ASP.NET Core后端的实现代码：

using System.Net;
using System.Net.Http.Headers;
using System.Collections.Specialized;
using System.Text.RegularExpressions;

public async Task<CookieContainer> GetSharePointAuthCookie(string spSiteUrl, string username, string password)
{
    var cookieContainer = new CookieContainer();
    using var handler = new HttpClientHandler { CookieContainer = cookieContainer };
    using var client = new HttpClient(handler);

    // 1. 访问登录页面，提取表单所需的隐藏字段
    var authPageResponse = await client.GetAsync($"{spSiteUrl}/_layouts/15/login.aspx");
    authPageResponse.EnsureSuccessStatusCode();
    var authPageHtml = await authPageResponse.Content.ReadAsStringAsync();

    // 解析页面中的关键字段（生产环境推荐用HtmlAgilityPack替代正则）
    var requestDigest = ExtractFormField(authPageHtml, "__REQUESTDIGEST");
    var viewState = ExtractFormField(authPageHtml, "__VIEWSTATE");
    var viewStateGenerator = ExtractFormField(authPageHtml, "__VIEWSTATEGENERATOR");

    // 2. 构造登录表单数据
    var formData = new Dictionary<string, string>
    {
        { "__REQUESTDIGEST", requestDigest },
        { "__VIEWSTATE", viewState },
        { "__VIEWSTATEGENERATOR", viewStateGenerator },
        { "username", username },
        { "password", password },
        { "Login", "登录" } // 注意：英文环境改为"Sign In"
    };

    // 3. 提交登录请求
    var content = new FormUrlEncodedContent(formData);
    var loginResponse = await client.PostAsync($"{spSiteUrl}/_layouts/15/login.aspx", content);
    loginResponse.EnsureSuccessStatusCode();

    // 验证是否获取到认证Cookie
    var authCookies = cookieContainer.GetCookies(new Uri(spSiteUrl))
        .Cast<Cookie>()
        .Where(c => c.Name is "FedAuth" or "rtFa");
    
    if (!authCookies.Any())
        throw new UnauthorizedAccessException("登录失败，请检查用户名密码或SharePoint FBA配置");

    return cookieContainer;
}

// 辅助方法：从HTML中提取表单字段值
private string ExtractFormField(string html, string fieldName)
{
    var regex = new Regex($"name=\"{fieldName}\"\\s+value=\"([^\"]+)\"");
    var match = regex.Match(html);
    return match.Success ? match.Groups[1].Value 
        : throw new InvalidOperationException($"无法提取{fieldName}字段，请检查SharePoint登录页面结构");
}

提示：生产环境建议安装HtmlAgilityPack NuGet包，用它来解析HTML会比正则更可靠，避免页面结构变动导致解析失败。

二、.NET 6对接SharePoint的两种可行方式 #

1. REST API（适配.NET 6，灵活可控） #

拿到认证Cookie后，就可以调用SharePoint REST API完成文件上传、列表操作等任务。以下是文件上传的示例：

using System.Net.Http.Json;

public async Task UploadFileViaRest(string spSiteUrl, string libraryRelativeUrl, string localFilePath, CookieContainer authCookies)
{
    var fileName = Path.GetFileName(localFilePath);
    // 构造文件上传的REST接口地址
    var uploadUrl = $"{spSiteUrl}/_api/web/getfolderbyserverrelativeurl('{libraryRelativeUrl}')/files/add(overwrite=true, url='{fileName}')";

    using var handler = new HttpClientHandler { CookieContainer = authCookies };
    using var client = new HttpClient(handler);

    // 获取最新的请求摘要（Request Digest）
    var digestResponse = await client.PostAsync($"{spSiteUrl}/_api/contextinfo", null);
    var digestResult = await digestResponse.Content.ReadFromJsonAsync<dynamic>();
    var requestDigest = digestResult.FormDigestValue;
    client.DefaultRequestHeaders.Add("X-RequestDigest", requestDigest);

    // 读取本地文件并发送上传请求
    using var fileStream = new FileStream(localFilePath, FileMode.Open, FileAccess.Read);
    using var content = new StreamContent(fileStream);
    content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");

    var uploadResponse = await client.PostAsync(uploadUrl, content);
    uploadResponse.EnsureSuccessStatusCode();

    // 解析返回的文件信息（可选）
    var fileInfo = await uploadResponse.Content.ReadFromJsonAsync<dynamic>();
    Console.WriteLine($"文件上传成功，ID：{fileInfo.Id}");
}

2. PnP Core SDK（替代CSOM的最佳选择） #

原生CSOM仅支持.NET Framework，但微软维护的PnP Core SDK是开源的.NET Standard库，完美适配.NET 6，还封装了大量SharePoint操作，比直接写REST更高效。

步骤1：安装NuGet包

Install-Package PnP.Core
Install-Package PnP.Core.Auth

步骤2：初始化认证上下文并上传文件

using PnP.Core.Services;
using PnP.Core.Auth;

public async Task UploadFileWithPnP(string spSiteUrl, string username, string password, string libraryRelativeUrl, string localFilePath)
{
    // 创建FBA认证提供者
    var authProvider = new UsernamePasswordAuthenticationProvider(username, password);

    // 初始化PnP上下文
    var contextFactory = new PnPContextFactory();
    var context = await contextFactory.CreateAsync(new PnPContextOptions
    {
        SiteUrl = spSiteUrl,
        AuthenticationProvider = authProvider
    });

    // 上传文件到指定文档库
    var fileName = Path.GetFileName(localFilePath);
    using var fileStream = new FileStream(localFilePath, FileMode.Open, FileAccess.Read);
    var uploadedFile = await context.Web.GetFolderByServerRelativeUrl(libraryRelativeUrl)
        .Files.AddAsync(fileName, fileStream, overwrite: true);

    // 可选：设置文件属性（如标题、自定义字段）
    uploadedFile.ListItemAllFields["Title"] = "自定义文件标题";
    await uploadedFile.ListItemAllFields.UpdateAsync();
}

三、SPA+ASP.NET Core架构的最佳实践 #

不建议直接在SPA前端调用SharePoint REST API，原因有二：

• 会暴露SharePoint的用户名密码，存在安全风险
• 跨域配置复杂，SharePoint 2016的CORS支持有限

正确的做法是：

1. SPA前端将文件上传到ASP.NET Core后端
2. 后端通过上述REST或PnP Core SDK的方式，将文件转发到SharePoint 2016
3. 后端统一处理认证、异常等逻辑，前端只需和后端交互

这样既安全，又简化了前端的开发复杂度。

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