FluentCertificates.Builder
0.4.2-ci0007
See the version list below for details.
dotnet add package FluentCertificates.Builder --version 0.4.2-ci0007
NuGet\Install-Package FluentCertificates.Builder -Version 0.4.2-ci0007
<PackageReference Include="FluentCertificates.Builder" Version="0.4.2-ci0007" />
paket add FluentCertificates.Builder --version 0.4.2-ci0007
#r "nuget: FluentCertificates.Builder, 0.4.2-ci0007"
// Install FluentCertificates.Builder as a Cake Addin #addin nuget:?package=FluentCertificates.Builder&version=0.4.2-ci0007&prerelease // Install FluentCertificates.Builder as a Cake Tool #tool nuget:?package=FluentCertificates.Builder&version=0.4.2-ci0007&prerelease
FluentCertificates
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:
- FluentCertificates: Just brings in both the FluentCertificates.Builder and FluentCertificates.Finder packages.
- FluentCertificates.Builder: Provides
CertificateBuilder
for building certificates and also includes a bunch of convenient extension-methods. Examples below - FluentCertificates.Finder: Provides
CertificateFinder
for finding certificates across a collection of X509Stores. Examples below
CertificateBuilder
examples
Create a CertificateRequest
for signing, exporting and passing to a 3rd party CA:
var request = new CertificateBuilder()
.SetUsage(CertificateUsage.Server)
.SetSubject(new X500NameBuilder().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 X500NameBuilder().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(new X500NameBuilder().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 X500NameBuilder().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 X500NameBuilder().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
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 | Versions 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. |
-
.NETStandard 2.1
- Portable.BouncyCastle (>= 1.9.0)
- System.Collections.Immutable (>= 6.0.0)
- System.Formats.Asn1 (>= 6.0.0)
-
net5.0
- Portable.BouncyCastle (>= 1.9.0)
- System.Formats.Asn1 (>= 6.0.0)
-
net6.0
- Portable.BouncyCastle (>= 1.9.0)
- System.Formats.Asn1 (>= 6.0.0)
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.9.2-ci0002 | 76 | 2/19/2024 |
0.9.1 | 2,005 | 8/11/2023 |
0.9.1-ci0017 | 162 | 8/11/2023 |
0.9.1-ci0007 | 166 | 8/11/2023 |
0.9.1-ci0006 | 164 | 8/11/2023 |
0.9.0 | 213 | 8/10/2023 |
0.8.1-ci0031 | 172 | 8/10/2023 |
0.8.1-ci0028 | 140 | 8/2/2023 |
0.8.1-ci0027 | 158 | 8/2/2023 |
0.8.1-ci0025 | 135 | 8/2/2023 |
0.8.1-ci0020 | 160 | 8/1/2023 |
0.8.1-ci0018 | 142 | 8/1/2023 |
0.8.1-ci0016 | 154 | 8/1/2023 |
0.8.0 | 2,300 | 7/7/2022 |
0.7.2-ci0010 | 187 | 7/7/2022 |
0.7.2-ci0002 | 216 | 7/6/2022 |
0.7.2-ci0001 | 190 | 7/6/2022 |
0.7.1 | 652 | 6/24/2022 |
0.7.1-ci0001 | 172 | 6/24/2022 |
0.7.0 | 646 | 6/24/2022 |
0.6.1-ci0002 | 199 | 6/24/2022 |
0.6.1-ci0001 | 171 | 6/24/2022 |
0.6.0 | 649 | 6/23/2022 |
0.5.5-ci0009 | 182 | 6/23/2022 |
0.5.5-ci0008 | 145 | 6/23/2022 |
0.5.5-ci0007 | 188 | 6/23/2022 |
0.5.5-ci0006 | 195 | 6/23/2022 |
0.5.5-ci0005 | 153 | 6/23/2022 |
0.5.5-ci0004 | 188 | 6/21/2022 |
0.5.4 | 626 | 6/20/2022 |
0.5.4-ci0002 | 193 | 6/20/2022 |
0.5.3 | 627 | 6/20/2022 |
0.5.3-ci0005 | 188 | 6/20/2022 |
0.5.3-ci0004 | 175 | 6/20/2022 |
0.5.3-ci0003 | 170 | 6/20/2022 |
0.5.2 | 667 | 6/18/2022 |
0.5.2-ci0001 | 181 | 6/18/2022 |
0.5.1 | 640 | 6/17/2022 |
0.5.1-ci0001 | 174 | 6/17/2022 |
0.5.0 | 610 | 6/17/2022 |
0.4.2-ci0022 | 171 | 6/17/2022 |
0.4.2-ci0021 | 176 | 6/17/2022 |
0.4.2-ci0020 | 152 | 6/17/2022 |
0.4.2-ci0018 | 151 | 6/17/2022 |
0.4.2-ci0014 | 166 | 6/16/2022 |
0.4.2-ci0013 | 180 | 6/16/2022 |
0.4.2-ci0012 | 191 | 6/16/2022 |
0.4.2-ci0011 | 171 | 6/16/2022 |
0.4.2-ci0010 | 160 | 6/16/2022 |
0.4.2-ci0009 | 171 | 6/16/2022 |
0.4.2-ci0007 | 181 | 6/16/2022 |
0.4.2-ci0003 | 189 | 6/15/2022 |
0.4.2-ci0002 | 184 | 6/15/2022 |
0.4.2-ci0001 | 203 | 6/10/2022 |
0.4.1 | 630 | 6/10/2022 |
0.4.1-ci0008 | 177 | 6/10/2022 |
0.4.1-ci0007 | 186 | 6/10/2022 |
0.4.1-ci0006 | 185 | 6/10/2022 |
0.4.1-ci0005 | 171 | 6/10/2022 |
0.4.1-ci0004 | 155 | 6/10/2022 |
0.4.1-ci0003 | 196 | 6/10/2022 |
0.4.1-ci0002 | 157 | 6/8/2022 |
0.4.1-ci0001 | 190 | 6/8/2022 |
0.4.0 | 634 | 6/2/2022 |
0.3.3-ci0001 | 175 | 6/2/2022 |
0.3.2 | 649 | 6/2/2022 |
0.3.2-ci0002 | 190 | 5/31/2022 |
0.3.2-ci.1 | 113 | 5/30/2022 |