Openprovider API-toegang instellen

Stel een aparte Openprovider-gebruiker in zodat InfraNest kan koppelen — deze handleiding is voor iedereen die een Openprovider-account aan InfraNest koppelt voor domeinbeheer.

#Overzicht

• Openprovider geeft geen API-sleutels uit. In plaats daarvan meldt InfraNest zich aan als een van je Openprovider-gebruikers, dus wat je hier instelt is een gebruiker, geen sleutel.
• Er moeten vier dingen kloppen voordat die gebruiker kan koppelen. Mis je er één, dan meldt Openprovider dit vaak met dezelfde foutmelding als bij een verkeerd wachtwoord, waardoor je op het verkeerde spoor kunt komen.
• Als je de onderstaande controles op volgorde doorloopt, bespaar je tijd.

WarningJe eigen Openprovider-account heeft vrijwel zeker tweefactorauthenticatie ingeschakeld, en een gebruiker met tweefactorauthenticatie kan de API helemaal niet gebruiken. Maak altijd een aparte gebruiker aan voor InfraNest.

#Maak een aparte gebruiker voor InfraNest

1. Gebruik hiervoor niet je eigen inloggegevens. Als iemand het bedrijf verlaat, of als je je eigen wachtwoord wijzigt, kun je dat met een aparte gebruiker aanpassen zonder de koppeling te verbreken.
2. Ga in het Openprovider-controlepaneel naar Account.
3. Voeg een nieuwe gebruiker toe voor InfraNest.
4. Geef deze een wachtwoord dat je nergens anders hebt gebruikt — dit plak je straks in InfraNest.

#Schakel API-toegang in voor die gebruiker

Nieuwe gebruikers kunnen de API niet gebruiken totdat je dit toestaat.

1. Ga naar Account → Account Overview.
2. Zoek de gebruiker die je zojuist hebt aangemaakt en controleer de indicator API access. Groen betekent aan, rood betekent uit.
3. Is deze rood, selecteer dan de gebruikersnaam, kies Edit, vink API access Enabled aan en selecteer Update contact.

Deze instelling geldt per gebruiker. Hem inschakelen voor je eigen account schakelt hem niet in voor de nieuwe gebruiker.

#Stel geen 2FA in voor deze gebruiker

1. Laat tweefactorauthenticatie uitgeschakeld voor de InfraNest-gebruiker die je hebt aangemaakt.
2. Laat de tweefactorauthenticatie van je eigen account precies zoals die is — dit geldt alleen voor de nieuwe gebruiker.

Een gebruiker met tweefactorauthenticatie ingeschakeld kan nog steeds inloggen in het controlepaneel, maar kan geen API-token verkrijgen. De foutmelding van Openprovider noemt tweefactorauthenticatie niet rechtstreeks; InfraNest vertelt je simpelweg dat een instelling op het account de koppeling blokkeert.

#Sta ons IP-adres toe

Openprovider kan API-toegang beperken tot bepaalde adressen, en InfraNest koppelt altijd vanaf een vast adres.

1. Open de instellingen van dezelfde gebruiker en zoek de API white list.
2. Voeg het IP-adres toe dat InfraNest je toont op het verbindingsscherm, in de regel Allow this IP at the provider: …. Het is een IPv4-adres, en het is het adres waarmee InfraNest altijd verbinding maakt met Openprovider.

NoteOpenprovider houdt deze lijst per gebruiker en per toegangsniveau bij. Dat betekent dat je ons adres kunt toestaan voor de API, terwijl je eigen logins voor het controlepaneel beperkt blijven tot je kantoor.

Als de whitelist ons blokkeert, geeft Openprovider een andere foutmelding — "Access denied" in plaats van "Authentication/Authorization Failed" — en vertelt InfraNest je dat het om het IP-adres gaat en niet om het wachtwoord.

#Openprovider koppelen

1. Ga terug naar InfraNest.
2. Open Integraties.
3. Selecteer Openprovider.
4. Voer de gebruikersnaam en het wachtwoord in van de gebruiker die je hebt aangemaakt.

#Problemen oplossen

Als de koppeling nog steeds niet lukt, doorloop dan onderstaande punten op volgorde — dit zijn de vier oorzaken, van meest naar minst voorkomend:

1. API-toegang staat uit voor die gebruiker. Dit is de meest voorkomende oorzaak, omdat dit standaard uitstaat.
2. Tweefactorauthenticatie is ingesteld voor die gebruiker. Verwijder deze, of maak een gebruiker aan die dit nooit heeft gehad.
3. Ons IP-adres staat niet op de whitelist. Het advies van Openprovider zelf is om de whitelist volledig leeg te maken tot de koppeling werkt, en daarna weer adressen toe te voegen.
4. Het wachtwoord is onjuist. Dit is echt de minst waarschijnlijke van de vier.