FluentCertificates.Finder
0.4.1-ci0008
See the version list below for details.
dotnet add package FluentCertificates.Finder --version 0.4.1-ci0008
NuGet\Install-Package FluentCertificates.Finder -Version 0.4.1-ci0008
<PackageReference Include="FluentCertificates.Finder" Version="0.4.1-ci0008" />
paket add FluentCertificates.Finder --version 0.4.1-ci0008
#r "nuget: FluentCertificates.Finder, 0.4.1-ci0008"
// Install FluentCertificates.Finder as a Cake Addin #addin nuget:?package=FluentCertificates.Finder&version=0.4.1-ci0008&prerelease // Install FluentCertificates.Finder as a Cake Tool #tool nuget:?package=FluentCertificates.Finder&version=0.4.1-ci0008&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: Simply 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 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 | 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 |