AutoHttps.Azure
1.0.1
dotnet add package AutoHttps.Azure --version 1.0.1
NuGet\Install-Package AutoHttps.Azure -Version 1.0.1
<PackageReference Include="AutoHttps.Azure" Version="1.0.1" />
<PackageVersion Include="AutoHttps.Azure" Version="1.0.1" />
<PackageReference Include="AutoHttps.Azure" />
paket add AutoHttps.Azure --version 1.0.1
#r "nuget: AutoHttps.Azure, 1.0.1"
#:package AutoHttps.Azure@1.0.1
#addin nuget:?package=AutoHttps.Azure&version=1.0.1
#tool nuget:?package=AutoHttps.Azure&version=1.0.1
AutoHttps.Azure
Azure support for AutoHttps: dns-01 challenges through
Azure DNS, and certificate and account key storage in Key Vault. Use either part, or both.
dotnet add package AutoHttps.Azure
DNS challenges through Azure DNS
Every validated domain must live in the configured zone.
builder.Services.AddAutoHttps(options =>
{
options.DomainNames.Add("*.example.com");
options.DomainNames.Add("example.com");
options.EmailAddress = "admin@example.com";
options.AcceptTermsOfService = true;
options.PreferredChallengeType = "dns-01";
})
.UseAzureDns(dns =>
{
dns.SubscriptionId = "00000000-0000-0000-0000-000000000000";
dns.ResourceGroupName = "dns-rg";
dns.ZoneName = "example.com";
});
Storage in Key Vault
builder.Services.AddAutoHttps(options => { /* ... */ })
.UseAzureKeyVault(vault => vault.VaultUri = new Uri("https://myvault.vault.azure.net/"));
Certificates and the account key are stored as secrets. Key Vault names allow only letters, digits and hyphens, so each store identifier becomes a sanitised name with a hash of the original appended, which keeps distinct identifiers from colliding.
Credentials
Both parts use DefaultAzureCredential by default, which resolves a managed identity, environment
variables, or the Azure CLI. Set TenantId, ClientId and ClientSecret on the options to use a
service principal instead. The identity needs DNS Zone Contributor on the zone, and Key Vault Secrets
Officer on the vault.
Options
AzureDnsOptions: SubscriptionId, ResourceGroupName, ZoneName (all required), RecordTtlSeconds
(default 60), and the credential fields.
AzureKeyVaultOptions: VaultUri (required), SecretPrefix (default autohttps-), and the credential
fields. SecretPrefix may contain only letters, digits and hyphens and is at most 30 characters, so
the Key Vault secret name stays within its 127-character limit; both are checked at startup.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. 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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AutoHttps (>= 1.4.0)
- Azure.Identity (>= 1.21.0)
- Azure.ResourceManager.Dns (>= 1.1.1)
- Azure.Security.KeyVault.Secrets (>= 4.11.1)
-
net8.0
- AutoHttps (>= 1.4.0)
- Azure.Identity (>= 1.21.0)
- Azure.ResourceManager.Dns (>= 1.1.1)
- Azure.Security.KeyVault.Secrets (>= 4.11.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.