How To Use the Infomaniak DNS Plugin

This plugin works against the Infomaniak DNS provider using version 1 of their API. It is assumed that you have already setup an account and created the DNS zone(s) you will be working against.

Note

Infomaniak now documents version 2 of their API, which is served by the InfomaniakV2 plugin. This plugin continues to work, but new deployments should prefer InfomaniakV2. Switching requires a new API token with the dns:read and dns:write scopes, because the v2 endpoints reject tokens that only carry the Domain scope this guide asks for.

Setup

You will need to generate an API Token if you haven't already done so. Go to Manage API tokens after logging in to the Management Console. Create a new token with the scope Domain. Set the expiration time to your preference. Make a note of the token value as you'll need it later and won't be able to retrieve it after this point.

Note

If the token gets invalidated before a renewal is submitted, a new token has to be created and the order has to be updated.

Using the Plugin

You will need to provide the API Token as a SecureString value to InfomaniakToken.

Warning

The InfomaniakTokenInsecure 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 = @{
    InfomaniakToken = (Read-Host "Infomaniak Token" -AsSecureString)
}
New-PACertificate example.com -Plugin Infomaniak -PluginArgs $pArgs