Device tokens
17.2.2.6. Device tokens - REST authentication API

Using theĀ Device Token feature, a REST client (e.g. mobile app) can authenticate itself using public-key cryptography without user interaction. The feature can be used as the first or second factor.

It is thought for the following scenario:

  • 1.
    Initial authentication: The HTTP client authenticates using username, password, and a 2nd factor (e.g. MTAN).
  • 2.
    Device Token registration: The HTTP client generates a key pair and associates the public key with the user account.
  • 3.
    Following logins: Dependent on the configuration, HTTP clients authenticate either using the device token step as the first factor or using username, password, and device token step as the second factor.

The device token authentication step does not require user interaction - it only requires access to the private key on the "device" (e.g. mobile app).

Multiple "device tokens" can be associated with the user account and device tokens can be managed in the IAM Adminapp using a 18.10.1. Generic token controller.

Device token registration

Device token registration

Device token authentication as 1st factor

Device token authentication as 1st factor

Device token authentication as 2nd factor

Device token authentication as 2nd factor