Fortinet black logo

Administration Guide

SMS gateways

SMS gateways

To view a list of the configured SMS gateways, go to System > Messaging > SMS Gateways.

The following information is shown:

Create New Select to create a new SMS gateway.
Delete Select to delete the selected SMS gateway or gateways.
Edit Select to edit the selected SMS gateway.
Set as Default Set the selected SMS gateway as the default SMS gateway.
Name The name of the SMS gateway.
Protocol The protocol used by the gateway.
SMTP Server The SMTP server associated with the gateway.
API URL The gateway’s API URL, if it has one.
Default Shows a green circle with a check mark for the default SMS gateway. To change the default gateway, select the gateway you would like to use as the default, then select Set as Default in the toolbar.

You can also configure the message that you will send to users. You can use the following tags for user-specific information:

Tag Information
{{:country_code}} Telephone country code, e.g. 01 for North America.
{{:mobile_number}} User’s mobile phone number.
{{:message}} “Your authentication token code is ” and the code.
{{:null}} Empty string or null value.
To create a new SMTP SMS gateway:
  1. Go to System > Messaging > SMS Gateways and select Create New. The Create New SMS Gateway window opens.
  2. Enter the following information:
    Name Enter a name for the new gateway.
    Protocol Select SMTP.
    SMTP server Select the SMTP server you use to contact the SMS gateway. The SMTP server must already be configured, see SMTP servers.
    Mail-to-SMS gateway Change domain.com to the SMS provider’s domain name. The default entry {{:mobile_number}}@domain.com assumes that the address is the user’s mobile number followed by @ and the domain name. In the Email Preview section, check the To field to ensure that the format of the address matches the information from your provider.
    Email Preview View a preview of the email message.
    To Format of the email address, as determined by the Mail-to-SMS gateway field.
    Subject Optionally, enter a subject for the message.
    Body Optionally, enter body text for the message.
  3. Optionally, select Test Settings to send a test SMS message to the user.
  4. Select OK to create a new SMTP SMS gateway.
To create a new HTTP or HTTPS SMS gateway:
  1. Go to System > Messaging > SMS Gateways and select Create New. The Create New SMS Gateway window opens.
  2. Expand the HTTP/HTTPS section, then enter the following information:
    HTTP/HTTPS
    HTTP method Select the method to use, either GET of POST.
    API URL Enter the gateway URL, omitting the protocol prefix http:// or https://. Also omit the parameter string that begins with ?.
    CA certificate Select CA certificate that validates this SMS provider from the dropdown menu.
    Content-Type Select a content type from the dropdown menu.
    Authorization Type Enter the Username and Password for Basic Auth.
    HTTP Parameters
    Field Enter the parameter names that the SMS provider’s URL requires, such as user and password.
    Value Enter the values or tags corresponding to the fields.
    Delete Delete the field and its value.
  3. If you need more parameter entries, select Add another SMS Gateway HTTP Parameter.
  4. Optionally, select Test Settings to send a test SMS message to the user.
  5. Select OK to create a new HTTP or HTTPS SMS gateway.

SMS gateways

To view a list of the configured SMS gateways, go to System > Messaging > SMS Gateways.

The following information is shown:

Create New Select to create a new SMS gateway.
Delete Select to delete the selected SMS gateway or gateways.
Edit Select to edit the selected SMS gateway.
Set as Default Set the selected SMS gateway as the default SMS gateway.
Name The name of the SMS gateway.
Protocol The protocol used by the gateway.
SMTP Server The SMTP server associated with the gateway.
API URL The gateway’s API URL, if it has one.
Default Shows a green circle with a check mark for the default SMS gateway. To change the default gateway, select the gateway you would like to use as the default, then select Set as Default in the toolbar.

You can also configure the message that you will send to users. You can use the following tags for user-specific information:

Tag Information
{{:country_code}} Telephone country code, e.g. 01 for North America.
{{:mobile_number}} User’s mobile phone number.
{{:message}} “Your authentication token code is ” and the code.
{{:null}} Empty string or null value.
To create a new SMTP SMS gateway:
  1. Go to System > Messaging > SMS Gateways and select Create New. The Create New SMS Gateway window opens.
  2. Enter the following information:
    Name Enter a name for the new gateway.
    Protocol Select SMTP.
    SMTP server Select the SMTP server you use to contact the SMS gateway. The SMTP server must already be configured, see SMTP servers.
    Mail-to-SMS gateway Change domain.com to the SMS provider’s domain name. The default entry {{:mobile_number}}@domain.com assumes that the address is the user’s mobile number followed by @ and the domain name. In the Email Preview section, check the To field to ensure that the format of the address matches the information from your provider.
    Email Preview View a preview of the email message.
    To Format of the email address, as determined by the Mail-to-SMS gateway field.
    Subject Optionally, enter a subject for the message.
    Body Optionally, enter body text for the message.
  3. Optionally, select Test Settings to send a test SMS message to the user.
  4. Select OK to create a new SMTP SMS gateway.
To create a new HTTP or HTTPS SMS gateway:
  1. Go to System > Messaging > SMS Gateways and select Create New. The Create New SMS Gateway window opens.
  2. Expand the HTTP/HTTPS section, then enter the following information:
    HTTP/HTTPS
    HTTP method Select the method to use, either GET of POST.
    API URL Enter the gateway URL, omitting the protocol prefix http:// or https://. Also omit the parameter string that begins with ?.
    CA certificate Select CA certificate that validates this SMS provider from the dropdown menu.
    Content-Type Select a content type from the dropdown menu.
    Authorization Type Enter the Username and Password for Basic Auth.
    HTTP Parameters
    Field Enter the parameter names that the SMS provider’s URL requires, such as user and password.
    Value Enter the values or tags corresponding to the fields.
    Delete Delete the field and its value.
  3. If you need more parameter entries, select Add another SMS Gateway HTTP Parameter.
  4. Optionally, select Test Settings to send a test SMS message to the user.
  5. Select OK to create a new HTTP or HTTPS SMS gateway.