Openprovider-API-Zugang einrichten

Richte einen eigenen Openprovider-Benutzer ein, damit sich InfraNest verbinden kann — diese Anleitung richtet sich an alle, die ein Openprovider-Konto zur Domainverwaltung mit InfraNest verbinden.

#Überblick

• Openprovider stellt keine API-Schlüssel aus. Stattdessen meldet sich InfraNest als einer deiner Openprovider-Benutzer an — was du hier einrichtest, ist also ein Benutzer, kein Schlüssel.
• Vier Dinge müssen stimmen, bevor sich dieser Benutzer verbinden kann. Fehlt eines davon, meldet Openprovider das oft mit demselben Fehler wie bei einem falschen Passwort, was dich auf die falsche Fährte führen kann.
• Wenn du die folgenden Prüfungen der Reihe nach durchgehst, sparst du Zeit.

WarningBei deinem eigenen Openprovider-Konto ist mit ziemlicher Sicherheit die Zwei-Faktor-Authentifizierung aktiviert, und ein Benutzer mit Zwei-Faktor-Authentifizierung kann die API überhaupt nicht nutzen. Lege für InfraNest immer einen separaten Benutzer an.

#Einen separaten Benutzer für InfraNest anlegen

1. Verwende dafür nicht deinen eigenen Login. Wenn jemand das Unternehmen verlässt oder du dein eigenes Passwort änderst, kannst du das dank eines separaten Benutzers tun, ohne die Verbindung zu unterbrechen.
2. Gehe im Openprovider-Kontrollpanel zu Account.
3. Füge einen neuen Benutzer für InfraNest hinzu.
4. Vergib ein Passwort, das du nirgendwo sonst verwendet hast — du fügst es gleich in InfraNest ein.

#API-Zugriff für diesen Benutzer aktivieren

Neue Benutzer können die API erst nutzen, wenn du das erlaubst.

1. Gehe zu Account → Account Overview.
2. Suche den gerade erstellten Benutzer und prüfe die Anzeige API access. Grün bedeutet an, rot bedeutet aus.
3. Ist sie rot, wähle den Benutzernamen aus, klicke auf Edit, hake API access Enabled an und wähle Update contact.

Diese Einstellung gilt pro Benutzer. Sie für dein eigenes Konto zu aktivieren, schaltet sie nicht automatisch auch für den neuen Benutzer ein.

#Für diesen Benutzer keine 2FA einrichten

1. Lass die Zwei-Faktor-Authentifizierung für den von dir angelegten InfraNest-Benutzer ausgeschaltet.
2. Lass die Zwei-Faktor-Authentifizierung deines eigenen Kontos unverändert — das gilt nur für den neuen Benutzer.

Ein Benutzer mit aktivierter Zwei-Faktor-Authentifizierung kann sich zwar weiterhin im Kontrollpanel anmelden, aber kein API-Token erhalten. Der Fehler von Openprovider erwähnt die Zwei-Faktor-Authentifizierung nicht direkt; InfraNest teilt dir lediglich mit, dass eine Kontoeinstellung die Verbindung blockiert.

#Unsere IP-Adresse zulassen

Openprovider kann den API-Zugriff auf bestimmte Adressen beschränken, und InfraNest verbindet sich stets von einer festen Adresse aus.

1. Öffne die Einstellungen desselben Benutzers und suche die API white list.
2. Füge die IP-Adresse hinzu, die dir InfraNest auf dem Verbindungsbildschirm in der Zeile Allow this IP at the provider: … anzeigt. Es handelt sich um eine IPv4-Adresse, von der aus sich InfraNest stets mit Openprovider verbindet.

NoteOpenprovider führt diese Liste pro Benutzer und pro Zugriffsebene. Das bedeutet, du kannst unsere Adresse für die API zulassen, während deine eigenen Kontrollpanel-Logins weiterhin auf dein Büro beschränkt bleiben.

Wenn die Whitelist uns blockiert, gibt Openprovider einen anderen Fehler zurück — „Access denied“ statt „Authentication/Authorization Failed“ — und InfraNest weist dich dann auf die IP-Adresse statt auf das Passwort hin.

#Openprovider verbinden

1. Gehe zurück zu InfraNest.
2. Öffne Integrationen.
3. Wähle Openprovider.
4. Gib den Benutzernamen und das Passwort des von dir angelegten Benutzers ein.

#Fehlerbehebung

Wenn die Verbindung weiterhin nicht zustande kommt, gehe diese Punkte der Reihe nach durch — es sind die vier häufigsten Ursachen, beginnend mit der wahrscheinlichsten:

1. API-Zugriff ist aus für diesen Benutzer. Das ist die häufigste Ursache, da er standardmäßig deaktiviert ist.
2. Zwei-Faktor-Authentifizierung ist eingerichtet für diesen Benutzer. Entferne sie oder lege einen Benutzer an, der sie nie hatte.
3. Unsere IP-Adresse steht nicht auf der Whitelist. Openprovider selbst empfiehlt, die Whitelist komplett zu leeren, bis die Verbindung funktioniert, und die Adressen danach wieder hinzuzufügen.
4. Das Passwort ist falsch. Das ist von den vieren wirklich die unwahrscheinlichste Ursache.