FluentCertificates 0.4.2-ci0013
This is a prerelease version of FluentCertificates.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package FluentCertificates --version 0.4.2-ci0013
NuGet\Install-Package FluentCertificates -Version 0.4.2-ci0013
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-ci0013" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluentCertificates --version 0.4.2-ci0013
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: FluentCertificates, 0.4.2-ci0013"
#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-ci0013&prerelease
// Install FluentCertificates as a Cake Tool
#tool nuget:?package=FluentCertificates&version=0.4.2-ci0013&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
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(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
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. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.1
- FluentCertificates.Builder (>= 0.4.2-ci0013)
- FluentCertificates.Finder (>= 0.4.2-ci0013)
-
net5.0
- FluentCertificates.Builder (>= 0.4.2-ci0013)
- FluentCertificates.Finder (>= 0.4.2-ci0013)
-
net6.0
- FluentCertificates.Builder (>= 0.4.2-ci0013)
- FluentCertificates.Finder (>= 0.4.2-ci0013)
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 | 63 | 2/19/2024 |
0.9.1 | 202 | 8/11/2023 |
0.9.1-ci0017 | 122 | 8/11/2023 |
0.9.1-ci0007 | 106 | 8/11/2023 |
0.9.1-ci0006 | 124 | 8/11/2023 |
0.9.0 | 157 | 8/10/2023 |
0.8.1-ci0031 | 112 | 8/10/2023 |
0.8.1-ci0028 | 107 | 8/2/2023 |
0.8.1-ci0027 | 103 | 8/2/2023 |
0.8.1-ci0025 | 116 | 8/2/2023 |
0.8.1-ci0020 | 118 | 8/1/2023 |
0.8.1-ci0018 | 97 | 8/1/2023 |
0.8.1-ci0016 | 106 | 8/1/2023 |
0.8.0 | 431 | 7/7/2022 |
0.7.2-ci0010 | 159 | 7/7/2022 |
0.7.2-ci0002 | 152 | 7/6/2022 |
0.7.2-ci0001 | 133 | 7/6/2022 |
0.7.1 | 382 | 6/24/2022 |
0.7.1-ci0001 | 133 | 6/24/2022 |
0.7.0 | 383 | 6/24/2022 |
0.6.1-ci0002 | 141 | 6/24/2022 |
0.6.1-ci0001 | 125 | 6/24/2022 |
0.6.0 | 378 | 6/23/2022 |
0.5.5-ci0009 | 144 | 6/23/2022 |
0.5.5-ci0008 | 126 | 6/23/2022 |
0.5.5-ci0007 | 136 | 6/23/2022 |
0.5.5-ci0006 | 141 | 6/23/2022 |
0.5.5-ci0005 | 124 | 6/23/2022 |
0.5.5-ci0004 | 145 | 6/21/2022 |
0.5.4 | 374 | 6/20/2022 |
0.5.4-ci0002 | 132 | 6/20/2022 |
0.5.3 | 371 | 6/20/2022 |
0.5.3-ci0005 | 142 | 6/20/2022 |
0.5.3-ci0004 | 133 | 6/20/2022 |
0.5.3-ci0003 | 125 | 6/20/2022 |
0.5.2 | 398 | 6/18/2022 |
0.5.2-ci0001 | 137 | 6/18/2022 |
0.5.1 | 390 | 6/17/2022 |
0.5.1-ci0001 | 140 | 6/17/2022 |
0.5.0 | 377 | 6/17/2022 |
0.4.2-ci0022 | 135 | 6/17/2022 |
0.4.2-ci0021 | 141 | 6/17/2022 |
0.4.2-ci0020 | 132 | 6/17/2022 |
0.4.2-ci0018 | 132 | 6/17/2022 |
0.4.2-ci0014 | 138 | 6/16/2022 |
0.4.2-ci0013 | 137 | 6/16/2022 |
0.4.2-ci0012 | 154 | 6/16/2022 |
0.4.2-ci0011 | 140 | 6/16/2022 |
0.4.2-ci0010 | 124 | 6/16/2022 |
0.4.2-ci0009 | 138 | 6/16/2022 |
0.4.2-ci0007 | 122 | 6/16/2022 |
0.4.2-ci0003 | 145 | 6/15/2022 |
0.4.2-ci0002 | 160 | 6/15/2022 |
0.4.2-ci0001 | 158 | 6/10/2022 |
0.4.1 | 389 | 6/10/2022 |
0.4.1-ci0008 | 124 | 6/10/2022 |
0.4.1-ci0007 | 126 | 6/10/2022 |
0.4.1-ci0006 | 148 | 6/10/2022 |
0.4.1-ci0005 | 149 | 6/10/2022 |
0.4.1-ci0004 | 140 | 6/10/2022 |
0.4.1-ci0003 | 147 | 6/10/2022 |
0.4.1-ci0002 | 144 | 6/8/2022 |
0.4.1-ci0001 | 137 | 6/8/2022 |
0.4.0 | 402 | 6/2/2022 |
0.3.3-ci0001 | 143 | 6/2/2022 |
0.3.2 | 382 | 6/2/2022 |
0.3.2-ci0002 | 147 | 5/31/2022 |
0.3.2-ci.1 | 107 | 5/30/2022 |