Configuration restrictions

Supported only in Softphone.Pro 3.1

For security reasons you can hide settings received from provisioning server, for example: SIP credentials or 3-rd party CRM\Helpdesk integration settings. Use the [Restrictions] section in user configuration file on provisioning server for that purpose.

[Restrictions]
DisplaySettingsRestriction=1
NotificationsSettingsRestriction=1
CallForwardingSettingsRestriction=1
SipSettingsRestriction=1
SipAccountsSettingsRestriction=1
ContactsSettingsRestriction=1
IntegrationSettingsRestriction=1
PrerecordedSettingsRestriction=1
LicenseSettingsRestriction=1
UpgradeCheckRestriction=1
AudioRecordStoreRestriction=1
HistoryStoreRestriction=1
CustomStatusesRestriction=1

All the [Restrictions] section parameters have 0 (no restriction) value by default.

Most part of parameters corresponds to sections of Softphone.Pro Settings dialog window. If parameter value is 1 corresponding section of Softphone.Pro Settings dialog will be hidden and its parameters will be removed from SoftphonePro.ini user configuration file.

If parameter value is 0 user can see and edit settings received from provisioning server and these settings will be saved to SoftphonePro.ini configuration file on user's computer

Use configuration templates for repeating restrictions. PHP test provisioning server uses restrictions.ini template for user "example" which contains [Restrictions] section.

List of restrictions:

DisplaySettingsRestrictionHides Display section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
NotificationsSettingsRestrictionHides Notifications section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
CallForwardingSettingsRestrictionHides Call Forwarding section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
SipSettingsRestrictionHides SIP Settings section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
SipAccountsSettingsRestrictionHides SIP Accounts section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
ContactsSettingsRestrictionHides Contacts section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
IntegrationSettingsRestrictionHides Integration section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
PrerecordedSettingsRestrictionHides Pre-recorded audio messages section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
LicenseSettingsRestrictionHides License Key section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer
UpgradeCheckRestrictionDisables version upgrade checking on application start
AudioRecordStoreRestrictionDisables audio records storing on user's computer. Audio records are being deleted automatically after Softphone.Pro exit.
HistoryStoreRestrictionDisables call history storing on user's computer. Call history is being cleared automatically after Softphone.Pro exit
CustomStatusesRestrictionDisallows editing user account statuses

Restrictions usage example

1. Set value 1 for all restriction values in user configuration file on PHP test provisioning server for any user:

[Restrictions]
DisplaySettingsRestriction=1
NotificationsSettingsRestriction=1
CallForwardingSettingsRestriction=1
SipSettingsRestriction=1
SipAccountsSettingsRestriction=1
ContactsSettingsRestriction=1
IntegrationSettingsRestriction=1
PrerecordedSettingsRestriction=1
LicenseSettingsRestriction=1
UpgradeCheckRestriction=1
AudioRecordStoreRestriction=1
HistoryStoreRestriction=1
CustomStatusesRestriction=1

2. Restart Softphone.Pro and login as user for which the restrictions have been set.

3. Open Settings dialog. The dialog contains Main section only. All other sections are hidden:

Hidden configuration sections on Settings window

4. Open SoftphonePro.ini user configuration file. The file contains [AppSettings] section parameters only. All other sections are removed.