- Start
- API-Referenz
- Allgemeine API-Grundlagen
Authentifizierung
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>