Help Center
Login Sign up
  1. Start
  2. API-Referenz
  3. Allgemeine API-Grundlagen

Authentifizierung

API-Referenz (XML/JSON) · Aktualisiert 2024-05-29

Einführung

Die Domainrobot-API bietet verschiedene Möglichkeiten der Authentifizierung. Abhängig von der gewählten API stehen dir folgende Authentifizierung-Möglichkeiten zur Verfügung:

  • Credentials (user/context/password)
    Für JSON und XML
  • Zwei-Faktor-Authentifizierung (2FA)
    Nur für XML

JSON-API

Authentifizierung über Credentials (Benutzername/Context/Passwort)

Authentifizierung mit dem AutoDNS Benutzernamen und deinem AutoDNS Kontext. Das Passwort musst du selber festlegen.

Benutzer ($user) und Passwort ($password) werden als Basic Auth angegeben. Der Kontext wird hier über den Header X-Domainrobot-Context angegeben.

Beachte die Kontextnummern. Kontext "1" bezeichnet das Demo-System, Kontext "4" bzw. die PersonalAutoDNS Kontextnummer, das Live-System.

Beispiel Http-Header :

Für den Benutzernamen "user", dem Passwort "password" und dem Context "4" müssen folgende Http-Header angegeben werden :

  • Authorization: Basic dXNlcjpwYXNzd29yZA==
  • X-Domainrobot-Context: 4

Weiterführende Hinweise zu Basic Auth sind unter folgenden Link zu finden : https://de.wikipedia.org/wiki/HTTP-Authentifizierung

XML-API

Authentifizierung über Credentials (Benutzername/Context/Passwort)

Beachte die Kontextnummern. Kontext "1" bezeichnet das Demo-System, Kontext "4" bzw. die PersonalAutoDNS Kontextnummer, das Live-System.

Bei der Authentifizierung mit dem AutoDNS Benutzernamen und deinem AutoDNS Kontext musst du das Passwort selber festlegen. Es wird im auth-Block im Tag <password> eingegeben.

<auth>
	<user>USER</user>
	<context>CONTEXT</context>
	<password>PASSWORD</password>
</auth>

Authentifizierung über Zwei-Faktor-Authentifizierung (2FA)

Bei der Zwei-Faktor-Authentifizierung muß zusätzlich zu Benutzernamen und Passwort ein sechsstelliger Zahlencode, der sogenannte Token, eingegeben werden.

Token erzeugen

Der Token wird mit dem Time-based One-time Password Algorithmus (RFC 6238) erzeugt.

Token verwenden

Der Token wird im auth-Block im Tag <token> eingegeben.

<auth>
	<user>USER</user>
	<context>CONTEXT</context>
	<password>PASSWORD</password>
	<token>TOKEN</token>
</auth>