FluentCertificates.Finder 0.4.2-ci0022

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.2-ci0022
NuGet\Install-Package FluentCertificates.Finder -Version 0.4.2-ci0022
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.2-ci0022" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluentCertificates.Finder --version 0.4.2-ci0022
#r "nuget: FluentCertificates.Finder, 0.4.2-ci0022"
#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.
// Install FluentCertificates.Finder as a Cake Addin
#addin nuget:?package=FluentCertificates.Finder&version=0.4.2-ci0022&prerelease

// Install FluentCertificates.Finder as a Cake Tool
#tool nuget:?package=FluentCertificates.Finder&version=0.4.2-ci0022&prerelease

📖 FluentCertificates Overview

⚠️ Note: while version numbers are v0.x.y, this software is under initial development and there'll be breaking-changes in its API from version to version.

GitHub license NuGet Stats Build & Publish

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:

Unfortunately documentation is incomplete. You may find more examples within the project's unit tests.

CertificateBuilder examples

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

var request = new CertificateBuilder()
    .SetUsage(CertificateUsage.Server)
    .SetSubject(b => b.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(b => b.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 X500NameBuilder().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(b => b.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(b => b.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(b => b.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


X500NameBuilder examples

TODO: document this; see unit tests for more examples


X509Certificate2 extension-methods

TODO: document this; see unit tests for more examples

Extension-Method Description
BuildChain
ExportAsCert
ExportAsPkcs12
ExportAsPkcs7
ExportAsPem
ToPemString
ToBase64String
GetPrivateKey
IsValidNow
IsValid
IsSelfSigned
IsIssuedBy
VerifyIssuer

X509Certificate2Collection extension-methods

TODO: document this |Extension-Method|Description| |-|-| |ToEnumerable|| |ExportAsPkcs7|| |ExportAsPkcs12|| |ExportAsPem|| |ToPemString||


IEnumerable<X509Certificate2> extension-methods

TODO: document this |Extension-Method|Description| |-|-| |ToCollection|| |FilterPrivateKeys|| |ExportAsPkcs7|| |ExportAsPkcs12|| |ExportAsPem|| |ToPemString||


X509Chain extension-methods

TODO: document this |Extension-Method|Description| |-|-| |ToCollection|| |ToEnumerable|| |ExportAsPkcs7|| |ExportAsPkcs12|| |ExportAsPem|| |ToPemString||


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.
ExportAsPem(TextWriter writer) Exports the CertificateRequest in PEM format to the given TextWriter.
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. 
.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.9.2-ci0002 76 2/19/2024
0.9.1 342 8/11/2023
0.9.1-ci0017 167 8/11/2023
0.9.1-ci0007 140 8/11/2023
0.9.1-ci0006 169 8/11/2023
0.9.0 185 8/10/2023
0.8.1-ci0031 158 8/10/2023
0.8.1-ci0028 144 8/2/2023
0.8.1-ci0027 133 8/2/2023
0.8.1-ci0025 162 8/2/2023
0.8.1-ci0020 163 8/1/2023
0.8.1-ci0018 136 8/1/2023
0.8.1-ci0016 153 8/1/2023
0.8.0 3,548 7/7/2022
0.7.2-ci0010 203 7/7/2022
0.7.2-ci0002 196 7/6/2022
0.7.2-ci0001 175 7/6/2022
0.7.1 629 6/24/2022
0.7.1-ci0001 160 6/24/2022
0.7.0 631 6/24/2022
0.6.1-ci0002 183 6/24/2022
0.6.1-ci0001 160 6/24/2022
0.6.0 638 6/23/2022
0.5.5-ci0009 184 6/23/2022
0.5.5-ci0008 165 6/23/2022
0.5.5-ci0007 181 6/23/2022
0.5.5-ci0006 181 6/23/2022
0.5.5-ci0005 162 6/23/2022
0.5.5-ci0004 187 6/21/2022
0.5.4 621 6/20/2022
0.5.4-ci0002 174 6/20/2022
0.5.3 625 6/20/2022
0.5.3-ci0005 179 6/20/2022
0.5.3-ci0004 185 6/20/2022
0.5.3-ci0003 172 6/20/2022
0.5.2 648 6/18/2022
0.5.2-ci0001 173 6/18/2022
0.5.1 643 6/17/2022
0.5.1-ci0001 162 6/17/2022
0.5.0 590 6/17/2022
0.4.2-ci0022 172 6/17/2022
0.4.2-ci0021 166 6/17/2022
0.4.2-ci0020 162 6/17/2022
0.4.2-ci0018 157 6/17/2022
0.4.2-ci0014 163 6/16/2022
0.4.2-ci0013 186 6/16/2022
0.4.2-ci0012 185 6/16/2022
0.4.2-ci0011 158 6/16/2022
0.4.2-ci0010 157 6/16/2022
0.4.2-ci0009 182 6/16/2022
0.4.2-ci0007 147 6/16/2022
0.4.2-ci0003 186 6/15/2022
0.4.2-ci0002 176 6/15/2022
0.4.2-ci0001 175 6/10/2022
0.4.1 637 6/10/2022
0.4.1-ci0008 157 6/10/2022
0.4.1-ci0007 178 6/10/2022
0.4.1-ci0006 188 6/10/2022
0.4.1-ci0005 182 6/10/2022
0.4.1-ci0004 175 6/10/2022
0.4.1-ci0003 178 6/10/2022
0.4.1-ci0002 167 6/8/2022
0.4.1-ci0001 155 6/8/2022
0.4.0 635 6/2/2022
0.3.3-ci0001 164 6/2/2022
0.3.2 841 6/2/2022
0.3.2-ci0002 819 5/31/2022
0.3.2-ci.1 141 5/30/2022