OVHcloud API-sleutels aanmaken

Maak de Application Key, Application Secret en Consumer Key aan waarmee InfraNest je OVHcloud-domeinen, DNS en servers kan beheren. Dit is bedoeld voor iedereen die een OVHcloud-account handmatig aan InfraNest koppelt.

#Overzicht

• OVHcloud geeft je drie waarden tegelijk — een Application Key, een Application Secret en een Consumer Key — en alle drie gaan in InfraNest.
• Je hoeft dit alleen te doen als Connect with OVHcloud niet wordt aangeboden op het koppelingsscherm. Is dat wel het geval, gebruik dat dan in plaats hiervan — het is sneller en er hoeft niets gekopieerd of vervangen te worden.

NoteHet instellen van Connect with OVHcloud zelf is een taak voor een beheerder, niet voor een klant — zie het einde van dit artikel. Een service-account is niet geschikt hiervoor.

#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 scriptnaam in (bijvoorbeeld InfraNest) en een omschrijving, zodat je hem later herkent.

4. Zet Geldigheid op Onbeperkt, tenzij je de sleutels zelf periodiek wilt vervangen.

5. Voeg onder Rechten de vereiste regels toe. De link die InfraNest je geeft, opent deze pagina met alle regels al ingevuld:

   • Domeinen en DNS: GET /domain, GET /domain/*, POST /domain/*, PUT /domain/*, DELETE /domain/*
   • Domeinen kopen en prijzen opvragen: POST /order/cart, POST /order/cart/*, GET /order/cart/*, DELETE /order/cart/*
   • Servers (alleen als je VPS'en draait bij OVHcloud): GET /vps, GET /vps/*, POST /vps/*, PUT /vps/*, DELETE /vps/*

   Note/domain en /domain/* zijn twee aparte regels — de * dekt alles onder /domain, maar niet /domain zelf. Mis je de eerste regel, dan mislukt het weergeven van je domeinen terwijl al het andere wel werkt. Hetzelfde geldt voor /order/cart en /vps, vandaar dat beide hierboven twee keer voorkomen.

6. Selecteer Create keys.

#Kopiëren naar InfraNest

1. OVHcloud toont de drie waarden eenmalig. Kopieer elke waarde naar het bijbehorende veld op het InfraNest-koppelingsscherm:
   • 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 dan een nieuwe set aan en verwijder de oude.

#Tips

TipHeb je al een sleutel? Sleutels die zijn aangemaakt vóórdat domeinregistratie en VPS-ondersteuning werden toegevoegd, hebben geen POST /order/cart/*-regel of /vps-regels. DNS en domeinen blijven werken, maar het kopen van een domein mislukt, en de koppeling kan niet voor Cloud worden gebruikt totdat er sleutels zijn met de /vps-regels. Maak een nieuwe set aan via de link hierboven en plak deze — er gaat niets verloren.

• De rechten die je verleent, zijn de rechten die InfraNest heeft. Verleen geen /*.
• Sleutels gelden per regio. Sleutels die zijn aangemaakt op de Europese pagina werken niet als de koppeling is ingesteld op Verenigde Staten.
• Om de toegang in te trekken, ga je in je OVHcloud-account naar API-sleutels en verwijder je de vermelding. De koppeling in InfraNest zal dan foutmeldingen gaan 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 zijn geplakt zonder overbodige spaties.
• Lezen werkt, maar wijzigingen mislukken — waarschijnlijk heb je alleen GET verleend. Maak via de link een nieuwe set sleutels aan met alle vier de methoden op /domain/* (en op /vps/* voor serveracties).

#Voor beheerders: "Connect with OVHcloud" inschakelen

Dit onderdeel is bedoeld voor degene die het InfraNest-platform beheert.

Een service-account werkt niet. Het OVHcloud-configuratiescherm biedt service-accounts aan, die machine-tot-machine authenticeren en geen veld hebben voor een callback-URL — stuur je een gebruiker naar zo'n account, dan verschijnt een pagina "You are logged in as…" met een Customer Center-knop in plaats van een Allow-knop, omdat er niemand om toestemming wordt gevraagd.

Wat je nodig hebt, is een OAuth2-client die gebruikmaakt van de authorization-code flow, die het configuratiescherm niet aanmaakt — dit moet via de API worden gedaan:

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 een verzoek waarin je de client benoemt, omschrijft, de flow instelt op AUTHORIZATION_CODE, en de callback-URL opgeeft die te zien is bij Beheerpaneel → Integraties → OVHcloud (er staat een kopieerknop naast).
4. Het antwoord bevat een clientId en een clientSecret. Het secret wordt eenmalig getoond.
5. Plak beide in het veld voor jouw regio bij Beheerpaneel → Integraties → OVHcloud.

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

Aan de kant van de klant is verder niets nodig — het goedkeuren van de koppeling is voldoende.

WarningAls een koppeling slaagt maar elke aanroep daarna mislukt met "User not granted for this request", dan is de koppeling tot stand gekomen vóórdat dit werd opgelost. Rechten worden bepaald op het moment dat iemand de koppeling goedkeurt, dus een oudere koppeling kan niet ter plekke worden hersteld — koppel hem los en verbind opnieuw.