Configuration restrictions
Supported only in Softphone.Pro 3.1 and newer
For security reasons you can hide settings received from provisioning server and prevent them from being saved on a local computer, 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:
| DisplaySettingsRestriction | Hides Display section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| NotificationsSettingsRestriction | Hides Notifications section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| CallForwardingSettingsRestriction | Hides Call Forwarding section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| SipSettingsRestriction | Hides SIP Settings section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| SipAccountsSettingsRestriction | Hides SIP Accounts section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| ContactsSettingsRestriction | Hides Contacts section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| IntegrationSettingsRestriction | Hides Integration section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| PrerecordedSettingsRestriction | Hides Pre-recorded audio messages section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| LicenseSettingsRestriction | Hides License Key section in Settings dialog and avoids saving of corresponding parameters to configuration file on user's computer |
| UpgradeCheckRestriction | Disables version upgrade checking on application start |
| AudioRecordStoreRestriction | Disables audio records storing on user's computer. Audio records are being deleted automatically after Softphone.Pro exit. |
| HistoryStoreRestriction | Disables call history storing on user's computer. Call history is being cleared automatically after Softphone.Pro exit |
| CustomStatusesRestriction | Avoids saving of custom status configuration to configuration file on user's computer |
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:
4. Open SoftphonePro.ini user configuration file. The file contains [AppSettings] section parameters only. All other sections are removed.