---
title: "Authentifizierung"
url: "https://help.internetx.com/de/api/core-authentifizierung/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "Allgemeine API-Grundlagen"
updated: "2024-05-29"
---

# 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](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](https://tools.ietf.org/html/rfc6238)) 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>
```