How To Use the Namecheap DNS Plugin¶
This plugin works against the Namecheap FreeDNS provider. It is assumed that you have already setup an account and registered the domains you will be working against. The domains must not be using custom DNS servers.
Setup¶
First, login to your account and go to the Profile - Tools page. In the "Business & Dev Tools" section, API Access must be turned on. Namecheap seems to require a certain amount of activity (registered domains or money spent) in order to enable API Access. Turning it on requires Namecheap support to authorize and actually enable which can take a couple days.
Once API Access is turned on, click the Manage button and record your API Key
value and your Namecheap username. You will also need to whitelist the public IP address of each machine you will be running Posh-ACME from. whatsmyip.com can help here if you're behind a NAT router.
Using the Plugin¶
The username is used with the NCUsername
parameter and the API key is used with the NCApiKey
SecureString parameter.
Warning
The NCApiKeyInsecure
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 = @{
NCUsername = 'myusername'
NCApiKey = (Read-Host 'API Key' -AsSecureString)
}
New-PACertificate example.com -Plugin Namecheap -PluginArgs $pArgs