AspNetCore.Authentication.SK.IdCard 1.0.0-alpha2

AspNetCore.Authentication.SK.IDCard

AspNetCore.Authentication.SK.IDCard is a ID-card security middleware that you can use in your ASP.NET Core application to support SK ID-card authentication. It is inspired by Microsoft Certificate authentication. It is not perfect, but functional as external authentication.

The latest alpha release can be found on NuGet.

Getting started

Install SK root CA and intermediate certificates to your running computer or server from SK site. They have to be installed in propriate stores or received user certifiactes are not validated.

Authentication flow requires to redirect user to host that requires client certificate in TLS level. For that sample uses same application on different port, but it is also possible to use subdomain instead.

Configure your hosting environenment with additionally listen https with client certificate. Eg. add following lines to your CreateHostBuilder:

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
            webBuilder.ConfigureKestrel(options =>
            {
                options.ListenLocalhost(5000);
                options.ListenLocalhost(5001, listenOptions => listenOptions.UseHttps());
                options.ListenLocalhost(5002, listenOptions =>
                {
                    listenOptions.UseHttps(adapterOptions =>
                    {
                        adapterOptions.ClientCertificateMode = ClientCertificateMode.RequireCertificate;
                    });
                });
            });
        });

Add following lines to your Startup class:

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication()
        .AddIdCard(options =>
        {
            options.MainSite = "https://localhost:5001";
            options.AuthenticationSite = "https://localhost:5002";
        })
}

public void Configure(IApplicationBuilder app)
{
    app.UseAuthentication();
    app.UseAuthorization();
    app.UseIdCardAuthentication();
}

See the /sample directory for a complete sample using ASP.NET Core MVC.