AutoHttps

Automatic HTTPS for ASP.NET Core

AutoHttps is a robust library designed to simplify the management of TLS certificates within ASP.NET Core applications. It securely obtains and renews certificates from Let's Encrypt or any compliant ACME certificate authority, all without the need for external dependencies.

Key Features

• Comprehensive Setup: With a simple installation of the library, applications can automatically handle certificate procurement and renewal with minimal configuration.

builder.Services.AddAutoHttps(options =>
{
    options.DomainNames.Add("example.com");
    options.EmailAddress = "admin@example.com";
    options.AcceptTermsOfService = true;
});

• No External Dependencies: AutoHttps is designed to utilize the ASP.NET Core shared framework exclusively, ensuring that everything required for seamless operation is bundled within the application itself.

Modern Standards Compliance

AutoHttps stays up-to-date with the evolving landscape of certificate management, adhering to the latest standards:

• RFC 9773 compliance for ACME Renewal Information, allowing for precise control over renewal schedules based on guidance from the certificate authority.
• Support for short-lived certificates (six-day certificates) to align with security best practices.

Supported Features

Configuration Options

The AutoHttps library provides various optional configurations to meet different application needs:

builder.Services.AddAutoHttps(options =>
{
    options.DomainNames.Add("example.com");
    options.EmailAddress = "admin@example.com";
    options.AcceptTermsOfService = true;
    options.StorageDirectory = "/var/lib/myapp/certs";
    // Additional configurations as needed
});

The library can also be configured via standard application settings in JSON format, streamlining integration with existing configuration management.

Health Checks and Metrics

To ensure reliable certificate issuance and renewal, AutoHttps offers:

• Health checks to report on the status of the current certificates, aiding in the detection of failed renewals or expirations.
• Metrics reporting on certificate expiry and renewal counts to allow for better monitoring and alerting configurations.

Conclusion

AutoHttps provides a comprehensive solution for managing TLS certificates in ASP.NET Core applications efficiently, allowing developers to focus on building functionalities rather than handling certificate logistics. Its adherence to modern standards and ease of configuration ensures a secure and reliable deployment setup.