Set Up Thunderbird With JumpCloud LDAP Protocol

By Greg Keller Posted February 25, 2015

If you’re a sysadmin or devops guy, configuring—and learning to configure—various components of IT infrastructure is a huge part of your job. To make your life easier, we’ve documented exactly how to configure Mozilla Thunderbird with JumpCloud’s lightweight LDAP agent. This allows businesses with existing LDAP directories a bridge to the cloud in a hybrid on-premise-in-the-cloud system. Ready to get started?

Follow these six simple steps, and you will be good to go:

  1. Download and install Mozilla Thunderbird (mozilla.org/en-US/thunderbird). After creating a new account, scroll to the menu bar and click on the “Address Book” tab.
thunderbird address book
  1. From the “Address Book,” scroll up to the main Thunderbird toolbar and select “File,” then “New,” then “LDAP Directory.”
thunderbird new ldap
  1. The box below will pop up. Here, input the following:

Name: (SELECT A NAME)

Hostname: ldap.jumpcloud.com

Base DN: Input as: ou=Users,o=<YOUR ORG ID – SEE BELOW>,dc=jumpcloud,dc=com

Port: 636

Bind DN: Input as:

uid=<YOUR BIND USER – SEE BELOW>,ou=Users,o=<YOUR ORG ID – SEE BELOW>,dc=jumpcloud,dc=com

Use Secure Connection: Check this box as you’re using port 636 per above.

thunderbird port number
  1. Click “OK” button.
  2. Ok, next create an administrator account in JumpCloud and log in. This is where you’ll get the Bind User number to input in the “Bind BN” prompt (SEE #3) and “Org ID” (SEE #3) needed for Thunderbird to properly configure with JumpCloud.

Bind User: In your JumpCloud user directory, create a User. (Many of our customers call this User, “Service Account” or “LDAP account.”) Make sure to finish the User registration process by opening the verification email that will be sent to the email address you indicated for this new User account. When registration is complete, go into that User account and click “Details,” then select THIS checkbox (SEE RED ARROW BELOW):

LDAP binding user service account

Org ID: As for Org ID, you will find this in the “Settings” tab of your JumpCloud console. It will be exposed when you turn “LDAP Service” to the ON position. The Org ID is unique to your company.

LDAP service enable

Please note that we have extensive documentation on how to configure LDAP in our Knowledge Base found here:

http://support.jumpcloud.com/topics/65247-5-hosted-ldap

  1. Now, go back to Thunderbird. Having followed the #3 instruction and correctly filled out the LDAP configuration, you can now input terms into the Search Bar. For the purposes of this demonstration, we’ll use the name “Greg.”  Next, you will be asked for a password (SEE BELOW), which is the same password used for the Bind User, as explained.
LDAP password

Results will pop up for of any user in my LDAP directory that has the string “Greg” associated with it. (SEE BELOW)

address book

There you go! Now you have a bridge to the cloud in a hybrid on-premise-in-the-cloud system. Enjoy!

Have any further questions? Reach out to us via twitter.

Greg Keller

Greg is JumpCloud's Chief Product Officer, overseeing the product management team, product vision and go-to-market execution for the company's Directory-as-a-Service offering. The SaaS-based platform re-imagines Active Directory and LDAP for the cloud era, securely connecting and managing employees, their devices and IT applications.

Recent Posts