CefSharp WinForms设置Auth偏好报错：Trying to modify unregistered preference

问题原因 #

你遇到的"Trying to modify an unregistered preference"错误，核心原因是Kerberos相关的auth偏好需要在RequestContext初始化前配置，而OnIsBrowserInitializedChanged事件触发时，浏览器的RequestContext已经完成初始化，此时无法修改未提前注册的安全类偏好。

解决方案 #

方案1：初始化阶段配置RequestContextSettings（推荐） #

在创建ChromiumWebBrowser实例前，通过RequestContextSettings提前设置Kerberos白名单，这是最可靠的方式：

// 初始化RequestContext配置
var requestContextSettings = new RequestContextSettings();

// 设置Kerberos委托白名单和服务器允许列表
requestContextSettings.SetPreference("auth.negotiate_delegate_whitelist", "*", out string errorMsg1);
requestContextSettings.SetPreference("auth.server_allowlist", "*", out string errorMsg2);

// 检查配置是否成功
if (!string.IsNullOrEmpty(errorMsg1))
{
    MessageBox.Show($"配置negotiate_delegate_whitelist失败：{errorMsg1}");
}
if (!string.IsNullOrEmpty(errorMsg2))
{
    MessageBox.Show($"配置server_allowlist失败：{errorMsg2}");
}

// 创建带自定义RequestContext的浏览器实例
var chromiumBrowser = new ChromiumWebBrowser("你的网站URL")
{
    RequestContext = new RequestContext(requestContextSettings)
};

// 将浏览器添加到容器（比如WinForms的Panel）
yourPanel.Controls.Add(chromiumBrowser);
chromiumBrowser.Dock = DockStyle.Fill;

方案2：运行时先注册偏好再设置 #

如果必须在浏览器初始化完成后修改，可以先通过RegisterCustomPreference注册目标偏好，再执行设置：

private void OnIsBrowserInitializedChanged(object sender, EventArgs e)
{         
    var browser = ((ChromiumWebBrowser)sender);
    var requestContext = browser.GetRequestContext();

    // 注册Kerberos相关偏好
    var negotiatePref = new Dictionary<string, object>
    {
        ["type"] = "string",
        ["default"] = "*",
        ["description"] = "允许Kerberos委托的域名白名单"
    };
    requestContext.RegisterCustomPreference("auth.negotiate_delegate_whitelist", negotiatePref);

    var serverPref = new Dictionary<string, object>
    {
        ["type"] = "string",
        ["default"] = "*",
        ["description"] = "允许Kerberos认证的服务器白名单"
    };
    requestContext.RegisterCustomPreference("auth.server_allowlist", serverPref);

    // 尝试设置偏好值
    bool isNegotiateSet = requestContext.SetPreference("auth.negotiate_delegate_whitelist", "*", out string errorNegotiate);
    bool isServerSet = requestContext.SetPreference("auth.server_allowlist", "*", out string errorServer);

    // 输出错误信息
    if (!isNegotiateSet) MessageBox.Show(errorNegotiate);
    if (!isServerSet) MessageBox.Show(errorServer);

    this.InvokeOnUiThreadIfRequired(() => browser.Focus());
}

方案3：通过Cef命令行参数配置 #

还可以在Cef初始化阶段，通过命令行参数直接配置：

var cefSettings = new CefSettings();
// 添加Kerberos白名单命令行参数
cefSettings.CefCommandLineArgs.Add("auth-negotiate-delegate-whitelist", "*");
cefSettings.CefCommandLineArgs.Add("auth-server-allowlist", "*");

// 初始化Cef
if (!Cef.IsInitialized)
{
    Cef.Initialize(cefSettings);
}

注意事项 #

• 优先选择方案1，因为Chromium的部分安全相关偏好仅支持初始化阶段配置，运行时修改可能存在限制。
• 确保使用的CefSharp版本为较新版本，旧版本可能对Kerberos相关偏好的支持不完善。
• 如果你的网站需要特定域名的白名单，将*替换为具体域名（比如*.yourdomain.com），提升安全性。

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