FluentCertificates.Finder
0.5.4-ci0002
See the version list below for details.
dotnet add package FluentCertificates.Finder --version 0.5.4-ci0002
NuGet\Install-Package FluentCertificates.Finder -Version 0.5.4-ci0002
<PackageReference Include="FluentCertificates.Finder" Version="0.5.4-ci0002" />
paket add FluentCertificates.Finder --version 0.5.4-ci0002
#r "nuget: FluentCertificates.Finder, 0.5.4-ci0002"
// Install FluentCertificates.Finder as a Cake Addin #addin nuget:?package=FluentCertificates.Finder&version=0.5.4-ci0002&prerelease // Install FluentCertificates.Finder as a Cake Tool #tool nuget:?package=FluentCertificates.Finder&version=0.5.4-ci0002&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.
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
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 | 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 | 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. |
-
.NETStandard 2.0
- System.Collections.Immutable (>= 6.0.0)
-
.NETStandard 2.1
- System.Collections.Immutable (>= 6.0.0)
-
net5.0
- No dependencies.
-
net6.0
- No dependencies.
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 | 121 | 2/19/2024 |
0.9.1 | 521 | 8/11/2023 |
0.9.1-ci0017 | 189 | 8/11/2023 |
0.9.1-ci0007 | 179 | 8/11/2023 |
0.9.1-ci0006 | 211 | 8/11/2023 |
0.9.0 | 223 | 8/10/2023 |
0.8.1-ci0031 | 198 | 8/10/2023 |
0.8.1-ci0028 | 187 | 8/2/2023 |
0.8.1-ci0027 | 165 | 8/2/2023 |
0.8.1-ci0025 | 200 | 8/2/2023 |
0.8.1-ci0020 | 204 | 8/1/2023 |
0.8.1-ci0018 | 176 | 8/1/2023 |
0.8.1-ci0016 | 187 | 8/1/2023 |
0.8.0 | 3,787 | 7/7/2022 |
0.7.2-ci0010 | 237 | 7/7/2022 |
0.7.2-ci0002 | 230 | 7/6/2022 |
0.7.2-ci0001 | 212 | 7/6/2022 |
0.7.1 | 673 | 6/24/2022 |
0.7.1-ci0001 | 190 | 6/24/2022 |
0.7.0 | 664 | 6/24/2022 |
0.6.1-ci0002 | 222 | 6/24/2022 |
0.6.1-ci0001 | 196 | 6/24/2022 |
0.6.0 | 683 | 6/23/2022 |
0.5.5-ci0009 | 206 | 6/23/2022 |
0.5.5-ci0008 | 200 | 6/23/2022 |
0.5.5-ci0007 | 215 | 6/23/2022 |
0.5.5-ci0006 | 218 | 6/23/2022 |
0.5.5-ci0005 | 198 | 6/23/2022 |
0.5.5-ci0004 | 221 | 6/21/2022 |
0.5.4 | 660 | 6/20/2022 |
0.5.4-ci0002 | 209 | 6/20/2022 |
0.5.3 | 658 | 6/20/2022 |
0.5.3-ci0005 | 215 | 6/20/2022 |
0.5.3-ci0004 | 222 | 6/20/2022 |
0.5.3-ci0003 | 198 | 6/20/2022 |
0.5.2 | 704 | 6/18/2022 |
0.5.2-ci0001 | 212 | 6/18/2022 |
0.5.1 | 690 | 6/17/2022 |
0.5.1-ci0001 | 183 | 6/17/2022 |
0.5.0 | 616 | 6/17/2022 |
0.4.2-ci0022 | 207 | 6/17/2022 |
0.4.2-ci0021 | 207 | 6/17/2022 |
0.4.2-ci0020 | 194 | 6/17/2022 |
0.4.2-ci0018 | 211 | 6/17/2022 |
0.4.2-ci0014 | 194 | 6/16/2022 |
0.4.2-ci0013 | 218 | 6/16/2022 |
0.4.2-ci0012 | 223 | 6/16/2022 |
0.4.2-ci0011 | 197 | 6/16/2022 |
0.4.2-ci0010 | 195 | 6/16/2022 |
0.4.2-ci0009 | 215 | 6/16/2022 |
0.4.2-ci0007 | 179 | 6/16/2022 |
0.4.2-ci0003 | 224 | 6/15/2022 |
0.4.2-ci0002 | 215 | 6/15/2022 |
0.4.2-ci0001 | 207 | 6/10/2022 |
0.4.1 | 674 | 6/10/2022 |
0.4.1-ci0008 | 189 | 6/10/2022 |
0.4.1-ci0007 | 221 | 6/10/2022 |
0.4.1-ci0006 | 223 | 6/10/2022 |
0.4.1-ci0005 | 219 | 6/10/2022 |
0.4.1-ci0004 | 216 | 6/10/2022 |
0.4.1-ci0003 | 210 | 6/10/2022 |
0.4.1-ci0002 | 210 | 6/8/2022 |
0.4.1-ci0001 | 188 | 6/8/2022 |
0.4.0 | 671 | 6/2/2022 |
0.3.3-ci0001 | 199 | 6/2/2022 |
0.3.2 | 892 | 6/2/2022 |
0.3.2-ci0002 | 910 | 5/31/2022 |
0.3.2-ci.1 | 159 | 5/30/2022 |