How To Use the GoDaddy DNS Plugin¶
This plugin works against the GoDaddy DNS provider. It is assumed that you have already setup an account and created the DNS zone(s) you will be working against.
Warning
From April 2024 GoDaddy have introduced API account limits which prevent DNS API access for customers with less than 10 domains on their account. Existing accounts that don't meet the new requirements will now receive an Access Denied error when communicating with the API.
Setup¶
We need to generate an API key for the production GoDaddy environment.
- Click
Create New API Key
- Name: Posh-ACME
- Environment: Production
- Click
Next
- Copy the resulting key and secret strings somewhere safe. There's no way to retrieve the secret once you leave this page. You would have to delete the old one and create a new one.
Using the Plugin¶
The Key is used with the GDKey
string parameter and the Secret is used with the GDSecretSecure
SecureString parameter.
Warning
The GDSecret
parameter is deprecated and will be removed in the next major module version. If you are using it, please migrate to the Secure parameter set.
$pArgs = @{
GDKey = 'xxxxxxxxxxxxxxxx'
GDSecret = (Read-Host 'Secret' -AsSecureString)
}
New-PACertificate example.com -Plugin GoDaddy -PluginArgs $pArgs