Einen neuen DNS API Zugriff erstellen

Anleitung¶

Für die Anleitungen, welche die DNS-API betreffen, ist es notwendig, vorher einen eigenen DNS-API-Zugriff zu erstellen.

Auf dieser Seite erfährst du, wie das geht!

Melde dich im Kundenportal unter https://cp.servercow.de mit deinen Zugangsdaten an:
Sobald eingeloggt, klicke oben rechts auf den Knopf mit deinem Kundennamen und wähle dann im Dropdown den Punkt Servercow DNS-API aus:
Auf der folgenden Seite findest du eine Übersicht über deine bestehenden DNS API Zugänge. Klicke hier auf den Knopf Neuen API Zugang erstellen:
Gebe nun die Gewünschten Informationen in das Formular ein:
- Name: Dieser Name dient als Identifikator und Suffix für die Authentifizierung und kann frei gewählt werden.
- Domains: Wähle hier die Domains aus, auf die der DNS API Zugang Zugriff haben soll. Du kannst mehrere Domains auswählen. Wenn du keine auswählst, hat der Zugang Zugriff auf alle deine Domains, sowie für alle zukünftigen Domains, die du registrierst.
- Berechtigungen: Hier kannst du die Aktionen einschränken, die der DNS API Zugang durchführen darf. Standardmäßig kann der Nutzer nichts, außer sich anzumelden, du kannst jedoch einzelne Berechtigungen aktivieren, um den Zugriff weiter zu beschränken.
  Mögliche Auswahl:
  - Erstellen: Erlaubt das Anlegen neuer DNS-Einträge.
  - Lesen: Erlaubt das Abrufen und Anzeigen von DNS-Einträgen.
  - Aktualisieren: Erlaubt das Ändern bestehender DNS-Einträge.
  - Löschen: Erlaubt das Entfernen von DNS-Einträgen.
Klicke abschließend auf den Knopf Neuen API Zugang erstellen, um den neuen DNS API Zugang anzulegen.
Es erscheint eine Bestätigungsmeldung mit den Zugangsdaten des neuen DNS API Zugangs. Wichtig: Notiere dir diese Daten, insbesondere das Passwort, da es nur einmalig angezeigt wird und später nicht mehr abgerufen werden kann.

Sobald du alle Schritte befolgt hast, erscheint der neue API-Zugang in der Übersicht. Du kannst ihn nun für die Anleitungen zur DNS-API bzw. DynDNS verwenden.

Authentifizierung:

Benutzername: Der angezeigte API-Username (Format: <deine-kundennummer>-<deingewählter-api-name>)
Passwort: Das zuvor notierte Passwort aus der Bestätigungsmeldung

Häufig gestellte Fragen¶

Wie kann ich mein Passwort für den DNS API Zugang zurücksetzen?

Das Passwort wird beim ersten Erstellen des DNS API Zugangs generiert und kann aus Sicherheitsgründen nicht erneut angezeigt werden. Wenn du dein Passwort vergessen hast oder es zurücksetzen möchtest, kannst du einen neuen DNS API Zugang erstellen und den alten löschen.

Kann ich die Berechtigungen meines DNS API Zugangs nachträglich ändern?

Ja, du kannst die Berechtigungen deines DNS API Zugangs jederzeit im Kundenportal anpassen. Gehe dazu auf die Seite Servercow DNS-API, wähle den entsprechenden Zugang aus und bearbeite die Berechtigungen nach deinen Bedürfnissen.

Bitte beachte, dass Änderungen an den Berechtigungen nicht sofort wirksam werden, da bestehende Sitzungen möglicherweise weiterhin die alten Berechtigungen verwenden, bis sie ablaufen oder neu authentifiziert werden.

Wenn ich keine Domains auswähle, auf welche Domains hat der DNS API Zugang Zugriff?

Wenn du beim Erstellen des DNS API Zugangs keine Domains auswählst, hat der Zugang Zugriff auf alle deine bestehenden Domains sowie auf alle zukünftigen Domains, die du registrierst. Dies ermöglicht eine umfassende Verwaltung deiner DNS-Einträge über die API.

Wie lösche ich einen DNS API Zugang?

Um einen DNS API Zugang zu löschen, gehe im Kundenportal auf die Seite Servercow DNS-API, wähle den Zugang aus, den du entfernen möchtest, und klicke auf die Option Löschen. Bestätige die Löschung, wenn du dazu aufgefordert wirst.

Kann ich mehrere DNS API Zugänge erstellen?

Ja, du kannst beliebig viele DNS API Zugänge erstellen, um verschiedene Anwendungen oder Dienste zu verwalten. Jeder Zugang kann individuell konfiguriert werden, einschließlich der zugehörigen Domains und Berechtigungen.

Kann ich mehrere DNS API Zugänge mit dem selben Namen erstellen?

Ja, du kannst mehrere DNS API Zugänge mit dem selben Namen erstellen. Das System generiert automatisch eindeutige API-Benutzernamen, indem es deine Kundennummer mit dem gewählten Namen kombiniert. Falls ein Name bereits existiert, wird automatisch ein Suffix hinzugefügt (z.B. wird aus test dann test_1).

Dennoch empfehlen wir, von Anfang an eindeutige Namen zu verwenden, um Verwechslungen zu vermeiden und die Übersichtlichkeit deiner API-Zugänge zu gewährleisten.