# Enterprise Tab

Note: Some configuration settings do not apply to MiCollab Client Stand-alone Web and Mobile Portal users (see table for details).
Note: Some configuration fields are disabled if MiCollab Client is running in MiCollab-integrated mode.

The Enterprise tab includes fields and options for the Enterprise or company.

The first step to provisioning MiCollab Client is to create an Enterprise. Click Create Enterprise.

After you have created an Enterprise, select it from the list box and then configure the fields and options for the Enterprise from the following areas.

## Settings

The Settings area includes fields for specifying basic Enterprise information.
Note: You cannot change this field after you create the Enterprise if PBX nodes have been defined. Once PBX nodes have been defined, this field cannot be deleted unless all PBX nodes are deleted first.
To configure Enterprise Settings:

1. If required, edit the following Enterprise settings:
   - Description: (Required) Type a description for the Enterprise, for example, Acme Company-Phoenix Arizona. By default this field is blank. The Enterprise Description:
     - is limited to 1-128 characters in length.
     - must contain alpha-numeric characters (dashes included).
     - cannot contain vertical bars (|).
   - Enterprise domain: (Required) Type a domain for the Enterprise. The Enterprise domain does not need to be a resolvable DNS name or a registered domain name, however, it does need to follow the DNS suffix format. The Enterprise domain should be unique to the Enterprise so that peered servers do not have the same Enterprise domain. Mitel suggests using the site location or Enterprise ID as part of the Enterprise domain (for example, Phoenix.xyzcompany.com, where Phoenix is the Enterprise ID).
   - Voice mail server: (Optional)
     - When NuPoint is selected, the Voicemail server field displays the FQDN of the NuPoint server. The field is "read-only" in this case.
     - When Embedded is selected, the Voicemail server field is hidden.

     - When MiCollab Advanced Messaging is selected, the Voicemail server field is enabled and administrator needs to provide the URL for the clients accessing MiCollab Advanced Messaging Web Client.

       MiCollab Advanced Messaging (MAM) integration

       The integration of MiCollab Advanced Messaging provides the user access to the responsive Web-interface for managing Voicemails.

       The user needs to provide the credentials to the MiCollab Advanced Messaging Web Client on MiCollab Clients. The credentials to access MiCollab Advanced Messaging are not stored by the MiCollab Client but cached by the web interface (depending on user's browser settings on the device).

       Precondition:

       - The user needs to have a valid Visual Voicemail license.

       - The server hosting for MiCollab Advanced Messaging must have a valid, trusted certificate. Refer to the MiCollab Advanced Messaging documentation for details.

       - The MiCollab Advanced Messaging Web Client should be enabled for HTTPS and have a valid trusted certificate.

       - For PBX platforms that supports MiCollab Advanced Messaging. Refer to the MiCollab Client Administrator Guide > Table 20: Voice Mail Server Types.

       - The MiCollab Advanced Messaging must have the MiCollab Advanced Messaging Web Client installed.

         Note: The MAM Client URL should be resolvable and accessible form the internet when the MiCollab Client will be used outside on the local LAN.

       Enabling MiCollab Advanced Messaging for a new MiCollab installation

       The type of Voicemail for the installation needs to be selected in the Server Manager on the following page: MiCollab Client Service > Configure MiCollab Client Service > Enterprise > Settings > Voice mail server type.

       Enabling MiCollab Advanced Messaging for an existing MiCollab installation

       An existing MiCollab user will not get the new roles/templates automatically when upgraded to MiCollab 8.0. The admin must manually create the role/template to remove NuPoint and to change the MiCollab Client feature profile. This is required to let the clients show the MiCollab Advanced Messaging in the Voicemail tab.

   - Administrator e-mail: (Optional) Type the e-mail address for the MiCollab Client Service administrator. An e-mail message is sent to this address when On-Demand presence is enforced. Maximum length for this field is 255 characters.

   - Switch type: This field is editable when there are no PBX nodes defined on the PBX nodes tab. Once the Switch type field is set, all PBX Nodes created will be that type. After a PBX Node is created, the Switch type field cannot be changed unless all PBX Nodes are deleted.

     When creating a new enterprise that will not have any PBX nodes and only have Teamwork Mode accounts, the switch type can be left at the default value of “Mitel Communications Director” (the value will be ignored).

   - Collaboration server type: (Optional) Select a collaboration server to use with MiCollab Client. Options include:
     - None (default)

     - MiCollab Audio, Web and Video Conferencing

       If you do not intend to use collaboration features, set this field to None (default). If you have already added and configured a collaboration server, you cannot configure the option here.

       Note: The Mitel Your Assistant Collaboration Module is no longer supported as a collaboration server type. Refer to the Collaboration tab topic for more information.
   - Avatar URL: To enable MiCollab Avatars for Aquarius 69xx Sets (6920, 6930 and 6940), configure the Avatar URL displayed in this field on MiVoice Business in Online Services URL Form.
   - Language: (Required) Select a language for the Enterprise from the list. You can configure the language parameter on the Enterprise, PBX, or account level. The Enterprise language field sets the default language for all accounts on the Enterprise. The PBX language setting overrides the Enterprise setting, and the account setting overrides the PBX setting. The user's language setting determines which language the Welcome E-mail Message is generated in for that user.
   - Time zone: (Required) Select the time zone where the Unified Communications server is physically located from the list box. The time zone where the Unified Communications server is located may be different than the time zone where the Enterprise is located.
2. Click Apply to save the information, or click Reset to clear your changes.

## Calendar Integration

This feature enables the MiCollab Client administrator to configure either a Google Server, Office 365, or an Exchange Server from which the MiCollab Client clients can fetch calendar availability information and update their Dynamic Statuses. Exchange Integration supports Exchange 2013, Exchange 2016, and Exchange 2019.

From the Calendar Type drop-down menu, select Google, Office 365 or MS Exchange.

Some of the user permissions that are mandatory are as follows:

Note:

These permissions are required when Calendar Integration is done with Office 365 using OAuth 2.0.

- API Permissions - The Office 365 administrator has to grant full_access_as_app application permissions for Office 365 Exchange Online API.

- URL Access required - Client’s firewall should allow the URL’s mentioned below:

  - outlook.office365.com - Access for URL outlook.office365.com is also required when Calendar Integration is done with Office 365 using Basic authentication

  - login.microsoftonline.com

If you want to enable calendar integration, click the checkbox.

If MS Exchange or Office 365 is selected (if Google is selected go to step 4):

1. Enter the URL of your Exchange Server. The URL corresponds to Exchange Web Services (EWS). The exact URL depends on how your exchange server is configured but is usually in the formathttps://<hostname>/EWS/exchange.asmx. For Office 365, refer to https://outlook.office365.com/ews/exchange.asmx.
2. The version of the Exchange Server is entered automatically when you successfully test the connection.
   Note: When connecting to a 2010 SP3 Exchange Server, the version may still be shown as SP2 on the MiCollab Client server-manager.
3. Enter the username and password that you use to log into the Exchange Server. This user does not necessarily have to have administrative privileges on the Exchange Server. Any user who can view other users' calendar availability information will suffice. If you are unsure what to enter here, contact your Exchange Server administrator.
   1. If you want to use Impersonation, select the appropriate radio button. If Impersonation is enabled, then MiCollab Client client users will not have to provide their exchange password to use Calendar Integration. However, they still have to provide their Exchange username and primary e-mail address
   2. Enabling Impersonation can have security implications and requires administrative privileges on the Exchange Server.
   3. If you want to use Delegation, select the appropriate radio button.
   Refer to the following Microsoft websites for more details on Microsoft Exchange version details:
   Note: Exchange 2019: https://docs.microsoft.com/en-us/Exchange/new-features/new-features?view=exchserver-2019
   Settings required on Exchange Server for MiCollab Meeting Center

   - Exchange Subscription Type selected as Impersonation or Delegation.

   - For Impersonation, users need to have ApplicationImpersonation as Management Role and Access Rights as LimitedDetails.

   - For Delegation, users need to have Access Rights as LimitedDetails.

   Use following command to change Management Role on Exchange Management Shell, where serviceAccount is username: New-ManagementRoleAssignment –Name:impersonationAssignmentName –Role:ApplicationImpersonation –User:serviceAccount

   Use following command to change Access Rights on Exchange Management Shell: Add-MailboxFolderPermission -Identity user1@mitel.com:\Calendar -User user2@mitel.com -AccessRights LimitedDetails

   where,

   - user1: user ID of the mailbox or calendar you want to get access to.

   - user2: user ID of the service account you use or configure on Admin portal.

   Note: Only Basic Authentication is supported on MiCollab while communicating with the Exchange Server.
4. You can access the Advanced Calendar Integration Settings. The default values for these settings works appropriately under most circumstances so normally, these do not need to be adjusted. Change them only if you have very particular needs, such as high network latency. Be aware that changing these values affects calendar integration across ALL enterprises.
5. Test your connection to ensure that MiCollab Client can connect to either the Google Server or Exchange Server and communicate with it properly. If after clicking on the Test Connection button you receive an error stating "Invalid calendar server credentials", you need to troubleshoot the issue.
6. Click Apply to save the changes or Reset to clear the changes.

Calendar Integration for Office 365

The authentication protocol for Calendar Integration with Office365 can be either Open Standard for Authentication 2.0 (OAuth 2.0) or Basic Authentication protocol.

Basic Authentication mechanism is a process where the username and password are provided for authentication purposes, whereas incase of OAuth 2.0 tokens are being used for authorization.

Pre-requisites

- To use OAuth 2.0, an application must have an application ID issued by Azure Active Directory. On the Request API page, select Exchange under Supported Legacy APIs followed by Application Permissions and then select full_access_as_app. Then click Add Permissions.

- For more details on configuration, refer to Configuration > Cloud Service Provider section.

Once the configuration under Cloud Service Provider is successful, the MiCollab Administrator can enable Calendar integration from MiCollab Client Services.

Perform the following steps under MiCollab Client Services:

1. Navigate to the Applications > MiCollab Client Service > Enterprise.

2. Under Calendar Integration, select the Calendar Type as MS Office365.

3. The admin can select the Authentication Protocol for Office 365 as:

   - Basic, or

   - OAuth 2.0

     In order to enable OAuth 2.0 under MiCollab Client Service, the admin must select the Authentication Protocol’s radio button as OAuth 2.0.
     Note: The default Authentication Protocol would be selected as Basic.

4. For Exchange Subscription Type, the default option selected is Impersonation, if OAuth 2.0 is selected as Authentication Protocol. It will be applicable for all 9.2 servers including the new deployed and upgraded servers.

Note: A fter a backup restore, the client credentials will not be part of the MiCollab backup. Therefore, the admin must reconfigure OAuth 2.0 settings at Cloud Service Provider section and then enable Calendar Integration.
Note: Default subscription type is not supported in Calendar Integration for Office 365 with OAuth 2.0 Authentication Protocol.

## Trusted Servers

This area provides a table of trusted servers for MiCollab Client. After you configure peering with one or more MiCollab Client Services, they are automatically added to this table.
Note: If the peered server IP address is changed, add or edit the IP address in the Trusted Server Details page, to view the presence state of the users.
The table includes three columns:

- Description: Indicates the description you provide for the trusted server.to
- IP address/hostname: Indicates the server's IP address or hostname.
- Type: Indicates one of the following trusted server types:
- Presence Proxy: Presence proxy servers are required to provide presence information such as status and login notification to remote users. If you do not have any remote users (all users are located at the site where the Unified Communications server is located), you do not need to add presence proxy servers.
- IM: An IM trusted server provides Instant Messaging presence to MiCollab Client users on the local Enterprise.
- Peer: A peer trusted server provides presence information for corporate contacts on peered MiCollab Client Services.

You can complete the following tasks for trusted servers:

- Click the Add Server link to add a new trusted server.
- Click the server name link to edit the corporate location.
- Delete a trusted server.

  If you delete a peered server, you can also delete it as a trusted server, as part of your cleanup activities.

  To delete a trusted server:

  1. Select the server you want to delete from the Trusted Servers table.

  2. Click the Delete Server link. A dialog box appears prompting you to confirm the deletion.

  3. Click OK to delete the server, or click Cancel to cancel the deletion.

## Launchpad Settings

The Launchpad is an area on the MiCollab Client Desktop Client interface where the user can quickly navigate to a URL, dial a phone number, run a program, or explore a folder. The Launchpad entries that you configure here apply to every user that is licensed for the Launchpad feature.

This area of the Enterprise tab provides a table that lists the Launchpad entries you add for MiCollab Client . The table includes three columns:

- Label: Indicates the label or description that you provide for Launchpad entry.
- Action: Indicates what occurs when the user accesses the Launchpad item. There are two actions that you can configure for the user: Dial a number, and Browse to a URL.
- Value: Indicates the phone number or URL that corresponds to the action you selected.

You can Add, Edit, and Delete Launchpad entries. Any changes you make to Launchpad settings will not be shown in the Desktop Client until the user restarts the client.

## USB Devices

The MiCollab Client Desktop Client supports several headsets and handsets (see list under Requirements).

To use a USB device with MiCollab Client , users must create a USB device profile using the MiCollab Client Desktop Client. If the user's account includes the User can manage USB device profiles option (Account Details Page – Account Settings – USB Devices), he or she can upload the profile to the Unified Communications server.

The USB devices displayed in this area include the device information from the profiles created and uploaded by users. The device information is read-only and cannot be edited. You can however, Sort the information and Delete USB devices from the server.

## Plus Dialing Settings

This area of the Enterprise tab includes fields for specifying plus dialing settings.

Note: Starting with MiCollab Client 5.1, some of the dialed digit processing happens locally within MiCollab Client clients. Due to this, if some dialing settings are changed in the server-manager, all clients within that enterprise (or for that PBX) should be restarted. Following are the settings affected by this:

- At the enterprise level:
  - Plus Dialing settings -> Country code
  - Plus Dialing settings -> International access code
  - Plus Dialing settings -> Long distance access code
- At the PBX Node details level:
  - Plus Dialing settings -> Country code
  - Plus Dialing settings -> International access code
  - Plus Dialing settings -> Long distance access code
  - Extension length
  - Dialing prefix

The plus dialing settings include:

- Country code: This field should be set to the country code of the country where the PBX resides. If an E.164 call is placed to a number within the user's "home" country, the country code will be stripped off of the digit string by MiCollab Client .

- International access code: This field indicates the international dial code that must be dialed for international calls from the country where the PBX resides. If the MiCollab Client determines that the call is being placed outside of the user's country (based on the PBX country code), MiCollab Client will pre-pend the International Prefix.

- Long distance access code: This field indicates the Toll digit for the country where the user's PBX resides. For any E.164 dialed calls within the user's home country, MiCollab Client will prepend the toll digit.

  Note: It is important that sites using E.164 (plus dialing) settings set up ARS on the PBXs to strip the Toll Digit for local calls.
  Note: During an avatar search, the CLID translation string is stripped off from the directory number.

## CLID Translation

CLID Translation: For more details on this field, please refer to the help for CLID translation field in the PBX Node Details page.
Note: If CLID Translation is explicitly specified at the PBX node level, that setting will override the CLID Translation setting at the enterprise level.

## Default Account Settings

This area of the Enterprise tab includes the default values that will apply to MiCollab Client accounts when they are created. The values you configure here apply to all accounts whether you create them manually (Adding and Editing Accounts), or you create them automatically by configuring an AD/LDAP or PBX Node synchronizer (Synchronization tab).

If required, you can edit the values for any account from the Account Details page.

To configure default account settings:

1. Configure the account Login Settings:
   - Country: Select the country that the MiCollab Client users reside in. By default, this option is set to United States.
   - PBX node: Select the PBX node that services users from the list box. The list includes all the PBX nodes you have configured on the PBX Nodes tab. If you have not configured PBX Nodes yet, the list box is empty.
   - Account code length: Account codes provide a way to track phone usage. Select the account code length from the list box. Options include 0-12. You can configure account code details on the ACD Settings tab.
     - Enable ACD features in client: Select this option to provide users with Automatic Call Distribution (ACD) features in the MiCollab Client Desktop Client.
     - Allow user to upload display picture: Determines if users can upload their own display picture from the Desktop Client.
     - Allow picture download support for Previous Clients (unsecure): Allows users to download picture for previous MiCollab Clients.
     - Enable E911 Warning: Displays a warning whenever the user launches the softphone client. The warning states that the softphone may not be able make calls to the appropriate emergency 911 public safety authorities in some locations. By default, this option is enabled.
     - Enable Self Deployment: Allows the user to self-deploy MiCollab Client.
     - Provision new MiCollab Client for PC: Select to provision MiCollab Client for PC for all users under the Enterprise. By default, this option is disabled.
     - Enable TLS certificate validation for legacy clients: Select to enable validation of TLS certificate for legacy clients. By default, this option is disabled.
   - Sort Order: Select the order type you want for displaying the names on MiCollab Clients.

     - Select First Name to display the contacts’ first name in the directory and search results. By default, First Name is selected as sort order.

     - Select Last Name to display the contacts’ last name in the directory and search results.

     Note: Changing the sort order value at server will not impact the setting of existing users. Sort order value of server will come into effect only for new users.
     Note: If an existing server is upgraded to include this setting, the server will have default value as First Name. It will not have any impact on the Client setting.
     Note: If the sorting value is changed to Last Name, this value will persist even after the upgrade or on restoring backups.
   - Auto Upgrade Client: Auto upgrade client provides an option to control the automatic client upgrades.
     - Select Enable to push the client upgrade popup notification (if there is a new version of the client available) for all users under the Enterprise (provided that Default or Enable is set in Accounts > Account Settings). By default, this option is enabled. The users will get a client upgrade pop-up notification.
     - Select Disable to disable the client upgrade notification for all users under the Enterprise (provided that Enable is not set in Accounts > Account Settings).
   - Corporate Directory Settings:
     - Download limit
   - The (Really Simple Syndication) RSS Window is an optional embedded window that provides RSS feeds from a selected URL to the user's Legacy Desktop Client. Configure the following RSS Window settings:
     - URL: Type the URL to use as the default RSS Window location.
     - Always on: Select this option if you want the RSS Window to always appear on the user's Desktop Client.
     - User modifiable: Select this option if you want to allow users to change the default URL.
   - Select a Collaboration Server from the list. The list includes all the collaboration servers you have configured on the Collaboration tab. If you have not configured collaboration servers yet, this field displays the message, "No collaboration servers defined."
   - If desired, enable the Users can manage MiCollab corporate locations. This field allows users to manage Corporate Locations from their MiCollab Mobile Client and upload the information to the MiCollab Client Service . By default, this option is disabled.
   - The MiCollab Client Desktop Client supports various Universal Serial Bus (USB) devices. Configure account USB Devices options:
     - User can configure local USB devices: Select this option to allow users to configure USB devices in the MiCollab Client Desktop Client.
     - User can manage USB device profiles: Select this option to allow users to manage (upload, edit, delete) USB device profiles on the Unified Communications server from their desktop client. When you enable this option, the User can configure local USB devices option is automatically enabled.
2. Click Apply to save the information, or click Reset to clear your changes.

## Corporate Locations

This area of the Enterprise tab allows you to manage corporate locations for use on the MiCollab Client Mobile client. The corporate locations table includes the following information:

- Name: The name that you provided for the location.
- Radius: The circular area surrounding the location.
- Latitude: The latitude of the location.
- Longitude: The longitude of the location.

You can complete the following tasks for corporate locations:

- Click the Add Location link to add a new corporate location.
- Click the location name link to edit the corporate location.
- Click to show the corporate location on Google Maps ™ .
- Delete a corporate location. To delete a corporate location:

  1. Select the corporate location that you want to delete from the table.

  2. Click the Delete Location link. A dialog box appears prompting you to confirm the deletion.

  3. Click OK to delete the server, or click Cancel to cancel the deletion.

## Call Log Settings

This field allows the option to Show Missed Calls for Key Line. Once enabled, the Call History will display missed calls for key line numbers.

This feature is disabled by default.

## Reset Password Settings

When this option is enabled, clients are required to change their password on initial login. This option is enabled by default.

## External Ldap Search Settings

External Ldap Search Settings is used to enable external search feature at the Enterprise level. To enable/disable external LDAP search:

1. Tick the External Ldap Search Settings checkbox. By default, this checkbox is disabled. Similarly, uncheck the checkbox to disable the external LDP search.

2. Click Apply to save the information.

## Jetty Configuration Settings

To enable/disable the jetty process:

1. Tick the Enable Jetty Process checkbox. By default, this checkbox is enabled. Similarly, uncheck the checkbox to disable the jetty process.

2. Click Apply to save the information.

## MiTeam Classic Configuration

Check to enable MiTeam Classic. MiTeam Classic provides Cloud-based collaboration features for UCC Premium users. Note that MiTeam Classic is only supported for MiCollab Client in Integrated mode. Refer to the MiCollab Client Administrator Guide for MiTeam Classic integration requirements.

## Email Notification Settings

The textbox contains the default from email address for sending notifications mails. The default value is uca.no.reply@<servername>.<domain name>.

The address can be changed so that emails will be sent from the updated email address.

## Presence Privacy Configuration Settings

This setting controls whether the user's presence information (dynamic status, telephony status, video availability, and calendar advisory) is displayed to other users or not. The user's IM availability is not controlled by this setting.

Presence Privacy Service: By default this setting is Disabled.

- Set the Presence Privacy Service value to Disabled to disable the presence privacy feature.

- Set the Presence Privacy Service value to Enabled to enable the presence privacy feature.

Show Presence for all users: This setting is only available if Presence Privacy Service is Enabled. By default the Show Presence for all users setting is checked.

- If this setting is checked, the presence information of users on local and peered servers is displayed.

- If this setting is unchecked, no presence is shown to users on local and peered servers unless they are added in the presence allowed list of the user.

Limitations

- The server will not send updated presence packet on toggling presence Presence Privacy Service setting at the server. Presence will be updated only when there is change in the presence status or when the user logs out and then logs in.

- Presence Privacy Service is not supported in Co-located mode.

- On peered servers, the Presence Privacy setting at the local server will be given preference. For example, if the setting on peered server A is Enabled and the setting on peered server B is Disabled, peered user's presence will be displayed based on the local server setting and not the server where the user actually exists.

- Telephony presence status of other users does not turn off immediately. The user must re-login to the client. When user is re-logged into the client, telephony presence will turn off from corporate directory, call history, search tab, and from legacy console.

- Video call functionality will not work for users when the presence privacy setting is enabled.

Note: After you create an Enterprise, you cannot edit the Enterprise ID field. However, you can delete the Enterprise and start over.
You can also do the following from this page:

- Click the Add an Enterprise link to create a new Enterprise.

- Click the Delete This Enterprise link to delete an Enterprise.

  To delete an Enterprise:

  1. Select the Enterprise from the list box.

  2. Click the Delete this Enterprise link. A dialog box appears prompting you to confirm the deletion.

  3. Click OK to delete the Enterprise, or click Cancel to cancel the deletion.