Een NameSilo API-sleutel ophalen

NameSilo gebruikt een API-sleutel en niets anders. Geen secret, geen schakelaar per domein. Twee dingen zijn belangrijk: je kunt de sleutel later niet terugzien, en de IP-beperking kan DNSense buitensluiten.

De sleutel genereren

1. Log in bij NameSilo en open de API Manager via je accountmenu.

2. Vink Generate New API Key aan, accepteer de API-voorwaarden en klik op Submit. Een nieuwe sleutel zet de vorige buiten werking, dus alles wat de oude sleutel gebruikt, stopt met werken.
3. Kopieer de sleutel meteen. NameSilo toont hem een keer en kan hem niet opnieuw tonen. Raak je hem kwijt, dan genereer je een nieuwe.

Biedt het formulier een alleen-lezen-optie, laat die dan uitgevinkt. DNSense moet records kunnen schrijven, en met een alleen-lezen-sleutel werkt de verbinding niet.

Wel of niet beperken op IP-adres

De API Manager accepteert maximaal vijf IP-adressen. Laat je alle velden leeg, dan werkt de sleutel vanaf elk adres. Vul je er een in, dan weigert NameSilo aanroepen van overal anders, en kan DNSense niet meer verbinden. Beperken is veiliger, maar alleen als je het adres toevoegt waarmee DNSense aanroept. Twijfel je, laat de velden dan leeg en houd de sleutel geheim.

NameSilo logt elke API-actie in de domeingeschiedenis, zodat je kunt zien wat er is gewijzigd.

Koppelen aan DNSense

Voeg een koppeling toe, kies NameSilo en plak de sleutel in het veld API key. Elk domein van het account verschijnt als zone.

Wat je kunt verwachten

• Ondersteunde types: A, AAAA, CNAME, MX en TXT. De DNS-endpoints van NameSilo nemen niets anders aan, dus SRV, CAA en TLSA zijn hier niet beschikbaar.
• TTL. Houd TTL's op een uur (3600 seconden) of hoger. De documentatie van NameSilo noemt de grenzen niet uitdrukkelijk, dus DNSense kiest de veilige kant.
• Een rustig tempo. NameSilo publiceert geen rate limit, dus DNSense controleert deze koppeling minder vaak op afwijkingen dan de meeste andere. Wijzigingen die je in DNSense maakt worden direct doorgezet.
• Typewijzigingen. NameSilo kan het type van een record niet ter plekke wijzigen, dus DNSense verwijdert het record en voegt het nieuwe toe.

Naast DNS leest DNSense vervaldatums en slotstatus, wijzigt nameservers en kan een domein registreren vanaf je NameSilo-saldo. Een transfercode is niet via de API uit te lezen: DNSense vraagt hem aan en NameSilo mailt hem naar de administratieve contactpersoon.

Mislukt de verbinding, controleer dan eerst de IP-beperking en kijk of je de hele sleutel hebt gekopieerd.