OVHcloud provider
local-cert manages OVHcloud DNS zones through the OVH API, using a set of three keys limited to DNS.
1. Create the token
OVH offers a page that creates all three keys at once. Open the one for your region while logged in to your account:
| Account | Creation page | Value of "API region" |
|---|---|---|
| Europe | https://eu.api.ovh.com/createToken/ | ovh-eu |
| Canada | https://ca.api.ovh.com/createToken/ | ovh-ca |
| United States | https://api.us.ovhcloud.com/createToken/ | ovh-us |
- Application name:
local-cert. Free-form description. - Validity: Unlimited. A token with a limited lifetime would stop working without warning, renewals included.
- Rights: add these five lines (the link offered by local-cert's wizard pre-fills them):
Rights to grant
GET /domain/zone
GET /domain/zone/*
POST /domain/zone/*
PUT /domain/zone/*
DELETE /domain/zone/*- Create keys. The page shows the Application Key, the Application Secret and the Consumer Key: note all three.
2. Create the provider
- Providers → + New provider → OVHcloud.
- Choose the region, give it a name, paste the three keys.
- Test connection: local-cert lists your zones. Then Save.
3. Add a domain
Domains → + Add a domain → this provider → the zone. The test creates and then deletes a temporary TXT record. No extra setting is needed on the OVH side: the permissions are those of the token.
Good to know
- The domain must use OVH's DNS servers (active DNS zone in the customer area). If its name servers point elsewhere, that other host is the one to declare.
- OVH only applies a change after a zone "refresh"; local-cert triggers one after every write. Propagation to the secondary servers can take one to two minutes: that is the normal duration of an issuance.
- Minimum TTL: 60 seconds.
Troubleshooting
| Message | Cause |
|---|---|
Invalid signature | Application Secret or Consumer Key mistyped, or wrong region. |
This credential is not valid | Consumer Key expired or revoked: create a new token with unlimited validity. |
This call has not been granted | A line is missing from the token's rights. |
This application key is invalid | Application Key from another region. |