9. Configuration Tool: Users

9.1. The Phonebook

Configured similar to objects, user definitions (phonebook entries) start with an identifier, delimited with a space, and the first element following is the user number. Configuration fields follow. For example:

user  1,sms=17634155950,groups=1+2+7,name=”John Smith”,command=yes

The parameters available for configuring a user in the phonebook are:

user  1,sms=17634155950
Sets phone book entry 1 to the given SMS/phone number. IMPORTANT: The country code, e.g. 1, must be included in the phone number.

user  1,groups=1+2+7
Selects which groups (1..8) which this user is a member of. A user may be a member of 1 to 8 groups. Note that for groups, 1+2 means literally the string "1+2", not 3. Groups=1+2 will give you groups 1 and 2, while 3 will give you group 3.

user  1,name=”John Smith”
The name is for reference only (30 char max), displayed for reference on the console.

user  1,command=yes
If this user is authorized to send commands via SMS, indicate “yes”, defaults to “no” if omitted.

9.2. Password Locking

sys password=jkPE#23kp9&
sys password=0
Set password (any string up to 40 characters) used to unlock a command session via SMS. Any sender recognized as a user may query data via SMS, but only users whose command=yes option has been set may send commands via SMS, and even then, only after unlocking their session. Note: If no password is provided, SMS will remain open to commands from recognized, qualified senders indefinitely. Use password=0 to remove the password entirely. 

NOTE: The password may be set remotely via SMS by any user whose session is unlocked, or if no password was previously in effect. Users designated as "Admin" will be notified of the password change. The password may not be unset (password=0) remotely.

unlock jkPE#23kp9&
When given via SMS, unlocks that user for up to 1 hour during which that user may issue commands via SMS, provided the user has been enabled for command mode (by configuring user n,command=yes). Has no effect on directly connected console. The console is always unlocked, but one has to have physical access to the device along with special knowledge in order to do anything.

NOTE: There is a single password for the device, and not a different password for each user. It is generally going to be the case that, while many users may be notified, only a very limited number of users will be granted the ability to make changes remotely (command=yes), and therefore the password will only be shared by a very small number of people. The password only pertains to making changes remotely, and has no impact on sending notifications.

Copyright © 2019 Control Solutions Minnesota, Inc.