FluentCertificates.Finder 0.4.1-ci0007

This is a prerelease version of FluentCertificates.Finder.
There is a newer version of this package available.
See the version list below for details.
dotnet add package FluentCertificates.Finder --version 0.4.1-ci0007
                    
NuGet\Install-Package FluentCertificates.Finder -Version 0.4.1-ci0007
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FluentCertificates.Finder" Version="0.4.1-ci0007" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FluentCertificates.Finder" Version="0.4.1-ci0007" />
                    
Directory.Packages.props
<PackageReference Include="FluentCertificates.Finder" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FluentCertificates.Finder --version 0.4.1-ci0007
                    
#r "nuget: FluentCertificates.Finder, 0.4.1-ci0007"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package FluentCertificates.Finder@0.4.1-ci0007
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FluentCertificates.Finder&version=0.4.1-ci0007&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=FluentCertificates.Finder&version=0.4.1-ci0007&prerelease
                    
Install as a Cake Tool

FluentCertificates

.NET Build NuGet Stats GitHub license

FluentCertificates is a library using the Immutable Fluent Builder pattern for easily creating, finding and exporting certificates. Makes it simple to generate your own certificate chains, or just stand-alone self-signed certificates.

This project is published in three NuGet packages:

CertificateBuilder examples

Create a CertificateRequest for signing, exporting and passing to a 3rd party CA:

var request = new CertificateBuilder()
    .SetUsage(CertificateUsage.Server)
    .SetSubject(new X509NameBuilder().SetCommonName("*.fake.domain"))
    .SetDnsNames("*.fake.domain", "fake.domain")
    .ToCertificateRequest();

Build a self-signed web server certificate:

//Using a fluent style
var cert = new CertificateBuilder()
    .SetUsage(CertificateUsage.Server)
    .SetFriendlyName("Example self-signed web-server certificate")
    .SetSubject(new X509NameBuilder().SetCommonName("*.fake.domain"))
    .SetDnsNames("*.fake.domain", "fake.domain")
    .SetNotAfter(DateTimeOffset.UtcNow.AddMonths(1))
    .Build();

//And just to demonstrate using object initializers (I'll use fluent style from now on though)
var builder = new CertificateBuilder() {
    Usage = CertificateUsage.Server,
    FriendlyName = "Example self-signed web-server certificate",
    Subject = new X509NameBuilder().SetCommonName("*.fake.domain"),
    DnsNames = new[] { "*.fake.domain", "fake.domain" },
    NotAfter = DateTimeOffset.UtcNow.AddMonths(1)
};
var cert = builder.Build();

Build a CA (certificate authority):

//A CA's expiry date must be later than that of any certificates it will issue
var issuer = new CertificateBuilder()
    .SetUsage(CertificateUsage.CA)
    .SetFriendlyName("Example root CA")
    .SetSubject(new X509NameBuilder().SetCommonName("Example root CA"))
    .SetNotAfter(DateTimeOffset.UtcNow.AddYears(100))
    .Build();

Build a client-auth certificate signed by a CA:

//Note: the 'issuer' certificate used must have a private-key attached in order to sign this new certificate
var cert = new CertificateBuilder()
    .SetUsage(CertificateUsage.Client)
    .SetFriendlyName("Example client-auth certificate")
    .SetSubject(new X509NameBuilder().SetCommonName("User: Michael"))
    .SetNotAfter(DateTimeOffset.UtcNow.AddYears(1))
    .SetIssuer(issuer)
    .Build();

Advanced: Build a certificate with customized extensions:

var cert = new CertificateBuilder()
    .SetFriendlyName("Example certificate with customized extensions")
    .SetSubject(new X509NameBuilder().SetCommonName("Example certificate with customized extensions"))
    .AddExtension(new X509BasicConstraintsExtension(false, false, 0, true))
    .AddExtension(new X509KeyUsageExtension(X509KeyUsageFlags.DigitalSignature | X509KeyUsageFlags.KeyEncipherment | X509KeyUsageFlags.DataEncipherment, true))
    .AddExtension(new X509EnhancedKeyUsageExtension(new OidCollection { new(KeyPurposeID.AnyExtendedKeyUsage.Id) }, false))
    .SetIssuer(issuer)
    .Build();

CertificateFinder examples

TODO: document this

X509NameBuilder examples

TODO: document this

X509Certificate2 extension-methods

TODO: document this

X509Certificate2Collection extension-methods

TODO: document this

X509Chain extension-methods

TODO: document this


X509Extension extension-methods

Extension-Method Description
dnExtension.ConvertToBouncyCastle() Converts a DotNet X509Extension to a BouncyCastle X509Extension.
bcExtension.ConvertToDotNet(string oid) Converts a BouncyCastle X509Extension to a DotNet X509Extension. A DotNet X509Extension includes an OID, but a BouncyCastle one doesn't, therefore one must be supplied in the parameters here.
bcExtension.ConvertToDotNet(DerObjectIdentifier oid) Converts a BouncyCastle X509Extension to a DotNet X509Extension. A DotNet X509Extension includes an OID, but a BouncyCastle one doesn't, therefore one must be supplied in the parameters here.

CertificateRequest extension-methods

Extension-Method Description
ToPemString() Exports the CertificateRequest to a PEM string.
ExportAsPem(string path) Exports the CertificateRequest to the specified PEM file.
ConvertToBouncyCastle() Converts the CertificateRequest to a BouncyCastle Pkcs10CertificationRequest
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on FluentCertificates.Finder:

Package Downloads
FluentCertificates

FluentCertificates is a library using the Immutable Fluent Builder pattern for easily creating, finding/querying and exporting certificates.

Xtra.ServiceHosting.Identity

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.12.1-ci0005 134 6/4/2025
0.12.1-ci0004 136 6/4/2025
0.12.1-ci0002 138 6/4/2025
0.12.1-ci0001 144 6/3/2025
0.12.0 152 6/3/2025
0.11.1-ci0007 138 6/3/2025
0.11.0 154 5/30/2025
0.10.1-ci0019 151 5/29/2025
0.10.1-ci0018 141 5/29/2025
0.10.1-ci0017 142 5/29/2025
0.10.1-ci0016 150 5/29/2025
0.10.1-ci0010 145 5/29/2025
0.10.1-ci0008 150 5/28/2025
0.10.1-ci0001 113 11/29/2024
0.10.0 332 11/28/2024
0.9.2-ci0009 92 11/28/2024
0.9.2-ci0008 117 11/28/2024
0.9.2-ci0006 116 11/27/2024
0.9.2-ci0004 107 11/27/2024
0.9.2-ci0002 144 2/19/2024
0.9.1 672 8/11/2023
0.9.1-ci0017 217 8/11/2023
0.9.1-ci0007 211 8/11/2023
0.9.1-ci0006 248 8/11/2023
0.9.0 257 8/10/2023
0.8.1-ci0031 238 8/10/2023
0.8.1-ci0028 219 8/2/2023
0.8.1-ci0027 197 8/2/2023
0.8.1-ci0025 236 8/2/2023
0.8.1-ci0020 238 8/1/2023
0.8.1-ci0018 212 8/1/2023
0.8.1-ci0016 227 8/1/2023
0.8.0 3,847 7/7/2022
0.7.2-ci0010 296 7/7/2022
0.7.2-ci0002 286 7/6/2022
0.7.2-ci0001 268 7/6/2022
0.7.1 728 6/24/2022
0.7.1-ci0001 240 6/24/2022
0.7.0 718 6/24/2022
0.6.1-ci0002 287 6/24/2022
0.6.1-ci0001 252 6/24/2022
0.6.0 748 6/23/2022
0.5.5-ci0009 257 6/23/2022
0.5.5-ci0008 254 6/23/2022
0.5.5-ci0007 274 6/23/2022
0.5.5-ci0006 272 6/23/2022
0.5.5-ci0005 250 6/23/2022
0.5.5-ci0004 271 6/21/2022
0.5.4 715 6/20/2022
0.5.4-ci0002 263 6/20/2022
0.5.3 712 6/20/2022
0.5.3-ci0005 267 6/20/2022
0.5.3-ci0004 272 6/20/2022
0.5.3-ci0003 251 6/20/2022
0.5.2 767 6/18/2022
0.5.2-ci0001 264 6/18/2022
0.5.1 753 6/17/2022
0.5.1-ci0001 239 6/17/2022
0.5.0 670 6/17/2022
0.4.2-ci0022 266 6/17/2022
0.4.2-ci0021 261 6/17/2022
0.4.2-ci0020 245 6/17/2022
0.4.2-ci0018 262 6/17/2022
0.4.2-ci0014 246 6/16/2022
0.4.2-ci0013 268 6/16/2022
0.4.2-ci0012 271 6/16/2022
0.4.2-ci0011 250 6/16/2022
0.4.2-ci0010 247 6/16/2022
0.4.2-ci0009 279 6/16/2022
0.4.2-ci0007 230 6/16/2022
0.4.2-ci0003 283 6/15/2022
0.4.2-ci0002 274 6/15/2022
0.4.2-ci0001 257 6/10/2022
0.4.1 733 6/10/2022
0.4.1-ci0008 243 6/10/2022
0.4.1-ci0007 273 6/10/2022
0.4.1-ci0006 281 6/10/2022
0.4.1-ci0005 278 6/10/2022
0.4.1-ci0004 265 6/10/2022
0.4.1-ci0003 264 6/10/2022
0.4.1-ci0002 262 6/8/2022
0.4.1-ci0001 245 6/8/2022
0.4.0 754 6/2/2022
0.3.3-ci0001 252 6/2/2022
0.3.2 958 6/2/2022
0.3.2-ci0002 962 5/31/2022
0.3.2-ci.1 211 5/30/2022