login/telekomSMSTokenProvider

Can be used in

Syntax

       <telekomSMSTokenProvider
           user="string"
           password="string"
           [prefixText="string"]
           [normalizeTelephoneNumber="boolean"] />

Listing 1: telekomSMSTokenProvider Syntax

Sample

       <telekomSMSTokenProvider
           user="predic8"
           password="secret"
           prefixText="Token: "
           normalizeTelephoneNumber="true" />

Listing 2: telekomSMSTokenProvider Example

Explanation

The telekomSMSTokenProvider randomly generates a 6-digit token after the user entered her correct password.

The token is then sent to the user via text message. The user's attribute sms is used as the recipient phone number. If this attribute has not been provided by the user data provider, the login attempt fails.

The text message is sent via Deutsche Telekom's developer garden REST API. To use this API, a registered user account with sufficient balance is necessary and the Send SMS API has to be enabled for this account. The user account is specified using the user and password attributes.

The token is prepended by prefixText to generate the text message's text.

If normalizeTelephoneNumber is set, the user's sms attribute will be normalized according to the following rules before using it:

'+' is replaced by '00'.
Any characters within round brackets, '(' and ')', are removed.
'-' and ' ' are removed.