Difference between revisions of "SMS Utilities"

From Teltonika Networks Wiki
Line 304: Line 304:
 
| style="vertical-align: top;" | Possible values:
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 +
|-
 +
|}
 +
 +
====Get list of profiles====
 +
{| class="wikitable"
 +
|+
 +
! style="width: 250px; background: black; color: white;" | Field name
 +
! style="width: 250px; background: black; color: white;" | Explanation
 +
! style="width: 500px; background: black; color: white;" | Notes
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable
 +
| style="vertical-align: top;" | This check box will enable or disable the Get list of profiles function
 +
| style="vertical-align: top;" | Allows you to get the list of profiles via SMS
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Action
 +
| style="vertical-align: top;" | The action to be performed when this rule is met.
 +
|
 +
|-
 +
! style="text-align: left; vertical-align: top;" | SMS text
 +
| style="vertical-align: top;" | SMS text that will trigger the rule. In this case, send you The list of profiles
 +
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Authorization method
 +
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 +
| style="vertical-align: top;" | Possible values:
 +
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Allowed users
 +
| style="vertical-align: top;" | White list of allowed users
 +
| style="vertical-align: top;" | Possible values:
 +
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 +
|-
 +
|}
 +
 +
====Change profile====
 +
{| class="wikitable"
 +
|+
 +
! style="width: 250px; background: black; color: white;" | Field name
 +
! style="width: 250px; background: black; color: white;" | Explanation
 +
! style="width: 500px; background: black; color: white;" | Notes
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable
 +
| style="vertical-align: top;" | This check box will enable or disable the Change profile function
 +
| style="vertical-align: top;" | Allows changing profiles via SMS
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Action
 +
| style="vertical-align: top;" | The action to be performed when this rule is met.
 +
|
 +
|-
 +
! style="text-align: left; vertical-align: top;" | SMS text
 +
| style="vertical-align: top;" | SMS text that will trigger the rule. In this case, send change profile
 +
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
'''After the SMS text you have to write the Profile's name'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Authorization method
 +
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 +
| style="vertical-align: top;" | Possible values:
 +
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Allowed users
 +
| style="vertical-align: top;" | White list of allowed users
 +
| style="vertical-align: top;" | Possible values:
 +
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 +
|-
 +
|}
 +
 +
====SSH access Control====
 +
{| class="wikitable"
 +
|+
 +
! style="width: 250px; background: black; color: white;" | Field name
 +
! style="width: 250px; background: black; color: white;" | Explanation
 +
! style="width: 500px; background: black; color: white;" | Notes
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable
 +
| style="vertical-align: top;" | This check box will enable or disable the SSH access control function
 +
| style="vertical-align: top;" | Allows SSH access control via SMS
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Action
 +
| style="vertical-align: top;" | The action to be performed when this rule is met.
 +
|
 +
|-
 +
! style="text-align: left; vertical-align: top;" | SMS text
 +
| style="vertical-align: top;" | SMS text that will trigger the rule. In this case, turn SSH access On/Off
 +
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Authorization method
 +
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 +
| style="vertical-align: top;" | Possible values:
 +
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Allowed users
 +
| style="vertical-align: top;" | White list of allowed users
 +
| style="vertical-align: top;" | Possible values:
 +
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable SSH access
 +
| style="vertical-align: top;" | Enable this to reach the router via SSH from LAN
 +
| style="vertical-align: top;" | If this is checked, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable remote SSH access
 +
| style="vertical-align: top;" | Enable this to reach the router via SSH from WAN
 +
| style="vertical-align: top;" | If this is checked, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN
 +
|-
 +
|}
 +
 +
====Web access Control====
 +
{| class="wikitable"
 +
|+
 +
! style="width: 250px; background: black; color: white;" | Field name
 +
! style="width: 250px; background: black; color: white;" | Explanation
 +
! style="width: 500px; background: black; color: white;" | Notes
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable
 +
| style="vertical-align: top;" | This check box will enable or disable the Web access control function
 +
| style="vertical-align: top;" | Allows Web access control via SMS
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Action
 +
| style="vertical-align: top;" | The action to be performed when this rule is met.
 +
|
 +
|-
 +
! style="text-align: left; vertical-align: top;" | SMS text
 +
| style="vertical-align: top;" | SMS text that will trigger the rule. In this case, turn Web access On/Off
 +
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Authorization method
 +
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 +
| style="vertical-align: top;" | Possible values:
 +
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Allowed users
 +
| style="vertical-align: top;" | White list of allowed users
 +
| style="vertical-align: top;" | Possible values:
 +
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable HTTP access
 +
| style="vertical-align: top;" | Enable this to reach the router via HTTP from LAN
 +
| style="vertical-align: top;" | If this is checked, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable remote HTTP access
 +
| style="vertical-align: top;" | Enable this to reach the router via HTTP from WAN
 +
| style="vertical-align: top;" | If this is checked, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN
 +
|-
 +
! style="text-align: left; vertical-align: top;" | Enable remote HTTPS access
 +
| style="vertical-align: top;" | Enable this to reach the router via HTTPS from WAN
 +
| style="vertical-align: top;" | If this is checked, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN
 
|-
 
|-
 
|}
 
|}

Revision as of 13:10, 4 October 2017

Summary

RUT routers have an extensive amount of various SMS control utilities. SMS Utilities can be used to set/get configurations, monitor and issue commands to the router.

SMS Utilities

Default Rules

The SMS Utilities section contains a list of rules that perform certain actions when they are activated by SMS messages.

Services sms utils.PNG

The figure above is an illustration of the SMS Utilities rules list. The entire list contains 26 rules but you are also be provided with the possibility to configure custom ones.

All default configuration options are listed below:

  • Reboot
  • Get status
  • Get I/O status
  • Get OpenVPN status
  • Switch WiFi on / off
  • Switch mobile data on / off
  • Switch OpenVPN on / off
  • Change mobile data settings
  • Get list of profiles
  • Change profile
  • SSH access control
  • Web access control
  • Restore to default
  • Force SIM switch
  • GPS coordinates
  • GPS on / off
  • FW upgrade from server
  • Config update from server
  • Switch monitoring on / off
  • Monitoring status
  • UCI API

Execution

To execute a rule, just send an SMS message to the router‘s SIM card number with the rule's SMS Text, e.g., if you send a message with the text “reboot”, the router will reboot provided the selected Authorization method is “No authorization”. However, if there is an Authorization method present you will need to include the “Authorization key” in the text message. This “Authorization key” depends on the chosen Authorization method, i.e., if the method is “By serial”, the “Authorization key” is the router’s serial number, if the method is “By router admin password”, the “Authorization key” is the router’s admin password. The "Authorization key” must precede the activation text and they must be separated by a space symbol. For example, if the chosen Authorization method is “By router admin password” and the password is “admin01”, the entire message should look like this: “admin01 reboot”. The same applies to “By serial” authorization.

Rule Overview and editing

Every default SMS rule can be edited to your liking. If none of the rules suit your purposes, just click the Edit button next to any SMS Utilities rules. This section will contain information on editing every signle SMS Utilities rule.

Reboot

Field name Explanation Notes
Enable This check box will enable or disable SMS reboot function Allows router restart via SMS
Action The action to be performed when this rule is met
SMS text SMS text that will trigger the rule. In this case, reboot the router SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Get status via SMS after reboot Check this to receive connection status via SMS after the reboot If checked, the router will send a status message once it has rebooted and is operational again. This is both a separate SMS Rule and an option under the SMS Reboot rule. After checking this, the Send status SMS to other number field will become available
Send status SMS to other number Enable this if you want the status message to be sent to another (other than the sender) number (s) If this is checked, you will be prompted to enter a phone number (s)

This field appears only if you have checked Get status via SMS after reboot

Message text Which status information should be included in SMS:

Data state, Operator, Connection type, Signal Strength, Connection State, IP

You can select which status elements to display

Status

Field name Explanation Notes
Enable This check box will enable or disable SMS status function Allows you to get the router‘s status via SMS. This is both a separate SMS Rule and an option under the SMS Reboot rule
Action The action to be performed when this rule is met
SMS text SMS text that will trigger the rule. In this case, send you the router‘s status SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Send status SMS to other number Enable this if you want the status message to be sent to another (other than the sender) number (s) If this is checked, you will be prompted to enter a phone number (s)
Message text Which status information should be included in SMS:

Data state, Operator, Connection type, Signal Strength, Connection State, IP

You can select which status elements to display

Get I/O status

Field name Explanation Notes
Enable This check box will enable or disable SMS I/O status function Allows you to get the router‘s I/O status via SMS
Action The action to be performed when this rule is met
SMS text SMS text that will trigger the rule. In this case, send you the router‘s status SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Send status SMS to other number Enable this if you want a status message to be sent to another (other than the sender) number (s) If this is checked, you will be prompted to enter a phone number (s)

Get OpenVPN status

Field name Explanation Notes
Enable This check box will enable or disable the OpenVPN status function Allows to get the router‘s OpenVPN status via SMS
Action The action to be performed when this rule is met
SMS text SMS text that will trigger the rule. In this case, send you the router‘s OpenVPN status SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Send status SMS to other number Enable this if you want a status message to be sent to another (other than the sender) number (s) If this is checked, you will be prompted to enter a phone number (s)

Switch WiFi On/Off

Field name Explanation Notes
Enable This check box will enable or disable the Switch WiFi function Allows Wi-Fi control via SMS.
Action The action to be performed when this rule is met. Possible values:

On | Off; Default: On

SMS text SMS text that will trigger the rule. In this case, turn Wi-Fi On/Off SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Write to config Permanently saves Wi-Fi state With this setting enabled, the router will keep the new Wi-Fi state even after reboot.

If it is not selected, the router will revert the Wi-Fi state after reboot

Switch mobile data On/Off

Field name Explanation Notes
Enable This check box will enable or disable the Switch mobile data function Allows mobile control via SMS
Action The action to be performed when this rule is met. Possible values:

On | Off; Default: On

SMS text SMS text that will trigger the rule. In this case, turn mobile data On/Off SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Write to config Permanently saves mobile network state With this setting enabled, the router will keep the new mobile data state even after reboot.

If it is not selected, the router will revert the mobile data state after reboot

Manage OpenVPN

Field name Explanation Notes
Enable This check box will enable or disable the Manage OpenVPN function Allows OpenVPN control via SMS
Action The action to be performed when this rule is met. Possible values:

On | Off; Default: On

SMS text SMS text that will trigger the rule. In this case, turn OpenVPN On/Off SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

After the SMS text you have to write OpenVPN instance‘s name

Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Get list of profiles

Field name Explanation Notes
Enable This check box will enable or disable the Get list of profiles function Allows you to get the list of profiles via SMS
Action The action to be performed when this rule is met.
SMS text SMS text that will trigger the rule. In this case, send you The list of profiles SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Change profile

Field name Explanation Notes
Enable This check box will enable or disable the Change profile function Allows changing profiles via SMS
Action The action to be performed when this rule is met.
SMS text SMS text that will trigger the rule. In this case, send change profile SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

After the SMS text you have to write the Profile's name

Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

SSH access Control

Field name Explanation Notes
Enable This check box will enable or disable the SSH access control function Allows SSH access control via SMS
Action The action to be performed when this rule is met.
SMS text SMS text that will trigger the rule. In this case, turn SSH access On/Off SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Enable SSH access Enable this to reach the router via SSH from LAN If this is checked, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN
Enable remote SSH access Enable this to reach the router via SSH from WAN If this is checked, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN

Web access Control

Field name Explanation Notes
Enable This check box will enable or disable the Web access control function Allows Web access control via SMS
Action The action to be performed when this rule is met.
SMS text SMS text that will trigger the rule. In this case, turn Web access On/Off SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
Authorization method What kind of authorization to use for SIM management Possible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed users White list of allowed users Possible values:

From all numbers | From group | From single number; Default: From all numbers

Enable HTTP access Enable this to reach the router via HTTP from LAN If this is checked, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN
Enable remote HTTP access Enable this to reach the router via HTTP from WAN If this is checked, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN
Enable remote HTTPS access Enable this to reach the router via HTTPS from WAN If this is checked, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN