InfraNestInfraNest
Automatisierung

DNS, Monitore und Server automatisieren mit der InfraNest API

Was die InfraNest API automatisieren kann, sechs Aufgaben, die sich zum Skripten lohnen, eine kostenlose Sandbox in jedem Tarif zum gefahrlosen Ausprobieren und Open-Source-Code, den du heute schon kopieren kannst.

IInfraNest· 9. November 2026· 8 min read
DNS, Monitore und Server automatisieren mit der InfraNest API

Letzte Woche haben wir gezeigt, wie du Claude oder ChatGPT nach deiner Infrastruktur fragst. Diese Woche geht es um die Aufgaben, die du nie wieder von Hand erledigen möchtest. Mit der InfraNest API können deine eigenen Skripte, Deploy-Pipelines und Tools ganz von selbst DNS-Einträge ändern, Monitore anlegen, Alarme während eines Deploys stummschalten und die Uptime melden. Alles, was du für den Einstieg brauchst, findest du auf unserer neuen Entwicklerseite developers.infranest.io.

Eine API ist einfach ein Weg, über den Software InfraNest so nutzen kann wie du in der App: Statt auf einen Button zu klicken, schickt ein Skript eine Anfrage.

Kurz gesagt:

  • Automatisiere DNS, Monitore, Server, Incidents, Wartungsfenster und Statusseiten.
  • Probiere alles zuerst in einer kostenlosen Sandbox aus, in jedem Tarif. Nichts davon erreicht das Internet.
  • Kopiere fertige Skripte und eine GitHub Action aus unseren Open-Source-Repositorys.

Kein Entwickler? Vielleicht brauchst du die API gar nicht

Viele Automatisierungen in InfraNest kommen ganz ohne Code aus:

  • Automatisierungen in der App: „Wenn das passiert, mach das“. Zum Beispiel eine Nachricht in Slack oder Teams posten, wenn ein Monitor ausfällt, oder dafür ein Jira- oder Linear-Issue anlegen. Free enthält 3 Automatisierungen, Pro 25.
  • Dein KI-Assistent: Frag Claude oder ChatGPT, was ausgefallen ist oder was sich geändert hat – in jedem Tarif, auch in Free.
  • Kopieren und einfügen: Die GitHub Action weiter unten braucht nur einen Token und ein paar Zeilen Konfiguration.

Der Rest dieses Beitrags ist für den Fall, dass du deinem eigenen Code das Steuer überlassen willst.

Was du mit der InfraNest API automatisieren kannst

Die API erreicht dieselben Dinge, die du in der App verwaltest:

  • DNS: Zonen und Einträge lesen sowie Einträge bei deinem DNS-Provider hinzufügen, ändern oder entfernen. Jede Änderung landet im Verlauf der Zone und lässt sich dort rückgängig machen.
  • Monitoring: Monitore anlegen, pausieren und fortsetzen, sofort eine Prüfung ausführen sowie Ergebnisse und Uptime abrufen.
  • Server: Monitoring für einen neuen Server einschalten, seine Alarme stummschalten, seine Alarmregeln anpassen und seine Metriken abrufen.
  • Incidents und Wartung: Incidents eröffnen, aktualisieren und abschließen sowie Wartungsfenster starten und beenden.
  • Statusseiten, Domains, Zertifikate, Tags, Kosten und das Audit-Log: lesen und das ändern, was die API-Referenz als änderbar kennzeichnet.

Was bewusst in der App bleibt. Alles, was Geld kostet oder sich nicht rückgängig machen lässt, erfordert eine Person, die in der App angemeldet ist: eine Domain registrieren, verlängern oder transferieren, Server anlegen oder löschen, eine DNS-Zone löschen, Nameserver ändern. Dasselbe gilt für alles, was entscheidet, wer Zugang bekommt oder wohin Alarme gehen, etwa Mitglieder, Provider-Logins und Alarmkanäle. Ein geleakter Token kann also keinen Server bestellen und dich nicht aus deinem Konto aussperren.

Sechs Aufgaben, die sich zu automatisieren lohnen

Zu jeder gibt es eine Schritt-für-Schritt-Anleitung auf der Entwicklerseite und ein sofort lauffähiges Skript in infranest-examples, in Shell, Python, Node.js und PowerShell.

1. Wildcard-Zertifikate, ohne einen Port zu öffnen

Bevor Let's Encrypt dir ein Zertifikat ausstellt, braucht es einen Nachweis, dass du die Domain kontrollierst. Bei einem Wildcard-Zertifikat (*.example.com) wird nur ein temporärer DNS-Eintrag als Nachweis akzeptiert. Dein Zertifikats-Tool, zum Beispiel certbot, bittet InfraNest, diesen Eintrag anzulegen, wartet, bis Let's Encrypt ihn geprüft hat, und entfernt ihn wieder. Kein Webserver muss erreichbar sein, und es funktioniert für jede Domain, deren DNS in InfraNest liegt.

curl -X POST https://api.infranest.io/api/organizations/42/dns-zones/318/dns-records \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-$CERTBOT_DOMAIN-$CERTBOT_VALIDATION" \
  -d '{"type":"TXT","name":"_acme-challenge","value":"'"$CERTBOT_VALIDATION"'","ttl":60}'

Anleitung: Let's Encrypt mit InfraNest DNS

2. Keine Alarme während des Deploys

Ein Deploy startet Dienste neu, und für deine Monitore sieht ein Neustart wie ein Ausfall aus. Öffne vor dem Deploy ein Wartungsfenster und schließe es danach: Niemand wird geweckt, und deine Statusseite zeigt Besuchern, was los ist. Auf GitHub erledigt das unsere InfraNest Maintenance Window Action in einem Schritt:

- name: Silence alerts during the deploy
  id: window
  uses: InfraNest-Infrastructure-Organized/infranest-action@v1
  with:
    token: ${{ secrets.INFRANEST_TOKEN }}
    organization: ${{ vars.INFRANEST_ORG }}
    command: maintenance-open
    check-ids: 1201,1202
    minutes: 30

Ein zweiter Schritt am Ende des Jobs schließt das Fenster wieder, auch wenn der Deploy fehlschlägt. Wird der Job mittendrin abgebrochen, schließt sich das Fenster nach 30 Minuten von selbst.

Anleitung: ein Wartungsfenster aus deiner Pipeline

3. Jeder neue Dienst bekommt einen Monitor

Füge der Pipeline, die einen neuen Dienst ausliefert, einen Schritt hinzu, und nichts geht ohne Überwachung in Produktion. Läuft der Schritt zweimal, bekommst du trotzdem nur einen Monitor, nicht zwei.

Anleitung: beim Deploy einen Monitor anlegen

4. Neue Server werden ab der ersten Stunde überwacht

Du hast einen Server bei Hetzner, DigitalOcean oder einem anderen verbundenen Provider angelegt? InfraNest findet ihn beim nächsten Sync. Eine Anfrage schaltet das Monitoring für ihn ein, eine zweite fügt eine Prüfung seiner Website hinzu.

Anleitung: einen neuen Server überwachen

5. Uptime im eigenen Dashboard oder im Kundenreport

Eine Anfrage beantwortet die Frage „Läuft gerade alles?“: jeder Monitor und jeder Server mit seinem Status, offene Incidents und laufende Wartungen, dazu eine Zusammenfassung mit Zahlen. Andere liefern die Uptime eines Monitors für den letzten Monat und seinen Verlauf Stunde für Stunde. Speise sie in einen Wandbildschirm, einen Chatbot oder den Monatsreport für deine Kunden ein.

Anleitung: Status, Uptime und Verlauf

6. Dynamisches DNS und das Audit-Log in deiner Log-Plattform

Halte einen Namen wie home.example.com auf einen Anschluss gerichtet, dessen IP-Adresse sich ändert: Ein kleines Skript prüft die Adresse und aktualisiert den Eintrag nur, wenn sie sich geändert hat. Oder kopiere einmal am Tag jede Änderung in deinem Workspace, ob in der App oder über die API, in eine Log-Plattform wie Splunk oder Elastic.

Anleitung: dynamisches DNS per Skript · Anleitung: Audit-Log an ein SIEM

Agenturen und MSPs: ein Kunde nach dem anderen

Du betreust Infrastruktur für Kunden? Es gibt zwei Wege, ein Skript auf einen Kunden zu beschränken:

  • Ein Workspace pro Kunde (Business: 5 Workspaces, Enterprise: unbegrenzt). Ein Token funktioniert nur in dem Workspace, in dem er erstellt wurde, also kann ein Skript für Kunde A Kunde B nicht anfassen. Ein Tool, das wirklich alle braucht, kann einen Token bekommen, der in allen deinen Workspaces funktioniert.
  • Ein Workspace, ein Tag pro Kunde. Frag den Status mit dem Tag dieses Kunden ab, und du bekommst nur seine Monitore, Server, Incidents und Wartungen. Das ist ein Kundenreport mit einer einzigen Anfrage.

Ausprobieren, ohne etwas Echtes anzufassen

Jeder InfraNest-Tarif, auch Free, enthält eine Sandbox: einen privaten Übungs-Workspace mit Beispiel-DNS-Zonen, Monitoren samt Verlauf, zwei Servern mit Metriken, Domains, Zertifikaten und Incidents. Tokens, die du dort erstellst, sind Test-Tokens, und nichts, was du dort tust, erreicht einen DNS-Provider, einen Cloud-Provider oder das Internet. Es werden auch keine Alarme verschickt; du siehst, was verschickt worden wäre.

Etwas kaputt gemacht? Sandbox zurücksetzen stellt die Beispieldaten wieder her.

Der Quickstart dauert in der Sandbox etwa fünf Minuten: Beispielzonen lesen, eine Änderung als Vorschau ansehen, sie durchführen und wieder rückgängig machen.

Gebaut für sichere unbeaufsichtigte Skripte

Skripte laufen nachts, wenn niemand hinschaut, und manche davon schreiben KI-Coding-Agents. Deshalb haben wir diese Schutzmechanismen eingebaut:

  • Tokens unter deiner Kontrolle. Gib jedem Token nur die Bereiche, die er braucht, lesend oder schreibend pro Bereich. Wähle, wann er abläuft: nach 30, 90, 180 oder 365 Tagen, mit einer E-Mail eine Woche vorher. Und beschränke ihn auf die IP-Adressen, von denen aus er genutzt wird, damit ein aus einem Build-Log kopierter Token anderswo nutzlos ist.
Der Dialog „Neuer Token“ in InfraNest, ausgefüllt für eine Deploy-Pipeline: Er funktioniert in einem Workspace, läuft nach 90 Tagen ab, ist auf eine IP-Adresse beschränkt und darf DNS und Monitoring lesen und ändern.

Ein Token für eine Deploy-Pipeline: ein Workspace, 90 Tage, eine IP-Adresse, nur DNS und Monitoring.

  • Vorschau vor der Änderung. Hänge ?dry_run=1 an eine DNS-Änderung an und sieh genau, welche Einträge sich ändern würden, vorher und nachher, ohne dass etwas geändert wird.
  • Wiederholungen doppeln nie. Schick mit jeder neuen Anfrage einen Wiederholungsschlüssel (Idempotency-Key) mit. Läuft sie in einen Timeout und dein Skript sendet sie erneut, bekommst du trotzdem nur einen Eintrag oder einen Monitor, nicht zwei.
  • Fehler, auf die ein Skript reagieren kann. Jeder Fehler hat einen festen Code, einen Hinweis, was zu tun ist, und einen Link zur Erklärung.
  • Limits schwarz auf weiß. Jedes Rate-Limit steht auf der Limits-Seite, und jede Antwort sagt dir, wie viel Spielraum du noch hast.
  • Deine Skripte laufen weiter. Es gibt genau eine Version der API, und sie wächst nur. Alles, was ein Skript kaputt machen würde, wird mindestens sechs Monate vorher im Changelog angekündigt, und der Changelog hat einen RSS-Feed.
  • Alles wird protokolliert. Jede Änderung, die ein Token vornimmt, erscheint im Audit-Log unter dem Namen des Tokens.

Eines kann kein Schutzmechanismus ändern: Ein Token handelt in deinem Namen. Was er bei deinem DNS- oder Cloud-Provider ändert, gilt als deine Änderung, und manche Provider berechnen Gebühren für die API-Nutzung oder für das, was du änderst. Fang in der Sandbox an und behalte nach den ersten Durchläufen das Audit-Log im Blick. Mehr dazu unter Verantwortung und Kosten.

Open Source, fertig zum Kopieren

Alles öffentlich auf GitHub:

  • infranest-examples: die Anleitungen als lauffähige Skripte, getestet gegen die Sandbox.
  • infranest-action: Wartungsfenster, Monitor-Pausen und Sandbox-Resets in GitHub Actions.
  • infranest-openapi: die vollständige Beschreibung der API (OpenAPI 3), täglich aktualisiert. Generiere daraus eine Client-Bibliothek oder beobachte das Repository, um von neuen Funktionen zu erfahren.
  • infranest-agent: der Server-Agent. Er liest nur und sendet nur: Er öffnet keine Ports und nimmt keine Befehle an. Lies nach, was er auf deinen Maschinen genau tut.
  • infranest-mcp: die Verbindung zum KI-Assistenten aus dem Beitrag der letzten Woche.

Du klickst lieber, als Befehle zu tippen? Importiere die fertige Collection in Postman, Bruno oder Insomnia.

Du baust eine App für andere?

  • OAuth: Deine Nutzer klicken auf Connect with InfraNest, genehmigen deine App und wählen einen Workspace. Niemand kopiert einen Token, und sie können deine App jederzeit entfernen. Siehe OAuth für Integrationen.
  • Webhooks: InfraNest schickt eine signierte Nachricht an deine URL, wenn ein Monitor ausfällt, eine Domain bald abläuft oder sich DNS-Einträge ändern (ab Pro). Siehe Webhooks.

Lass einen KI-Coding-Agent das Skript schreiben

Claude Code, Cursor, Codex und Copilot können Skripte für die API schreiben. Jede Seite der Entwicklerseite gibt es auch als reinen Text für KI-Tools (hänge .md an die Adresse an), mit einem Index unter llms.txt. Gib dem Agent einen Test-Token aus der Sandbox, dann kann nichts, was er ausprobiert, deine echte Infrastruktur erreichen, während er lernt. Siehe Coding-Agents.

Was es kostet

API-Tokens gibt es mit Pro (5 Tokens), Business (20) und Enterprise (unbegrenzt). Die Sandbox und ihre Test-Tokens funktionieren in jedem Tarif, auch in Free, sodass du bauen und testen kannst, bevor du upgradest. Siehe Preise.

In drei Schritten loslegen

  1. Öffne in InfraNest Mein Konto → Entwickler und erstelle deine Sandbox.
  2. Erstelle dort einen Test-Token und folge dem Quickstart.
  3. Wenn alles funktioniert, erstelle einen Token in deinem echten Workspace. Ein Owner schaltet API-Änderungen für den Workspace einmalig frei; Lesen funktioniert sofort.

Alles Weitere findest du auf developers.infranest.io.

Häufig gestellte Fragen

#Welche InfraNest-Tarife enthalten die API?

API-Tokens gibt es mit Pro (5 Tokens), Business (20) und Enterprise (unbegrenzt). Die Sandbox und ihre Test-Tokens funktionieren in jedem Tarif, auch in Free, sodass du bauen und testen kannst, bevor du upgradest.

#Muss ich Entwickler sein, um InfraNest zu automatisieren?

Nein. Automatisierungen in der App („Wenn das passiert, mach das“) brauchen keinen Code, und du kannst Claude oder ChatGPT in jedem Tarif nach deiner Infrastruktur fragen. Die API ist für den Fall gedacht, dass du deinen eigenen Skripten, Pipelines oder Tools das Steuer überlassen willst.

#Kann ich die API ausprobieren, ohne meine echte Infrastruktur anzufassen?

Ja. Klicke unter Mein Konto → Entwickler auf „Sandbox erstellen“. Sie ist mit Beispieldaten gefüllt, und nichts, was du dort tust, erreicht einen DNS-Provider, einen Cloud-Provider oder das Internet. Du kannst sie jederzeit zurücksetzen.

#Kann ein API-Token Domains registrieren oder Server löschen?

Nein. Alles, was Geld kostet oder sich nicht rückgängig machen lässt, etwa Domains registrieren oder verlängern, Server anlegen oder löschen und Nameserver ändern, bleibt einer Person vorbehalten, die in der App angemeldet ist.

#Wie halte ich einen API-Token sicher?

Gib ihm nur die Bereiche, die er braucht, wähle, wann er abläuft (30, 90, 180 oder 365 Tage), und beschränke ihn auf die IP-Adressen, von denen aus er genutzt wird. Jede Änderung, die er vornimmt, erscheint im Audit-Log unter dem Namen des Tokens.

#Gehen meine Skripte kaputt, wenn sich die API ändert?

Nein. Die API hat genau eine Version und wächst nur. Alles, was ein Skript kaputt machen würde, wird mindestens sechs Monate vorher im Changelog angekündigt.

Neue Artikel, direkt in dein Postfach

Ich möchte Produkt-Updates und neue Artikel von InfraNest per E-Mail erhalten. Ich kann mich jederzeit abmelden.

Datenschutzerklärung

Ähnliche Artikel

In Sekunden startklar

Bring deine gesamte Infrastruktur in ein modernes Dashboard.

Kostenloser Plan · Keine Kreditkarte nötig · In Minuten eingerichtet