FluentCertificates 0.4.1

There is a newer version of this package available.
See the version list below for details.

dotnet add package FluentCertificates --version 0.4.1

NuGet\Install-Package FluentCertificates -Version 0.4.1

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.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add FluentCertificates --version 0.4.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: FluentCertificates, 0.4.1"

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

// Install FluentCertificates as a Cake Tool
#tool nuget:?package=FluentCertificates&version=0.4.1

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: 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	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.1)
- FluentCertificates.Finder (>= 0.4.1)
net5.0
- FluentCertificates.Builder (>= 0.4.1)
- FluentCertificates.Finder (>= 0.4.1)
net6.0
- FluentCertificates.Builder (>= 0.4.1)
- FluentCertificates.Finder (>= 0.4.1)

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

FluentCertificates 0.4.1

FluentCertificates

CertificateBuilder examples

Create a CertificateRequest for signing, exporting and passing to a 3rd party CA:

Build a self-signed web server certificate:

Build a CA (certificate authority):

Build a client-auth certificate signed by a CA:

Advanced: Build a certificate with customized extensions:

CertificateFinder examples

X509NameBuilder examples

X509Certificate2 extension-methods

X509Certificate2Collection extension-methods

X509Chain extension-methods

X509Extension extension-methods

CertificateRequest extension-methods

.NETStandard 2.1

net5.0

net6.0

NuGet packages

GitHub repositories

`CertificateBuilder` examples

Create a `CertificateRequest` for signing, exporting and passing to a 3rd party CA:

`CertificateFinder` examples

`X509NameBuilder` examples

`X509Certificate2` extension-methods

`X509Certificate2Collection` extension-methods

`X509Chain` extension-methods

`X509Extension` extension-methods

`CertificateRequest` extension-methods