Configure Active Directory Username Lookup

Where a server is joined to an Active Directory domain, and when ZeeDrive starts-up on the server, ZeeDrive will automatically look-up the user's ZeeDrive username from Active Directory.

By default, ZeeDrive will look up the username from the user principal name Active Directory property. ZeeDrive will then validate the username is set-up on the ZeeDrive subscription.

Typically, in most environments, the Active Directory user principal name attribute should match the user's Microsoft 365 username, and hence their ZeeDrive username.

But, you may have an environment where this is not the case. The Active Directory user principal name may be set to a different domain to the Microsoft 365 domain, and you do not want to change this on your Active Directory.

An example where a user's user principal name may be set to some other domain than their Microsoft 365 domain

This will cause an error for ZeeDrive when it starts up as it will fail to verify the user is set up on the subscription as the Active Directory user principal name does not match their ZeeDrive username.

Through the ZeeDrive Administration Console, you can configure ZeeDrive to use an alternative Active Directory attribute from which to look up their username. For example, you can configure ZeeDrive to look up the username from the mail attribute instead.

The mail (E-mail) attribute for this particular user is set to [email protected] in Active Directory. ZeeDrive can be configured to lookup from mail instead of user principal name

Here's how to change the lookup attribute:

1

From the Administration Console, click the action button then click the "Manage hot desk computers and desktop servers" option

2

Click the "Choose an action..." button then click the option "Configure the AD attribute for username lookup"

3

ZeeDrive will show the current lookup attribute name. If you haven't yet changed it, it will be set to the default, userprincipalname. Enter the new lookup attribute and then click the Update button

4

In this example, I changed the lookup attribute to mail. On clicking the Update button, the busy indicator will show whilst ZeeDrive updates the attribute

5

The green tick mark will show after ZeeDrive has successfully updated the lookup attribute. When users next sign in to the server, ZeeDrive will use the new attribute name to lookup their username from Active Directory

Last updated