Skip to main content
net10.0

ASP.NET Core middleware that enables an application to support certificate authentication. This package was built from the source code at https://github.com/dotnet/dotnet/tree/75972a5ba730bdaf7cf3a34f528ab0f5c7f05183

Published
Jul 15, 2025
1y ago
Total Downloads
24.5M
24,468,492

Install

dotnet add package Microsoft.AspNetCore.Authentication.Certificate --version 10.0.0-preview.6.25358.103
ProductVersions
.NET
net10.0

README

About

Microsoft.AspNetCore.Authentication.Certificate provides ASP.NET Core middleware that enables an application to support certificate authentication.

How to Use

To use Microsoft.AspNetCore.Authentication.Certificate, follow these steps:

Installation

dotnet add package Microsoft.AspNetCore.Authentication.Certificate

Configuration

  1. Acquire an HTTPS certificate, install it, and configure your server to require certificates
  2. Configure the middleware in your APS.NET Core app's Program.cs:
    var builder = WebApplication.CreateBuilder(args);
    
    builder.Services.AddAuthentication(
            CertificateAuthenticationDefaults.AuthenticationScheme)
        .AddCertificate();
    
    var app = builder.Build();
    
    app.UseAuthentication();
    

Main Types

  • CertificateAuthenticationOptions: Provides options to configure certificate authentication
  • ICertificateValidationCache: Provides a cache used to store AuthenticateResult results after the certificate has been validated

Additional Documentation

For additional documentation and examples, refer to the official documentation on certificate authentication in ASP.NET Core.

Feedback & Contributing

Microsoft.AspNetCore.Authentication.Certificate is released as open-source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Changes from Previous Version

No structural changes between v10.0.0-preview.5.25277.114 and v10.0.0-preview.6.25358.103.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.