January 27, 2023

Added Windows Server 2022 to the list of supported versions in the Windows and Active Directory Requirements section.

October 4, 2022

Added additional information to the Map User Attributes section about how to map alternative email addresses.

August 25, 2022

Added new attribute mapping to Active Directory and cloud attributes. This attribute mapping is only needed if you are bringing Azure AD users into AD on-prem before syncing them to Webex.

August 8, 2022

• Added new sections Remove User Attribute Mapping and Manage Profile Pictures.

June 28, 2022

• Added definitions of Objects Matched and Mismatched Objects to the section Do a Dry Run Synchronization on Your Active Directory Users describing the Summary of the report.

April 15, 2022

• Added new section Delete Users Permanently After Soft Delete.

October 18, 2021

• Changed "Webex Teams" references to "Webex App".

• In Prepare and Deploy chapters, added details about group synchronization for license assignment.

July 14, 2020

• Updated information on what to do when trying to claim users in Conflicting User Email Accounts.

June 18, 2020

• Updated a step in Choose Active Directory Objects to Synchronize to include how to customize attributes for room data (release 3.6).

• Updated Directory Connector download link in Install Directory Connector

June 2, 2020

• Added userAccountControl and ds-pwp-account-disabled attributes to the table in Active Directory and cloud attributes.

April 21, 2020

• Added a note in Do a Full Synchronization of Active Directory Users Into the Cloud to clarify that the auto-assign license template only applies to new users, not updated users.

February 5, 2020

In the "Do a Full Synchronization of Active Directory Users Into the Cloud" topic, clarified some inaccurate text about deletion.

December 13, 2019

• In the sections on proxy configuration and troubleshooting Cisco Directory Connector, changed URL references from cloudconnector.cisco.com to cloudconnector.webex.com.

November 8, 2019

• Added the following information to the "Choose Active Directory Objects to Synchronize" section:

  • If you want to synchronize just users in a certain group, for example, you must enter an LDAP filter in the Users LDAP filters field. If you want to sync users that are in the Example-manager group, use a filter like this one:

    (&(sAMAccountName=*)(memberOf=cn=Example-manager,ou=Example,ou=Security Group,dc=COMPANY))

• Added more account permission details and screenshots to the "Installation Requirements for Cisco Directory Connector" section.

October 29, 2019

Added Windows Server 2019 support in Windows and Active Directory Requirements.

October 18, 2019

Added new section Sizing Information.

October 8, 2019

• Added new section: Send Email Reports on Directory Synchronization Results (release 3.5).

• Updated Run an Incremental Synchronization with more information about how an incremental synchronization works (compared to a full synchronization). Also updated the default interval from 30 minutes (releases prior to 3.5) to 4 hours (release 3.5 onward).

• Updated Enable Troubleshooting for Directory Connector to mention the new location of log files (release 3.5).

• Updated Conflicting User Email Accounts with a link to the Convert User steps in Control Hub.

• Added new section: Directory Connector Crashes During SSO Sign In

June 26, 2019

• Added a new section: Recover Accidentally Deleted Users.

• Updated Map User Attributes with attributes that are connected to people insights and contact cards in Webex Teams.

• Updated Active Directory and cloud attributes with "Extra Notes" about each attribute.

May 20, 2019

We released Cisco directory connector version 3.4. For an existing installation, you'll see an upgrade prompt. For a new installation, use the steps and links at the top of the release notes.

This release contains the following feature updates and enhancements (and corresponding documentation updates):

Diagnostic Tool

You can use the built in diagnostic tool to troubleshoot your Cisco Directory Connector deployment. If synchronization didn't work properly, you may have a configuration or network error. This tool tests your connection to Active Directory so that you can diagnose errors yourself before contacting support. See Run the Diagnostic Tool for more information.

Secure LDAP (LDAPS)

Cisco Directory Connector now supports LDAPS as a communications protocol between your Active Directory and a Domain Controller. LDAP is the default, but you can choose LDAPS in the general settings for secure and encrypted communications. See Configure General Settings for Directory Connector for more information.

Enhancement to Attribute Verification Messages

Cisco Directory Connector verifies the attribute value of uid in the cloud identity service and retrieves 3 available users under the filter options that you chose. If all of these 3 users have a valid email format, the software shows you a verification pop up. If any errors appear during this test, you'll see a warning message. See Map User Attributes for more information.

February 18, 2019

Cisco Directory Connector 3.3 contains the following new features:

Customized Attributes

Directory Connector can now support expression-based attribute customization. Previously, the application had several predefined hard-coded combinations to support customer requests such as "GivenName SN". When customers had different requests for the attribute combination, engineering needed to add it manually. This feature gives more flexibility by letting you define your own attribute combination.

See the following sections of the documentation for further guidance:

• Map User Attributes (Updated)

• Expressions for Customized Attributes (New)

• Active Directory and cloud attributes (Updated)

• Change Webex App Username Format After Directory Synchronization (Updated)

Kerberos Proxy Support

Directory Connector can read the proxy configuration in the local network proxy. In Windows system, the app leverages the configuration in the internet network options.

Embedded Avatar profile synchronization

The new connector application can read the avatar raw image binary data and sync to the Cisco Webex cloud.

See the following documentation updates:

• Synchronize Directory Avatars From an Active Directory Attribute to the Cloud (New)

• Synchronize Directory Avatars From a Resource Server to the Cloud (Updated)

More AD attributes can map to UID

More and more customers want to manage the AD attributes to map to the cloud uid. In this version, you can freely map an attribute to the uid. Our recommendations are still to use email or UserPrincipleName. When you choose attribute instead of the proposed ones, the app pops up an alert to remind you that the value to map from must be in email format.

See the following documentation updates:

• Map User Attributes (Updated)

• Active Directory and cloud attributes (Updated)

Automatically Upgrade to the New Version

It's important to keep your Cisco Directory Connector updated to the latest version. In 3.3, you can let the application do an automatic upgrade when a new version is ready. You just check a checkbox and then the app can do the installs silently. If you change your mind, you can go back to the configuration setting to uncheck the function.

See the following documentation updates:

• Set Automatic Upgrades (New)

• Upgrade to the Latest Software Release (Updated)

Credentials to access URL based avatar files

You may manage avatar resources in a web resource server where credentials are required. In the new version, you can provide the credentials before synchronization and then the Directory Connector can sync up all avatar data to the cloud.

See the following documentation updates:

• Synchronize Directory Avatars From a Resource Server to the Cloud (Updated)