Page Comparison

...

CustomerID installs and pre-configures SMS authentication. Separate installation is not required.Configuration - CustomerID Configuration – SMS section how to enable it. 

...

SMS methods are configured in Ubisecure SSO Server in a similar way to other Authentication Methodsmethods

To configure the SMS method in Ubisecure SSO:

1. Open the Ubisecure Management application.
2. Select Global Method Settings and click the New Method... button.

3. Add New Method window opens.
   Give the method a title (external name visible to end users) and name (name for internal use).
   Set the title to SMS
   Set the name to ubikey.sms.1
   Set the method type to SPI Mobile Phone. The Method Class is automatically selected.
   A directory must be selected, from which contains the user's password and registered telephone number. Select the Directory from the drop down list.
   Press OK.

   Expand
   title Show image
   Image RemovedImage Added Figure 1. Adding a new SMS method to Ubisecure SSO

   
   

4. In the Main page of the new method, select the Enabled checkbox to activate the new method.

5. Add the following lines to the Configuration String field:

   Code Block
   language text
   policy.password.encoding={SSHA} policy.password.protocol=UbiloginDirectory password-name=password.1 directory.schema=UbiloginDirectory

   In this example password.1 will be used as the source for username, password and mobile phone number.

   
   

6. Click SPI Mobile Phone tab. Enter the URL of the SMS service.The variable {mobile} will be replaced with the users mobile number from the user directory.

   The variable {challenge} will be replaced with the text to be displayed on the mobile phone.

   Example: http://sms-service-.com/sms/sendsms?to={mobile}&content={challenge}

   Click Update.

   Note
   NOTE: Be sure that the configured HTTP server in URL parameter answers as HTTP status code 200 (The request has succeeded). All other response codes will be interpreted as a failure situation and the SMS authentication will not succeed. Configurable error will be shown to the user.

   
   

   Figure 2. Defining the SMS Gateway URL for sending an SMS

   
   

   Note
   NOTE: This http address must be reachable from this and any other configured nodes.

   
   

7. Configure UI Text and SMS text

   The variable {challenge} will be replaced with the text to be displayed on the mobile phone. The message used can be set using the tag SMS_TEXT in the localization files, for example uas.properties. Please refer to the SSO Login UI Customization.

   Code Block
   language text title Customizing and localizing message text
   SMS_TEXT = Your one time password is {0}

   Configure remaining UI text and to match system, branding and language requirements.
   
   

8. The method is now installed. Complete the configuration and access control.

...

1. Open the Ubisecure Management application.
2. Select Global Method Settings and click the New Method... button.

3. Add New Method window opens.
   Give the method a title (external name visible to end users) and name (name for internal use).
   Set the title to Unregistered SMS
   Set the name to ubikey.sms.Unregistered
   Set the method type to Mobile Phone unregistered. The Method Class is automatically selected.
   A directory does not need to be selected.
   Press OK.

   Expand
   title Show image
   Image RemovedImage Added Figure 3 Adding a new unregistered method to ubisecure SSO

   
   

4. In the Main page of the new method, select the Enabled checkbox to activate the new method.

5. Add the following lines to the Configuration String field:

   Code Block
   language text
   policy.oauth.otp.timeout=(timeout in minutes) smsUrl=http\://localhost\:7080/smsgateway/sms?mobile\={mobile}&challenge\={challenge}

   Configuration parameter policy.oauth.otp.timeout is optional, and it's used for Oauth2 sms-mt-otp grant. 
   From UI the timeout is always 10 minutes.
   The variable {mobile} will be replaced with the users mobile number from the user directory.
   The variable {challenge} will be replaced with the text to be displayed on the mobile phone. 

   Example: http://sms-service-.com/sms/sendsms?to={mobile}&content={challenge}

   Figure 4 Unregisted sms method configuration

   Click Update.

6. Configure UI Text and SMS text
   1. The variable {challenge} will be replaced with the text to be displayed on the mobile phone. The message used can be set using the tag SMS_TEXT in the localization files, for example uas.properties. Please refer to the SSO Login UI Customization

   2. Customizing and localizing message text
      

      Code Block
      language text
      5. SMS_TEXT = Your one time password is {0}

      Configure remaining UI text and to match system, branding and language requirements.

7. The method is now installed. Complete the configuration and access control.

...