Introduction

This article demonstrates how to create, manage, or delete an SMS provider configuration.

Also see SMS - Overview.

To get started, go to Security > Authentication > SMS.

Create an SMS configuration

1. On the SMS - Overview page, select the Create SMS Configuration button.
   
2. On the next page, enter the following information:
   • Name
     The name of the configuration that shows up in the admin dashboard.
   • Description
     An optional description of this configuration.
   • Code lifetime (seconds)
     The duration for which the token sent to the end user will be valid.
   • Code length
     The number of digits used in the token.
   • Enabled
     The enabled/disabled state of this SMS configuration. Disabled configurations cannot be used.
   • Allow enroll
     Allow users to enroll a phone number.
   • Provider
     The SMS provider that will be used. Several pre-configured providers are available. You may also select the custom provider if yours is not on the list.
3. After you have entered the above information, select the Configure link.
   
4. A dialog appears with configuration options for the selected provider. Configure the provider's settings on the General tab. Replace any bracketed placeholder values with the actual values of your SMS account. For example, {AccountSID} in the screenshot below should be replaced with a value provided by Twilio.
   
5. On the Parameters tab, add or modify parameters that are sent to the SMS provider. Specify the From address, which is a number given to you by your SMS provider.
   
6. On the Test tab, enter your own phone number and select the Save and send test message button to ensure that the provider has been configured correctly. Be sure to include a plus sign (+) followed by your country code at the beginning of the phone number.
   
7. Once you receive the test message, select the Save button to confirm the SMS configuration. You will see it in SMS - Overview, and it will now be available for use in a portal access rule, application access rule, or password self service.
   
8. When end users are prompted to enroll in 2FA, SMS will now be an option.
   
   The phone number to which SMS messages will be sent is the number stored in the Phone Number field of the end user My profile page. If Active Directory is your directory system provider, this field is by default mapped from the AD phone number attribute.
   

Edit an SMS configuration

Go to Security > Authentication > SMS and select the appropriate Edit link in the Actions column.

You will then be taken to the same screen described above, in the Create an SMS Configuration section. When finished, select the Save button to confirm.

Delete an SMS configuration

Go to Security > Authentication > SMS and select the appropriate Delete link in the Actions column.

Confirm by selecting the Delete button.

The SMS configuration will then be deleted.

Vendor-specific settings

Twilio

• URL
  https://api.twilio.com/2010-04-01/Accounts/{Twilio Account SID}/Messages
• Method
  POST
• Use Basic Authentication
  Yes
• Username
  {Twilio Account SID}
• Password
  {Twilio Auth Token}
• Send as JSON Body
  No
• Parameters
  
  • From: Twilio number, in the format +15555555555
    • In Body: False