Bria 4 Configuration Guide Enterprise Deployments
CounterPath Corporation CounterPath Corporation Suite 300, One Bentall Centre 505 Burrard Street, Box 95 Vancouver, BC V7X 1M3 Tel: 604.320.3344 sales@counterpath.com www.counterpath.com © April 2014 CounterPath Corporation. All rights reserved. CounterPath and the logo are trademarks of CounterPath Corporation.
Contents About Configuration .....................................................................................................................2 Configuration Settings by Topic...................................................................................................3 Account Credentials................................................................................................................3 Account Setup......................................................................................
CounterPath Corporation iv Confidential – Do not Distribute
Bria 4 Configuration Guide – Enterprise Deployments About this Manual This manual applies to all platforms of Bria: Bria for Windows and Bria for Mac. This manual is intended for: • • System administrators who are deploying Bria in their enterprise by remotely configuring the client through remote provisioning. (For more information on the options for configuring, see the “Bria 4 Administrator Guide”).
CounterPath Corporation 1 About Configuration Bria Settings Configuration of Bria 4 is achieved largely through assigning appropriate values to settings. Settings let you: • • • Configure Bria 4 for the environment (network and so on) in which it will work. Configure Bria 4 for server-side functions you support, such as RLS workgroups. Configure how some Bria 4 features work, and configure whether a feature is enabled or disabled.
Bria 4 Configuration Guide – Enterprise Deployments 2 Configuration Settings by Topic 2.1 Account Credentials Account credentials for each account consist of the user name and password. Do not confuse these credentials with the login credentials. 2.2 Account Setup These settings define the user’s account or accounts. There is one section for each account: proxy0, proxy1, and so on. Each account is either a SIP or an XMPP account, as specified by the proxies:proxyn:protocol setting.
CounterPath Corporation • Workgroup This setting is a bitmask with a default value that enables every feature. Preferred Account for Calls This information applies only if users have more than one SIP account. The setting feature:accounts:defaultForCall is used by Bria to select the account to use for a phone call when account selection mode is set to Auto Account. • • Bria tests the phone call against the dial plans.
Bria 4 Configuration Guide – Enterprise Deployments Setting up for Security outside of Bria When using TLS, the user must have the root certificate that signs the proxy’s chain of certificates. In most cases, the root certificate will already be installed. Procedures for exchange of certificates are outside the scope of this documentation. The certificates must be stored on the Bria computer, in the root certificate store.
CounterPath Corporation 2.7 Codec Usage Your brand includes a specific set of built-in codecs. A codec may be royalty-bearing or non-royalty-bearing: see the Bria 4 Settings reference documentation for details. You can restrict codec usage by enabling or disabling a codec and by setting the license count (even on non-royalty-bearing codecs). Enabling Codecs To enable a codec, set its codecs::enabled setting to true.
Bria 4 Configuration Guide – Enterprise Deployments 2.9 Deskphone Control If you are deploying to an enterprise that uses SIP deskphones, you can configure Bria to use them. Users will be able to initiate calls from Bria (for example, in order to make use of the history or contact list) then switch over to the deskphone for the rest of the call. The deskphone must be a SIP phone that supports dialog events.
CounterPath Corporation 2.12 Directory If you have set up an LDAP directory or Active Directory (Bria for Windows only) on a remote server, you can configure Bria to fetch data from it. This data will be displayed in the Directory in the Resources module. • To enable the Directory, set feature:ldap:enable or feature:adsi:enable to true; the Directory tab will be included next to the Contacts tab and History tab in the Resources module.
Bria 4 Configuration Guide – Enterprise Deployments 2.13 DTMF This group of settings configures Bria to handle DTMF. DTMF can be sent in one of these ways: • • • • • Out-of-band using DTMF 2833 packets Via SIP INFO In-band: Bria will encode the DTMF signals in the audio stream as regular sound. Out-of-band using DTMF 2833 and via SIP INFO In-band and via SIP INFO To configure DTMF, set the desired settings to true.
CounterPath Corporation 2.16 File Transfer File transfer is automatically supported if the XMPP account is supported. Both the sender and the recipient must have XMPP accounts and the local user must be subscribing to the recipient’s presence through the XMPP account. In addition, both sides must be enabled for XMPP file transfer. XMPP file transfer is direct if a peer-to-peer connection exists between the two sides.
Bria 4 Configuration Guide – Enterprise Deployments RTP Session This group of settings let you configure how RTP session activity will be managed. SIP Signaling This group of settings let you configure how Bria handles SIP signaling. 2.19 Network – XMPP This group covers settings relating to XMPP traffic. Make sure you set them for the XMPP account, if you support this. 2.
CounterPath Corporation 2.21 Presence Triggers for Presence Subscriptions Presence subscriptions are started in the following cases: • If the user creates or modifies a contact and adds an address in the Softphone field, then Bria subscribes to that address for presence if: • The domain of the address matches the domain of an existing, enabled SIP account. • And that SIP account is set up for IM/Presence (“Account Usage” on page 3). By default, the subscription is handled in peer-to-peer mode.
Bria 4 Configuration Guide – Enterprise Deployments 2.22 Resources “Resources” refers to the storage location for contacts and privacy rules. Resources for Contacts Bria supports these resources: • Local storage. All contact data is always stored locally (on the user’s computer). This means that some data exists in two places. For example, an XMPP address will be stored on the corresponding XMPP roster and will also be stored locally. No setup is required for local storage: it is automatic.
CounterPath Corporation • • • • • • • • • proxies:proxyn:resource_list_method proxies:proxyn:resource_lists_path proxies:proxyn:resource_lists_path_xcap proxies:proxyn:resource_lists_poll_time proxies:proxyn:resource_list_use_sip_credentials proxies:proxyn:resource_lists_user_name proxies:proxyn:resource_lists_password proxies:proxyn:xcap_oma_auid system:webdav:ignore_versioning. For more information, see the “Configuring an XCAP Server for Resources Storage and Presence” manual.
Bria 4 Configuration Guide – Enterprise Deployments 2.23 Shortcut Keys Bria for Windows supports shortcut keys for several functions. Default key combinations are defined, but you can change these definitions, if desired. 2.24 User Experience This group of settings let the user change the behavior of the Bria GUI. Also look at the settings in “Feature Enabling: Enabling Other Features” on page 9. 2.25 Video These settings provide controls for video quality. 2.
CounterPath Corporation 2.27 Voicemail – Send to Voicemail You can configure Bria to automatically send unanswered phone calls to voicemail. (Other call handling features are described in “Voicemail – MWI Notification” on page 15). There are two ways to send to voicemail, using a 486 SIP response or using a 302 SIP response.
Bria 4 Configuration Guide – Enterprise Deployments 2.29 Workgroup You can configure Bria to display information about users in a workgroup. Only Bria for Windows supports workgroup. Workgroups implement functionality also often associated with BLF (Busy lamp field) and BLA (Bridged line appearance). A workgroup is a group of people who work together. Via the Bria Workgroup window, members of a workgroup can monitor each others’ calls, pick up on behalf of another member, and join an established call.
CounterPath Corporation 2. Decide which account workgroup will work on. Remember that the first account is proxy0, the second account is proxy1, and so on. 3.