FluentCertificates.Builder 0.5.3-ci0003

This is a prerelease version of FluentCertificates.Builder.
There is a newer version of this package available.
See the version list below for details.
dotnet add package FluentCertificates.Builder --version 0.5.3-ci0003
                    
NuGet\Install-Package FluentCertificates.Builder -Version 0.5.3-ci0003
                    
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.Builder" Version="0.5.3-ci0003" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FluentCertificates.Builder" Version="0.5.3-ci0003" />
                    
Directory.Packages.props
<PackageReference Include="FluentCertificates.Builder" />
                    
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.Builder --version 0.5.3-ci0003
                    
#r "nuget: FluentCertificates.Builder, 0.5.3-ci0003"
                    
#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.Builder@0.5.3-ci0003
                    
#: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.Builder&version=0.5.3-ci0003&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=FluentCertificates.Builder&version=0.5.3-ci0003&prerelease
                    
Install as a Cake Tool

📖 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

CertificateBuilder requires the FluentCertificates.Builder package and is found under the FluentCertificates namespace.

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
using 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)
using 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
using 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
using 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:

using 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

CertificateFinder requires the FluentCertificates.Finder package and is found under the FluentCertificates namespace.

TODO: document this


X500NameBuilder examples

X500NameBuilder requires the FluentCertificates.Builder package and is found under the FluentCertificates namespace.

TODO: document this; see unit tests for more examples


X509Certificate2 extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

TODO: document these; see unit tests for more examples

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

X509Chain extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

TODO: document these

Extension-Method Description
ToCollection
ToEnumerable
ExportAsPkcs7
ExportAsPkcs12
ExportAsPem
ToPemString

X509Certificate2Collection extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

TODO: document these

Extension-Method Description
ToEnumerable
ExportAsPkcs7
ExportAsPkcs12
ExportAsPem
ToPemString

IEnumerable<X509Certificate2> extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

TODO: document these

Extension-Method Description
ToCollection
FilterPrivateKeys
ExportAsPkcs7
ExportAsPkcs12
ExportAsPem
ToPemString

AsymmetricAlgorithm extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

TODO: document these

Extension-Method Description
ToPrivateKeyPemString
ToPublicKeyPemString
ExportAsPrivateKeyPem
ExportAsPublicKeyPem

CertificateRequest extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

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

X509Extension extension-methods

These extension methods require the FluentCertificates.Builder package and are found under the FluentCertificates.Extensions namespace.

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.
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 netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen 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 (1)

Showing the top 1 NuGet packages that depend on FluentCertificates.Builder:

Package Downloads
FluentCertificates

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

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.12.1-ci0005 137 6/4/2025
0.12.1-ci0004 145 6/4/2025
0.12.1-ci0002 138 6/4/2025
0.12.1-ci0001 146 6/3/2025
0.12.0 165 6/3/2025
0.11.1-ci0007 144 6/3/2025
0.11.0 157 5/30/2025
0.10.1-ci0019 151 5/29/2025
0.10.1-ci0018 146 5/29/2025
0.10.1-ci0017 146 5/29/2025
0.10.1-ci0016 148 5/29/2025
0.10.1-ci0010 146 5/29/2025
0.10.1-ci0008 139 5/28/2025
0.10.1-ci0001 113 11/29/2024
0.10.0 1,364 11/28/2024
0.9.2-ci0009 98 11/28/2024
0.9.2-ci0008 104 11/28/2024
0.9.2-ci0006 105 11/27/2024
0.9.2-ci0004 103 11/27/2024
0.9.2-ci0002 149 2/19/2024
0.9.1 4,385 8/11/2023
0.9.1-ci0017 225 8/11/2023
0.9.1-ci0007 233 8/11/2023
0.9.1-ci0006 230 8/11/2023
0.9.0 276 8/10/2023
0.8.1-ci0031 238 8/10/2023
0.8.1-ci0028 203 8/2/2023
0.8.1-ci0027 222 8/2/2023
0.8.1-ci0025 195 8/2/2023
0.8.1-ci0020 228 8/1/2023
0.8.1-ci0018 212 8/1/2023
0.8.1-ci0016 209 8/1/2023
0.8.0 2,386 7/7/2022
0.7.2-ci0010 277 7/7/2022
0.7.2-ci0002 299 7/6/2022
0.7.2-ci0001 272 7/6/2022
0.7.1 743 6/24/2022
0.7.1-ci0001 267 6/24/2022
0.7.0 738 6/24/2022
0.6.1-ci0002 288 6/24/2022
0.6.1-ci0001 267 6/24/2022
0.6.0 753 6/23/2022
0.5.5-ci0009 258 6/23/2022
0.5.5-ci0008 225 6/23/2022
0.5.5-ci0007 269 6/23/2022
0.5.5-ci0006 283 6/23/2022
0.5.5-ci0005 248 6/23/2022
0.5.5-ci0004 274 6/21/2022
0.5.4 721 6/20/2022
0.5.4-ci0002 284 6/20/2022
0.5.3 725 6/20/2022
0.5.3-ci0005 266 6/20/2022
0.5.3-ci0004 254 6/20/2022
0.5.3-ci0003 243 6/20/2022
0.5.2 767 6/18/2022
0.5.2-ci0001 273 6/18/2022
0.5.1 738 6/17/2022
0.5.1-ci0001 241 6/17/2022
0.5.0 689 6/17/2022
0.4.2-ci0022 259 6/17/2022
0.4.2-ci0021 254 6/17/2022
0.4.2-ci0020 234 6/17/2022
0.4.2-ci0018 234 6/17/2022
0.4.2-ci0014 250 6/16/2022
0.4.2-ci0013 269 6/16/2022
0.4.2-ci0012 274 6/16/2022
0.4.2-ci0011 259 6/16/2022
0.4.2-ci0010 248 6/16/2022
0.4.2-ci0009 251 6/16/2022
0.4.2-ci0007 281 6/16/2022
0.4.2-ci0003 285 6/15/2022
0.4.2-ci0002 283 6/15/2022
0.4.2-ci0001 288 6/10/2022
0.4.1 725 6/10/2022
0.4.1-ci0008 268 6/10/2022
0.4.1-ci0007 277 6/10/2022
0.4.1-ci0006 267 6/10/2022
0.4.1-ci0005 261 6/10/2022
0.4.1-ci0004 248 6/10/2022
0.4.1-ci0003 289 6/10/2022
0.4.1-ci0002 244 6/8/2022
0.4.1-ci0001 280 6/8/2022
0.4.0 740 6/2/2022
0.3.3-ci0001 264 6/2/2022
0.3.2 735 6/2/2022
0.3.2-ci0002 272 5/31/2022
0.3.2-ci.1 172 5/30/2022