AutoHttps.Route53
1.1.0
dotnet add package AutoHttps.Route53 --version 1.1.0
NuGet\Install-Package AutoHttps.Route53 -Version 1.1.0
<PackageReference Include="AutoHttps.Route53" Version="1.1.0" />
<PackageVersion Include="AutoHttps.Route53" Version="1.1.0" />
<PackageReference Include="AutoHttps.Route53" />
paket add AutoHttps.Route53 --version 1.1.0
#r "nuget: AutoHttps.Route53, 1.1.0"
#:package AutoHttps.Route53@1.1.0
#addin nuget:?package=AutoHttps.Route53&version=1.1.0
#tool nuget:?package=AutoHttps.Route53&version=1.1.0
AutoHttps.Route53
AWS Route 53 DNS provider for AutoHttps. It answers
dns-01 challenges, including wildcards, by publishing TXT records in a Route 53 hosted zone.
dotnet add package AutoHttps.Route53
Use
The provider needs permission to change resource record sets in the zone, and to list hosted zones if you let it find the zone from the record name:
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";
})
.UseRoute53();
Credentials and region follow the AWS SDK's usual resolution: environment variables, the shared config, or an instance role. Set them explicitly if you need to:
.UseRoute53(options =>
{
options.HostedZoneId = "Z123456ABCDEFG";
options.Region = "us-east-1";
options.AccessKeyId = builder.Configuration["Aws:AccessKeyId"];
options.SecretAccessKey = builder.Configuration["Aws:SecretAccessKey"];
});
Options
| Option | Default | What it does |
|---|---|---|
HostedZoneId |
(discovered) | The zone to publish in. Leave unset to find it from the record name. |
AccessKeyId / SecretAccessKey |
(default chain) | Explicit credentials. Set both or neither, because one without the other is refused at startup. |
Region |
(SDK default) | The region to sign for, for example us-east-1. |
RecordTtlSeconds |
60 | TTL for the challenge records. A record set that already exists keeps its own. |
Route 53 keeps every TXT value at a name in one record set, and a wildcard with its apex, or another
client ordering for the same name, puts more than one value at _acme-challenge. The provider adds its
value to whatever is there and later removes only that value, deleting the set only when nothing else
is left in it.
After publishing a value the provider waits, for up to two minutes, until Route 53 reports the change on
every name server for the zone (INSYNC). AWS says that generally takes under a minute, and asking for
validation before then can fail it.
A minimum policy grants route53:ChangeResourceRecordSets and route53:ListResourceRecordSets on the
hosted zone, route53:GetChange to wait for a change to apply, plus route53:ListHostedZonesByName
when the zone is discovered.
| 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.8.0)
- AWSSDK.Route53 (>= 4.0.100.12)
-
net8.0
- AutoHttps (>= 1.8.0)
- AWSSDK.Route53 (>= 4.0.100.12)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.