寻求支持NemLog-in日志与后端登出的ITfoxtec.Identity.Saml2示例

后端单点登出实现 #

NemLog-in要求的后端单点登出（IDP主动发起的注销），你可以基于现有NemLog-in3示例扩展/Auth/SingleLogout端点来支持：

• 该端点需要同时兼容前端发起的注销请求和IDP直接调用的后端注销请求
• 核心逻辑是判断请求类型：如果是IDP发起的SAML注销请求（携带SAML断言），先验证断言的有效性（签名、受众匹配等），再注销本地用户会话，最后返回合法的SAML注销响应给IDP
• 核心代码示例：

[HttpPost("SingleLogout")]
public async Task<IActionResult> SingleLogout()
{
    var saml2LogoutRequest = new Saml2LogoutRequest(_configuration, _saml2Configuration);
    await saml2LogoutRequest.ReadSamlRequestAsync(HttpContext.Request);
    
    // 验证请求合法性
    if (!saml2LogoutRequest.IsValid())
    {
        return BadRequest("无效的SAML注销请求");
    }

    // 注销本地用户会话
    await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);

    // 构造并返回注销响应
    var saml2LogoutResponse = new Saml2LogoutResponse(_configuration, _saml2Configuration);
    saml2LogoutResponse.InResponseTo = saml2LogoutRequest.Id;
    return saml2LogoutResponse.CreateHttpPostResult();
}

• 注意要在SAML配置中正确导入IDP的元数据，确保注销端点地址、签名证书等参数配置准确，才能正常验证IDP发起的请求

符合NemLog-in日志要求的实现 #

NemLog-in的日志要求通常包含SAML请求/响应的完整追踪、关键事件（登录/注销成功/失败、断言验证结果）的审计日志，你可以通过以下方式实现：

• 利用ITfoxtec.Identity.Saml2的事件回调：在Saml2AuthenticationOptions中配置Events，捕获登录、注销、验证失败等关键事件，记录详细日志
• 记录SAML消息内容：处理请求/响应时读取原始SAML XML（注意脱敏敏感信息，如用户隐私属性），配合时间戳、请求ID、客户端IP等元数据一起存储
• 日志记录逻辑示例：

services.AddSaml2(options =>
{
    options.Events = new Saml2Events
    {
        OnAuthenticated = context =>
        {
            _logger.LogInformation($"用户登录成功，Subject: {context.Principal.Identity.Name}, SAML请求ID: {context.Saml2Response.Id}");
            return Task.CompletedTask;
        },
        OnAuthenticationFailed = context =>
        {
            _logger.LogError(context.Exception, $"登录验证失败，错误信息: {context.Exception.Message}");
            return Task.CompletedTask;
        },
        OnLogoutSucceeded = context =>
        {
            var samlId = context.Saml2LogoutRequest?.Id ?? context.Saml2LogoutResponse?.Id;
            _logger.LogInformation($"用户注销成功，SAML消息ID: {samlId}");
            return Task.CompletedTask;
        }
    };
});

内容的提问来源于stack exchange，提问作者Per Fuglsang Møller