2.1.3 Initial configuration

Owned by Former user (Deleted)
Last updated: Dec 01, 2015
4 min read

VUC

The VUC configuration is stored in the App.Settings.config file located in the VUC's directory. 

< appSettings >
     <!--
             ######################################################################
     
             General
             
             ######################################################################
     -->
     <!-- VoipSwitch WebPhone URL, points at websocket SIP proxy on Tomcat,
                          recomended is wss:// because of security reason
     -->
     < add key = "WebPhoneUrl" value = "ws://domain:8081/WebPhone/websocket" />
     <!-- Voipswitch EMCI API URL -->
     < add key = "RcsApiInternalUrl" value = "http://domain/emci/" />
     <!-- Voipswitch EMCI API IP - for authentication of requests coming from the EMCI -->
     < add key = "RcsApiIp" value = "55.44.22.101" />
     <!-- Voipswitch EMCI API user agent identifier -->
     < add key = "RcsIdentifier" value = "vippie" />
     <!-- Off net phone number prefix for calls beyond voipswitch -->
     < add key = "OffNetPrefix" value = "" />
     <!-- On net phone number prefix -->
     < add key = "OnNetPrefix" value = "" />
     <!-- VoipSwitch services URL used by Fax module -->
     < add key = "VSServicesUrl" value = "http://78.88.10.10/VSServices/" />
     <!-- VoipSwitch OnlineShop URL for online payments -->
     < add key = "OnlineShopUrl" value = "https://domain/OnlineShopTest/" />
     <!-- VoipSwitch Call Recording Service URL -->
     < add key = "CallRecordingServiceUrl" value = "http://192.168.0.2:93/CrService/" />
     <!-- flag if email can be used as login -->
     < add key = "EmailAsLogin" value = "false" />
     <!-- template of the email sent when a new sub account is created fom Users menu    --> 
    <add key="PbxSignupWelcomeSubAccountMessageBody" value="file://Content/CompanySignup/welcome_email_subaccount.html"/>    
   <!--
             ######################################################################
     
             Greetings transcoding
             
             ######################################################################
     -->
     <!-- Voipswitch VoipBox storage path -->
     < add key = "voipbox_storage" value = "d:\vs\uploads\voipbox" />
     <!-- ffmpeg.exe path, ffmpeg has to be installed on the same machine as VUC Portal -->
     < add key = "ffmpegPath" value = "d:\portable\ffmpeg\bin\ffmpeg.exe" />
     <!-- ffmpeg transcoding settings -->
     < add key = "ffmpegOptionsGreetings" value = "-i &quot;{0}&quot; -vn -ar 44100 -ac 1 -f mp3 &quot;{1}&quot;" />
     <!--
             ######################################################################
     
             VoipSwitch Provisioning Server
 
             ######################################################################
     -->
     <!-- VoipSwitch Provisioning Server URL -->
     < add key = "ProvisioningServerUrl" value = "http://localhost:92/" />
     <!-- provisioning template Id used by adding devices or softphones in Users or in Signup,
             templates are created in Provisioning Server Web Application -->
     < add key = "ProvisioningTemplateId" value = "1" />
     <!-- Provisioning Server providers login -->
     < add key = "ProvisioningLogin" value = "u1" />
     <!-- Provisioning Server providers password -->
     < add key = "ProvisioningPassword" value = "u1" />
     <!--
             ######################################################################
     
                   SIPml
             ######################################################################
     -->
     <!-- voipswitch address, ex: sip.domain.com -->
     < add key = "SipmlSipServerAddress" value = "sip.domain.com" />
     <!-- voipswitch port, ex: 5060 -->
     < add key = "SipmlSipServerPort" value = "5060" />
     <!-- SIPml websocket URL, points at SIP proxy of webrtc2sip application -->
     < add key = "SipmlWebsocketProxyUrl" value = "ws://107.20.31.91:10060/" />
     <!-- ICE configuration in JSON, ex: [{ url: 'stun:stun.l.google.com:19302'}] -->
     < add key = "SipmlIceServers" value = "[{ url: 'stun:stun.l.google.com:19302'}]" />
     <!-- SIPml debug level in browsers log, 'info' (more details) or 'error' (less details) -->
     < add key = "SipmlDebugLevel" value = "error" />
     <!--
             ######################################################################
     
             Reset password 
 
             ######################################################################         
     -->
     <!-- email content,
             if EmailAsLogin flag is set, use [EMAIL] instead [LOGIN]-->
     < add key = "en-US.PasswordReset.Body" value = "Your new password: [PASSWORD], login [LOGIN]" />
     <!-- email title -->
     < add key = "en-US.PasswordReset.Title" value = "New password for VUC" />
     <!-- email text format -->
     < add key = "en-US.PasswordReset.UseHtml" value = "false" />
     <!-- password generators options: -->
     < add key = "en-US.PasswordReset.UseNumbers" value = "true" />
     < add key = "en-US.PasswordReset.UseLetters" value = "true" />
     < add key = "en-US.PasswordReset.UseLowerCaseLetters" value = "true" />
     < add key = "en-US.PasswordReset.Length" value = "10" />
     <!--
             ######################################################################
     
             PBX company signup 
 
             ######################################################################
     -->
     < add key = "PbxSignupPlan1Id" value = "6" />
     < add key = "PbxSignupPlan2Id" value = "6" />
     < add key = "PbxSignupPlan3Id" value = "6" />
     < add key = "PbxSignupPayment" value = "PayPal" />
     < add key = "PbxSignupTransactionType" value = "plan_subscription" />
     <!--
             ######################################################################
     
             PBX company trial signup 
 
             ######################################################################
     -->
     < add key = "PbxSignupPlanFreeId" value = "6" />
     < add key = "PbxSignupFreeMaxClients" value = "5" />
     < add key = "PbxSignupRegisterMessageTitle" value = "VUC new account confirmation" />
     < add key = "PbxSignupRegisterMessageBody" value = "file://Content/CompanySignup/confirmation_email.html" />
     < add key = "PbxSignupWelcomeMessageTitle" value = "Welcome to VUC" />
     < add key = "PbxSignupWelcomeMessageBody" value = "file://Content/CompanySignup/welcome_email.html" />
     <!--
             ######################################################################
     
             required by MVC 4
 
             ######################################################################
     -->
     < add key = "enableSimpleMembership" value = "false" />
     < add key = "webpages:Version" value = "2.0.0.0" />
     < add key = "webpages:Enabled" value = "false" />
     < add key = "PreserveLoginUrl" value = "true" />
     < add key = "ClientValidationEnabled" value = "true" />
     < add key = "UnobtrusiveJavaScriptEnabled" value = "true" />
</ appSettings >

Login as Email

 

<!-- flag if email can be used as login -->
< add key = "EmailAsLogin" value = "true" />
<!-- flag if email can be used as login in readable format -->
< add key = "EmailAsLoginReadable" value = "false" />

 

This setting definthe account login format:

  • If both values are set to FALSE:

User accounts will be created with standard logins - usernames. When a use logs in the VUC will check the login field from the voipswitch.clientshared table.

  • If both values are set to TRUE:

Users' emails will be used to create logins, for example, an email "tom@voipswitch.com" will be converted to "tom_voipswitch.com" .

  • If set to True/False:

Logins will be created by applying a hashing function to the user's email address. The MySQL function sha('tom@voipswitch.om') is used.

  • It can't be set to False/True.

 

The login creation policy should be decided once, if you change it the previously created accounts will stop working.

 

VSM

The VSM configuration is stored in the AppSettings.xml file located in the VSM's directory. The PBX related section includes:

<!-- PBX SETTINGS -->
<add key="EmailAsLogin" value="true" /> <!-- flag if email can be used as login -->
<add key="EmailAsLoginReadable" value="true" />
<!-- PBX SETTINGS -->

 

Similarly like in the RCS services the client profiles are created by the EMCI API. Also the account management is through the API and therefore the EMCI connection has to be defined. 

<!-- EMCI -->
<add key="emciUrl" value="http://doomain:81/"/>
<add key="emcMode" value="generic"/> <!-- Available values: generic rcs -->
<!-- EMCI -->

 

the emcMode has to be set to "generic".