Skip to content

How To Use the Zonomi DNS Plugin

This plugin works against the Zonomi DNS provider. It is assumed that you have already setup an account and created the DNS zone(s) you will be working against.

Note

The API Zonomi uses is also used by other providers such as RimuHosting. This plugin is compatible with those as well.

Setup

Generate an API key from the API Keys page using the "DNS" type. Click the the green plus icon to generate a new key if one is not already displayed.

If you use a different compatible provider, there should be an equivalent control panel page for API Keys available.

Using the Plugin

The API key is used with the ZonomiKey SecureString parameter. Users on other Zonomi compatible providers will also need to supply the API URL for that provider to the ZonomiApiUrl parameter.

Warning

The ZonomiApiKey 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.

Using Zonomi

$pArgs = @{
    ZonomiKey = (Read-Host 'API Key' -AsSecureString)
}
New-PACertificate example.com -Plugin Zonomi -PluginArgs $pArgs

Using RimuHosting

$pArgs = @{
    ZonomiKey = (Read-Host 'API Key' -AsSecureString)
    ZonomiApiUrl = 'https://rimuhosting.com/dns/dyndns.jsp'
}
New-PACertificate example.com -Plugin Zonomi -PluginArgs $pArgs