FluentCertificates.Builder 0.4.2-ci0007

This is a prerelease version of FluentCertificates.Builder.

There is a newer version of this package available.
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

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.Builder" Version="0.4.2-ci0007" />

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

paket add FluentCertificates.Builder --version 0.4.2-ci0007

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

#r "nuget: FluentCertificates.Builder, 0.4.2-ci0007"

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

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(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	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
- 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.	13.5K

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

FluentCertificates.Builder 0.4.2-ci0007

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

X500NameBuilder 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 (1)

GitHub repositories

`CertificateBuilder` examples

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

`CertificateFinder` examples

`X500NameBuilder` examples

`X509Certificate2` extension-methods

`X509Certificate2Collection` extension-methods

`X509Chain` extension-methods

`X509Extension` extension-methods

`CertificateRequest` extension-methods