OVHcloud API-sleutels aanmaken

Gebruik deze handleiding als je InfraNest met OVHcloud wilt koppelen door zelf API-sleutels aan te maken voor domeinen, DNS of VPS-servers.

Overzicht

• Je hebt dit alleen nodig als Connect with OVHcloud niet wordt aangeboden op het verbindingsscherm. Is dat wel het geval, gebruik dat dan in plaats hiervan — het is sneller en er is niets te kopiëren of te vervangen.
• OVHcloud geeft je in één keer drie waarden: een Application Key, een Application Secret en een Consumer Key. Alle drie moeten in InfraNest worden ingevuld.

NoteHet instellen van Connect with OVHcloud zelf is een taak voor een beheerder, niet iets wat een klant doet — zie het onderdeel aan het einde van dit artikel. Een service-account is daarvoor niet het juiste middel.

De sleutels aanmaken

1. Ga naar de tokenpagina voor jouw regio — deze moet overeenkomen met de regio die je in InfraNest hebt gekozen:

   • Europa — eu.api.ovh.com/createToken
   • Canada / Azië-Pacific — ca.api.ovh.com/createToken
   • Verenigde Staten — api.us.ovhcloud.com/createToken

2. Meld je aan met je OVHcloud-account.

3. Vul een Script name in (bijvoorbeeld InfraNest) en een omschrijving, zodat je hem later herkent.

4. Zet Validity op Unlimited, tenzij je de sleutels zelf volgens een schema wilt vervangen.

5. Voeg onder Rights per onderstaande rij één regel toe. De link die InfraNest je geeft, opent deze pagina met elke rij al ingevuld, dus deze lijst dient om te controleren in plaats van zelf in te typen.

   Domeinen en DNS

   • GET /domain — Je domeinen weergeven
   • GET /domain/* — Gegevens van een domein, nameservers en DNS-zones lezen
   • POST /domain/* — Nameservers, contacten, DNSSEC wijzigen
   • PUT /domain/* — Overdrachtsslot, automatisch verlengen, DNS-records
   • DELETE /domain/* — DNS-records verwijderen

   Domeinen kopen en prijzen opvragen

   • POST /order/cart — Een prijs- of beschikbaarheidscontrole starten
   • POST /order/cart/* — Een domein registreren of overzetten
   • GET /order/cart/* — De prijzen uitlezen
   • DELETE /order/cart/* — De controle weer opruimen

   Servers (alleen als je VPS bij OVHcloud draait)

   • GET /vps — Je VPS'en weergeven
   • GET /vps/* — Een VPS, de IP-adressen en de back-ups lezen
   • POST /vps/* — Starten, stoppen, herstarten, opnieuw installeren, een snapshot maken
   • PUT /vps/* — Naam wijzigen, reverse DNS bewerken
   • DELETE /vps/* — Een snapshot verwijderen

   Buiten deze drie onderdelen is niets nodig — InfraNest vraagt nooit om toegang tot je account zelf.

   /domain en /domain/* zijn twee aparte regels — de * dekt alles onder /domain, maar niet /domain zelf. Sla je de eerste rij over, dan mislukt het weergeven van je domeinen met “This call has not been granted”, terwijl al het andere wel werkt. Hetzelfde geldt voor /order/cart en /vps, en daarom staan ze hierboven allebei twee keer.

   TipHeb je al een sleutel? Sleutels die zijn aangemaakt voordat domeinregistratie en VPS-ondersteuning werden toegevoegd, hebben de rijen POST /order/cart/* of DELETE /vps/* niet. Al het andere blijft werken, maar een domein kopen of een snapshot verwijderen mislukt met “This call has not been granted”. Maak via bovenstaande link een nieuwe set sleutels aan en plak die erin — er gaat niets verloren en er wordt hierdoor nooit een domein half gekocht.

6. Selecteer Create keys.

Plak ze in InfraNest

1. OVHcloud toont de drie waarden nu eenmalig. Kopieer elke waarde naar het bijbehorende veld op het InfraNest-verbindingsscherm:
   • Application Key → Application Key
   • Application Secret → Application Secret
   • Consumer Key → Consumer Key
2. Sluit je de pagina voordat je ze hebt gekopieerd, dan kun je ze niet meer terugvinden — maak een nieuwe set aan en verwijder de oude.

Goed om te weten

• De rechten die je verleent, zijn de rechten die InfraNest heeft. Voor DNS en domeinen zijn alleen de /domain/*-paden nodig. Verleen geen /*.
• Sleutels gelden per regio. Sleutels die zijn aangemaakt op de Europese pagina werken niet als de verbinding is ingesteld op Verenigde Staten.
• Om de toegang in te trekken, ga je in je OVHcloud-account naar API keys en verwijder je de vermelding. De verbinding in InfraNest begint dan foutmeldingen te geven, en dat is precies de bedoeling.

Problemen oplossen

• “Authentication failed” — controleer of de regio overeenkomt met waar je de sleutels hebt aangemaakt, en of alle drie de waarden zonder extra spaties zijn geplakt.
• Lezen werkt, maar wijzigen mislukt — waarschijnlijk heb je alleen GET verleend. Voeg POST, PUT en DELETE toe op /domain/*, of maak een nieuwe set sleutels met alle vier.

Voor beheerders: Connect with OVHcloud inschakelen

Dit onderdeel is voor degene die het InfraNest-platform beheert, en het is de stap waarbij OVHcloud's eigen documentatie het makkelijk maakt om iets fout te doen.

Een service-account werkt hiervoor niet. Het OVHcloud-configuratiescherm biedt service-accounts aan, die gebruikmaken van de CLIENT_CREDENTIALS-flow — ze authenticeren als zichzelf, machine-to-machine. Daarom krijg je bij een service-account wel een id en een wachtwoord, maar geen veld voor een callback-URL, en daarom zie je bij het doorsturen van een gebruiker een pagina “You are logged in as…” met een Customer Center-knop in plaats van een Allow-knop. Er is niets om goed te keuren, omdat niemand om toestemming wordt gevraagd.

Wat je nodig hebt is een OAuth2-client met de AUTHORIZATION_CODE-flow, die het configuratiescherm niet aanmaakt — die moet via de API worden gemaakt:

1. Open de API-console voor jouw regio — eu.api.ovh.com/console (of het ca- / us-equivalent).

2. Zoek POST /me/api/oauth2/client en selecteer Authenticate (een browseraanmelding; geen sleutels nodig).

3. Stuur:

   {
     "name": "InfraNest",
     "description": "InfraNest one-click connect",
     "flow": "AUTHORIZATION_CODE",
     "callbackUrls": ["https://your-infranest-url/api/provider-oauth/ovh/callback"]
   }
   

   De callback-URL moet exact overeenkomen met wat Admin Panel → Integrations → OVHcloud toont; daarnaast staat een Copy-knop.

4. Het antwoord bevat een clientId en een clientSecret. Het secret wordt eenmalig getoond.

5. Plak beide in het vak voor jouw regio in Admin Panel → Integrations → OVHcloud.

Elke regio is een apart platform, dus elke regio heeft zijn eigen client nodig, aangemaakt via zijn eigen console. Regio's die je leeg laat, blijven gewoon de API-sleutelmethode hierboven gebruiken.

Aan de kant van de klant is verder niets nodig. Het goedkeuren van de verbinding is voldoende — ze hoeven niet eerst een toegangsbeleid in OVHcloud in te stellen, en dat is nou net de reden waarom dit sneller is dan het aanmaken van sleutels.

WarningAls een verbinding slaagt, maar elke aanroep daarna mislukt met “User not granted for this request”, dan is de verbinding gemaakt voordat dit werd opgelost. Rechten worden bepaald op het moment dat iemand de verbinding goedkeurt, dus een oudere verbinding kan niet achteraf worden hersteld — koppel hem los en verbind opnieuw.