Components > Authentication Server > Configuration > Settings for token distribution (self-hosted)

In this chapter you will learn how to configure the token distribution via SMS.

To use this way of Token distribution you need a SMS provider with a corresponding interface.

For the configuration to take effect, adjustments must be made in two places.

By default, a script is stored, which ensures the token distribution via email. The script for this can be found in the corresponding chapter.

In the following you will find short instructions, where the script is located and where it has to be modified.

1.Log in to the Cordaware bestzero® web interface.

sms-rest_1

2.Navigate to the filter app via the left app overview

sms-rest_2

3.Click on the grey filter "bestzero token sending" and press the "E" key on your keyboard

sms-rest_3

4.Now adjust the SMTP settings for your SMS provider in the script

% Cordaware bestzero token sms script

-module(best_home_mail).

-export([main/1]).

main(_Doc) ->

% Token

Token = best_script:user_token(),

% LDAP User Doc

UserDoc = best_script:user(),

% First Mobile Number

Mobile = case proplists:get_value(<<"mobile">>, UserDoc) of

undefined -> <<>>;

MobileList -> lists:nth(1,MobileList)

end,

% Full address for sending the SMS

MobileMail = binary_to_list(<<Mobile/binary,"@yoursmsprovider.com">>),

best_script:debug_msg("Sending bestzero Token to: ~p (token is ~p, timestamp is ~p)", [Mobile, Token, now()]),

Mail = [

% SMS Relay

{relay, "sms.relay.com"},

% Port of the SMS Relay

{port, 587},

% Encryption method. Possible values are tls, ssl or none.

{secure, tls},

% Authentication

{auth, true},

% Username for authentication with the SMS provider

{username, "smsuser@relay.com"},

% Name of the record from the Password Vault app in the web interface, so that the password is not stored in plain text.

{password, "Cordaware Mail"},

% Sender information

{send_always, true},

{to, [MobileMail]},

{debug, fun(Type,TO) ->

best_script:debug_msg("Send email ~p to: ~p", [Type,TO])

end},

% email sender

{from, "bestzero@relay.com"},

% SMS title

{subject, "Cordaware bestzero Token"},

% SMS body

{body, bi_info(Token)},

% Content Type. html or plain are possible.

{content_type, html}

best_script:sendmail(Mail,[]),

true.

bi_info(Token) ->

<<"Hello " , "\r\n",

"Your registration token to enter in the Cordaware bestzero Appsbox is: ", Token/binary, " \r\n",

"We wish you a lot of fun.">>.

If your SMS provider supports a REST API for sending SMS messages, then you can use the following script as an example:

% Cordaware bestzero token sms with rest api script

-module(best_home_mail).

-export([main/1]).

main(_Doc) ->

% Token

Token = best_script:user_token(),

% LDAP User Doc

UserDoc = best_script:user(),

% First mobile Number

Mobile = case proplists:get_value(<<"mobile">>, UserDoc) of

undefined -> <<>>;

MobileList -> lists:nth(1,MobileList)

end,

% JSON Body of the request

Json = best_script:json_encode({[{<<"mobile">>, Mobile},{<<"token">>, Token}]}),

% POST request to your SMS provider's REST API

SendSMSAPI = best_script:httprequest(post,

{"https://yoursmsprovider.com/send/sms", [],

"application/json", Json

}, [], []),

true.

If you need assistance setting up token distribution via SMS, our support will be there to assist you.