# Configure MiCollab IDS for MiVoice 5000

If you are installing a new MiCollab system on a site with a directory service database, you can use IDS to seed the MiCollab Client directory with the corporate contacts from the directory service:

- For single MiVoice 5000 system sites, the directory service can run on the MiVoice 5000 or on a separate Active Directory server.

- For multi- MiVoice 5000 system sites, the directory service can run either on a standalone Active Directory server or be provided by the MiVoice 5000 Manager.

After initial configuration, the MiCollab Client directory receives corporate contacts updates from the directory service during scheduled database synchronizations.

Note: Do not use the IDS connection to Active Directory to create users in MiCollab. Create users from the MiVoice 5000 Manager first and then synchronize them with the MiCollab database in order keep the data in sync. After you synchronize MiCollab user data (that was created from the MiVoice 5000) from Active Directory, the directory attribute fields are added to the user.

To configure MiCollab IDS for MiVoice 5000 deployments:

1. Review the General Guidelines and Limitations.

2. Create a MiCollab synchronization account on the directory service domain. The account must have read access.

3. If Active Directory Authentication is required, you must create the IDS Connection to an Active Directory server. Ensure that a valid Certificate Authority (CA) has been configured for Active Directory. If Authentication is not configured, you must assign users new passwords from the communications platform.

4. You can create a connection to the MiVoice 5000 directory service to update the MiCollab database with the MiCollab Client contacts from the directory service (within the MiVoice 5000 ) and/or create a connection to the Active Directory server to obtain extra attributes. You also have the option of connecting to an Active Directory server to support authentication of MiCollab users.

   Note: You can only use one single set of attribute mappings for the entire system, so you must choose between getting contacts from the MiVoice 5000 or extra attributes from the Active Directory server. You cannot have both.

   - Under Configuration, click Integrated Directory Service.

   - Click Add connection. The Add Integrated Directory Service connection page opens.

5. Complete the fields to create a connection. See Manage IDS Connections for field descriptions. At a minimum, you must

   - Set the Directory Server Type to "MV5000/MV5000 Manager" for MiCollab Client contacts

     or

     Set the Directory Server Type to "Active Directory" for the additional attributes.

   - Enter the FQDN or IPv4 Address of the primary directory server.

   - Enter the primary directory server username (in DistinguishedName field) and password.

   - For Active Directory authentication select Enable Authentication.

   - For additional directory attributes select Enable Synchronization for the connection to the Active Directory server.

   - For both Active Directory authentication and extra directory attributes, select Enable Authentication and Enable Synchronization for the connection.

   - Set the Connection Method to TLS.

   - Click Save. MiCollab verifies the connection parameters and indicates if any errors are present.

6. Configure Authentication for user entries, if required. The Enable authentication check box should not be checked for MiVoice 5000 and Generic LDAP integrations.

7. If your server is using the default LDAP attributes, you do not need to modify the IDS Attribute Mappings. If not, clear the Use default attribute mappings box and then map the LDAP attributes to the following IDS attributes: Distinguished Name, First Name, Last Name, and Email. All other fields can have blank LDAP Attributes.

   Note: Ensure that the contacts on the directory service contain entries in the fields that map to the following IDS attributes: Distinguished Name, First Name, Last Name, and Email.

8. Configure the contacts on the directory server.

9. Schedule synchronizations with the directory server database to occur on a regular basis during off-business hours (for example: daily at 12:00 am). These re-occurring synchronizations keep the MiCollab database up to date with changes that are entered on the directory server.

   - Under Configuration, click Integrated Directory Service.

   - Click Edit next to the directory service connection. The Manage IDS connections page opens.

   - Ensure the Re-initialize on next cycle box is clear.

   - In the Schedule field, set the schedule using the drop-down menus.

   - Click Save.

10. Perform an initial synchronization:

    - Under Configuration, click Integrated Directory Services.

    - Click the Sync link of the connection. The synchronization status is displayed at the top of the screen.

    - After the synchronization is complete, the contacts from the directory server database are added to the MiCollab Client corporate directory.

    - If you configured authentication, any users with an email address will be sent a Welcome E-mail. The e-mail instructs the users to log into their MiCollab application interfaces using their directory service credentials

11. After the synchronization is complete, view and manage the detained updates from the MiVoice 5000 administration interface.

Parent topic: Programming