Authentication

Introduction

The Domainrobot API offers different possibilities of authentication. Depending on the selected API, the following authentication options are available:

• Credentials (user/context/password)
  For JSON and XML
• Two-Factor Authentication
  For XML only

JSON API

Authentication via credentials (username/password/context)

Authentication with the AutoDNS user name and your AutoDNS context. You must define the password yourself.

User ($user) and password ($password) are specified as Basic Auth. The context is specified here via the header X-Domainrobot-Context.

Example Http-Header :

You have to pass the following http header for the username "user", the password "password" and the context "4":

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

XML API

Authentication via credentials (Username/Password/Context)

Authentication with the AutoDNS user name and your AutoDNS context. You must define the password yourself. It is entered in the auth block in the <password> tag.

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

Authentication via two-factor authentication (2FA)

With the 2FA, a six-digit numerical code, the so-called token, must be entered in addition to the user name and password.

Create Token

The token is generated using the time-based One-time Password Algorithm (RFC 6238).

Use Token

The token is entered in the auth block in the <token< tag.

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