FluentCertificates 0.4.2-ci0003

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher. .NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher.
This is a prerelease version of FluentCertificates.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package FluentCertificates --version 0.4.2-ci0003                

                    
                

            
NuGet\Install-Package FluentCertificates -Version 0.4.2-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" Version="0.4.2-ci0003" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add FluentCertificates --version 0.4.2-ci0003                

                    
                

            
#r "nuget: FluentCertificates, 0.4.2-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. 
// Install FluentCertificates as a Cake Addin
#addin nuget:?package=FluentCertificates&version=0.4.2-ci0003&prerelease

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

FluentCertificates

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:

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. 
.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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.9.2-ci0002 96 2/19/2024
0.9.1 349 8/11/2023
0.9.1-ci0017 138 8/11/2023
0.9.1-ci0007 138 8/11/2023
0.9.1-ci0006 159 8/11/2023
0.9.0 182 8/10/2023
0.8.1-ci0031 135 8/10/2023
0.8.1-ci0028 133 8/2/2023
0.8.1-ci0027 128 8/2/2023
0.8.1-ci0025 134 8/2/2023
0.8.1-ci0020 150 8/1/2023
0.8.1-ci0018 123 8/1/2023
0.8.1-ci0016 131 8/1/2023
0.8.0 461 7/7/2022
0.7.2-ci0010 181 7/7/2022
0.7.2-ci0002 172 7/6/2022
0.7.2-ci0001 160 7/6/2022
0.7.1 410 6/24/2022
0.7.1-ci0001 155 6/24/2022
0.7.0 411 6/24/2022
0.6.1-ci0002 175 6/24/2022
0.6.1-ci0001 154 6/24/2022
0.6.0 420 6/23/2022
0.5.5-ci0009 154 6/23/2022
0.5.5-ci0008 151 6/23/2022
0.5.5-ci0007 165 6/23/2022
0.5.5-ci0006 170 6/23/2022
0.5.5-ci0005 154 6/23/2022
0.5.5-ci0004 174 6/21/2022
0.5.4 401 6/20/2022
0.5.4-ci0002 153 6/20/2022
0.5.3 400 6/20/2022
0.5.3-ci0005 162 6/20/2022
0.5.3-ci0004 156 6/20/2022
0.5.3-ci0003 140 6/20/2022
0.5.2 428 6/18/2022
0.5.2-ci0001 159 6/18/2022
0.5.1 421 6/17/2022
0.5.1-ci0001 153 6/17/2022
0.5.0 392 6/17/2022
0.4.2-ci0022 164 6/17/2022
0.4.2-ci0021 171 6/17/2022
0.4.2-ci0020 162 6/17/2022
0.4.2-ci0018 163 6/17/2022
0.4.2-ci0014 164 6/16/2022
0.4.2-ci0013 169 6/16/2022
0.4.2-ci0012 182 6/16/2022
0.4.2-ci0011 166 6/16/2022
0.4.2-ci0010 145 6/16/2022
0.4.2-ci0009 168 6/16/2022
0.4.2-ci0007 152 6/16/2022
0.4.2-ci0003 171 6/15/2022
0.4.2-ci0002 188 6/15/2022
0.4.2-ci0001 179 6/10/2022
0.4.1 413 6/10/2022
0.4.1-ci0008 151 6/10/2022
0.4.1-ci0007 163 6/10/2022
0.4.1-ci0006 177 6/10/2022
0.4.1-ci0005 170 6/10/2022
0.4.1-ci0004 164 6/10/2022
0.4.1-ci0003 172 6/10/2022
0.4.1-ci0002 170 6/8/2022
0.4.1-ci0001 159 6/8/2022
0.4.0 425 6/2/2022
0.3.3-ci0001 175 6/2/2022
0.3.2 413 6/2/2022
0.3.2-ci0002 173 5/31/2022
0.3.2-ci.1 123 5/30/2022