Skip to content

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