OVHcloud-API-Schlüssel erstellen

Erstelle den Application Key, das Application Secret und den Consumer Key, mit denen InfraNest deine OVHcloud-Domains, DNS-Einträge und Server verwalten kann. Dies ist für alle, die ein OVHcloud-Konto von Hand mit InfraNest verbinden.

#Überblick

• OVHcloud gibt dir drei Werte auf einmal — einen Application Key, ein Application Secret und einen Consumer Key — und alle drei kommen in InfraNest.
• Du musst das nur tun, wenn Connect with OVHcloud auf dem Verbindungsbildschirm nicht angeboten wird. Wenn es angeboten wird, nutze es stattdessen — es geht schneller und es gibt nichts zu kopieren oder zu rotieren.

NoteDie Einrichtung von Connect with OVHcloud selbst ist eine Aufgabe für Administratoren, nicht für Kunden — siehe das Ende dieses Artikels. Ein Service-Account ist dafür nicht das Richtige.

#Die Schlüssel erstellen

1. Rufe die Token-Seite für deine Region auf — diese muss zu der Region passen, die du in InfraNest ausgewählt hast:

   • Europa — eu.api.ovh.com/createToken
   • Kanada / Asien-Pazifik — ca.api.ovh.com/createToken
   • Vereinigte Staaten — api.us.ovhcloud.com/createToken

2. Melde dich mit deinem OVHcloud-Konto an.

3. Trage einen Script name ein (zum Beispiel InfraNest) sowie eine Beschreibung, damit du ihn später wiedererkennst.

4. Setze Validity auf Unlimited, außer du möchtest die Schlüssel selbst nach einem Zeitplan rotieren.

5. Füge unter Rights die benötigten Zeilen hinzu. Der Link, den dir InfraNest gibt, öffnet diese Seite mit bereits ausgefüllten Zeilen:

   • Domains und DNS: GET /domain, GET /domain/*, POST /domain/*, PUT /domain/*, DELETE /domain/*
   • Domains kaufen und Preise abrufen: POST /order/cart, POST /order/cart/*, GET /order/cart/*, DELETE /order/cart/*
   • Server (nur wenn du VPS bei OVHcloud betreibst): GET /vps, GET /vps/*, POST /vps/*, PUT /vps/*, DELETE /vps/*

   Note/domain und /domain/* sind zwei getrennte Regeln — das * deckt alles unterhalb von /domain ab, aber nicht /domain selbst. Fehlt die erste Zeile, schlägt das Auflisten deiner Domains fehl, während alles andere funktioniert. Dasselbe gilt für /order/cart und /vps, weshalb beide oben jeweils zweimal auftauchen.

6. Wähle Create keys.

#In InfraNest einfügen

1. OVHcloud zeigt die drei Werte einmalig an. Kopiere jeden in das passende Feld auf dem InfraNest-Verbindungsbildschirm:
   • Application Key → Application Key
   • Application Secret → Application Secret
   • Consumer Key → Consumer Key
2. Schließt du die Seite, bevor du sie kopiert hast, kannst du sie nicht wiederherstellen — erstelle einen neuen Satz und lösche den alten.

#Tipps

TipHast du bereits einen Schlüssel? Schlüssel, die vor der Einführung von Domainregistrierung und VPS-Unterstützung erstellt wurden, haben weder die Zeile POST /order/cart/* noch irgendeine /vps-Zeile. DNS und Domains funktionieren weiterhin, aber der Kauf einer Domain schlägt fehl, und die Verbindung kann für Cloud erst genutzt werden, wenn sie Schlüssel mit den /vps-Zeilen hat. Erstelle über den obigen Link einen neuen Satz und füge ihn ein — es geht nichts verloren.

• Die Rechte, die du gewährst, sind die Rechte, die InfraNest hat. Gewähre nicht /*.
• Schlüssel gelten pro Region. Auf der europäischen Seite erstellte Schlüssel funktionieren nicht, wenn die Verbindung auf Vereinigte Staaten eingestellt ist.
• Um den Zugriff zu widerrufen, gehe in deinem OVHcloud-Konto zu API keys und lösche den Eintrag. Die Verbindung in InfraNest meldet dann Fehler — das ist gewollt.

#Fehlerbehebung

• „Authentication failed“ — prüfe, ob die Region mit der übereinstimmt, in der du die Schlüssel erstellt hast, und ob alle drei Werte ohne überzählige Leerzeichen eingefügt wurden.
• Lesen funktioniert, Änderungen schlagen fehl — wahrscheinlich hast du nur GET gewährt. Erstelle über den Link einen neuen Satz Schlüssel mit allen vier Methoden auf /domain/* (und auf /vps/* für Serveraktionen).

#Für Administratoren: „Connect with OVHcloud“ aktivieren

Dieser Teil richtet sich an diejenigen, die die InfraNest-Plattform betreiben.

Ein Service-Account funktioniert hier nicht. Das OVHcloud-Kontrollzentrum bietet Service-Accounts an, die sich Maschine-zu-Maschine authentifizieren und kein Feld für eine Callback-URL haben — schickt man einen Benutzer zu einem solchen, erscheint eine Seite „You are logged in as…“ mit einer Customer-Center-Schaltfläche statt einer Allow-Schaltfläche, weil niemand um Erlaubnis gefragt wird.

Was du brauchst, ist ein OAuth2-Client mit dem Authorization-Code-Flow, den das Kontrollzentrum nicht erstellt — er muss über die API angelegt werden:

1. Öffne die API-Konsole für deine Region — eu.api.ovh.com/console (oder das ca- bzw. us-Äquivalent).
2. Suche POST /me/api/oauth2/client und wähle Authenticate (eine Browser-Anmeldung; keine Schlüssel nötig).
3. Sende eine Anfrage, die den Client benennt, beschreibt, den Flow auf AUTHORIZATION_CODE setzt und die Callback-URL angibt, die unter Admin → Integrationen → OVHcloud angezeigt wird (daneben befindet sich eine Schaltfläche zum Kopieren).
4. Die Antwort enthält eine clientId und ein clientSecret. Das Secret wird einmalig angezeigt.
5. Füge beides in den Slot für deine Region unter Admin → Integrationen → OVHcloud ein.

Jede Region ist eine eigene Plattform, daher braucht sie einen eigenen, auf ihrer eigenen Konsole erstellten Client. Regionen, die du leer lässt, verwenden einfach weiterhin die oben beschriebene API-Schlüssel-Methode.

Auf Kundenseite ist sonst nichts weiter nötig — das Bestätigen der Verbindung reicht aus.

WarningWenn eine Verbindung erfolgreich hergestellt wird, aber jeder Aufruf danach mit „User not granted for this request“ fehlschlägt, wurde die Verbindung erstellt, bevor dies behoben wurde. Berechtigungen werden in dem Moment festgelegt, in dem jemand die Verbindung bestätigt, daher kann eine ältere Verbindung nicht nachträglich repariert werden — trenne sie und verbinde erneut.