Skip to content
DocsTry Aspire
DocsTry

CertificateAuthorityCollectionResourceExtensions Methods

ClassMethods6 members
Provides extension methods for CertificateAuthorityCollection.
AddCertificateAuthorityCollection(IDistributedApplicationBuilder, string)Section titled AddCertificateAuthorityCollection(IDistributedApplicationBuilder, string)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds a new CertificateAuthorityCollection to the application model. This resource is intended for local development run time configuration and is excluded from published artifacts.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> AddCertificateAuthorityCollection(
this IDistributedApplicationBuilder builder,
string name)
{
// ...
}
}
namestringThe name of the certificate authority collection resource.
IResourceBuilder<CertificateAuthorityCollection>An ApplicationModel.IResourceBuilder`1 instance.
This method is not available in polyglot app hosts.
WithCertificate(IResourceBuilder<CertificateAuthorityCollection>, X509Certificate2)Section titled WithCertificate(IResourceBuilder<CertificateAuthorityCollection>, X509Certificate2)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds a certificate to the CertificateAuthorityCollection.Certificates collection.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> WithCertificate(
this IResourceBuilder<CertificateAuthorityCollection> builder,
X509Certificate2 certificate)
{
// ...
}
}
builderIResourceBuilder<CertificateAuthorityCollection>The ApplicationModel.IResourceBuilder`1.
certificateX509Certificate2The certificate to add.
IResourceBuilder<CertificateAuthorityCollection>The updated ApplicationModel.IResourceBuilder`1.
This method is not available in polyglot app hosts.
WithCertificates(IResourceBuilder<CertificateAuthorityCollection>, X509Certificate2Collection)Section titled WithCertificates(IResourceBuilder<CertificateAuthorityCollection>, X509Certificate2Collection)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds a collection of certificates to the CertificateAuthorityCollection.Certificates collection.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> WithCertificates(
this IResourceBuilder<CertificateAuthorityCollection> builder,
X509Certificate2Collection certificates)
{
// ...
}
}
builderIResourceBuilder<CertificateAuthorityCollection>The ApplicationModel.IResourceBuilder`1.
certificatesX509Certificate2CollectionThe collection of certificates to add.
IResourceBuilder<CertificateAuthorityCollection>The updated ApplicationModel.IResourceBuilder`1.
This method is not available in polyglot app hosts.
WithCertificates(IResourceBuilder<CertificateAuthorityCollection>, IEnumerable<X509Certificate2>)Section titled WithCertificates(IResourceBuilder<CertificateAuthorityCollection>, IEnumerable<X509Certificate2>)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds a collection of certificates to the CertificateAuthorityCollection.Certificates collection.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> WithCertificates(
this IResourceBuilder<CertificateAuthorityCollection> builder,
IEnumerable<X509Certificate2> certificates)
{
// ...
}
}
builderIResourceBuilder<CertificateAuthorityCollection>The ApplicationModel.IResourceBuilder`1.
certificatesIEnumerable<X509Certificate2>The collection of certificates to add.
IResourceBuilder<CertificateAuthorityCollection>The updated ApplicationModel.IResourceBuilder`1.
This method is not available in polyglot app hosts.
WithCertificatesFromFile(IResourceBuilder<CertificateAuthorityCollection>, string, Func<X509Certificate2, bool>)Section titled WithCertificatesFromFile(IResourceBuilder<CertificateAuthorityCollection>, string, Func<X509Certificate2, bool>)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds certificates from a PEM file to the CertificateAuthorityCollection.Certificates collection.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> WithCertificatesFromFile(
this IResourceBuilder<CertificateAuthorityCollection> builder,
string pemFilePath,
Func<X509Certificate2, bool>? filter = null)
{
// ...
}
}
builderIResourceBuilder<CertificateAuthorityCollection>The ApplicationModel.IResourceBuilder`1.
pemFilePathstringThe path to the PEM file.
filterFunc<X509Certificate2, bool>optionalAn optional filter to apply to the loaded certificates before they are added to the collection.
IResourceBuilder<CertificateAuthorityCollection>The updated ApplicationModel.IResourceBuilder`1.

This method is not available in polyglot app hosts.

This example adds certificates from a PEM file located at "../path/to/certificates.pem".
builder.AddCertificateAuthorityCollection("my-ca")
.WithCertificatesFromFile("../path/to/certificates.pem");
This example adds only certificates that are not expired from a PEM file located at "../path/to/certificates.pem".
builder.AddCertificateAuthorityCollection("my-ca")
.WithCertificatesFromFile(
"../path/to/certificates.pem",
c => c.NotAfter > DateTime.UtcNow);
WithCertificatesFromStore(IResourceBuilder<CertificateAuthorityCollection>, StoreName, StoreLocation, Func<X509Certificate2, bool>)Section titled WithCertificatesFromStore(IResourceBuilder<CertificateAuthorityCollection>, StoreName, StoreLocation, Func<X509Certificate2, bool>)extensionIResourceBuilder<CertificateAuthorityCollection>
Adds certificates from a certificate store to the CertificateAuthorityCollection.Certificates collection.
public static class CertificateAuthorityCollectionResourceExtensions
{
public static IResourceBuilder<CertificateAuthorityCollection> WithCertificatesFromStore(
this IResourceBuilder<CertificateAuthorityCollection> builder,
StoreName storeName,
StoreLocation storeLocation,
Func<X509Certificate2, bool>? filter = null)
{
// ...
}
}
builderIResourceBuilder<CertificateAuthorityCollection>The ApplicationModel.IResourceBuilder`1.
storeNameStoreNameThe name of the certificate store.
storeLocationStoreLocationThe location of the certificate store.
filterFunc<X509Certificate2, bool>optionalAn optional filter to apply to the certificates.
IResourceBuilder<CertificateAuthorityCollection>The updated ApplicationModel.IResourceBuilder`1.

This method is not available in polyglot app hosts.

This example adds all certificates from the "Root" store in the "LocalMachine" location.
builder.AddCertificateAuthorityCollection("my-ca")
.WithCertificatesFromStore(StoreName.Root, StoreLocation.LocalMachine);
This example adds only certificates that are not expired from the "My" store in the "CurrentUser" location.
builder.AddCertificateAuthorityCollection("my-ca")
.WithCertificatesFromStore(
StoreName.My,
StoreLocation.CurrentUser,
c => c.NotAfter > DateTime.UtcNow);