Skip to content

Hybrid On-Premise with Exchange Online

By linking your Hybrid On-Premise and Exchange Online account with Hire2Retire, you can authorize RoboMQ to have a delegated access on your behalf to both applications. Hire2Retire needs the following permissions on your account to provide a seamless integration experience:

Microsoft Exchange Online

Feature Role Explanation
Azure AD Distribution List Distribution Groups Read and Write Azure AD distribution lists.
Microsoft O365 Groups User Administrator, Mail Recipients Read and write on Microsoft o365 groups
Mail-Enabled Security Groups Security Group Creation and Membership Read and write mail enabled security groups.
Shared Mailbox User Administrator Read and write on mailbox.

The specified permissions should be included in a role group that the service account is being assigned to.

Create a Connection

Hybrid On-Premise Service Connection

Hire2Retire requires the following details to create a OnPremise Service Connection

  • Connection Name - A user defined nomenclature for your connection. By default, the connection name is "Connection-OnPremise Service", you can change the name as per your preferences.
  • Host - The host name is the IP address of your Active Directory Server.
  • Port - The TCP/IP port on which the Active Directory server is listening. Hire2Retire will only establish the LDAP connection with the SSL port. (The default is 636)
  • Base DN - It is a collection of objects that Hire2Retire will access within an Active Directory network. An object can be a single user, a group of users or a hardware component, such as a computer or printer. Each base DN holds a database containing object identity information. It should be given in the format "DC=example-domain,DC=com"
  • Public key of RSA key pair - RSA public key which will be used to encrypt the config file. To know the detailed steps to generate RSA key pair, click here.

OnPremise Service Connection

Figure 1. Hybrid On-Premise Service Connection


OnPremise Service Connection

Figure 2. Hybrid On-Premise Service Connection for Multi Domain Controller

If you are configuring a connection with multi-domain controller setup, you can provide host values for each domain controller in your AD along with their respective base DN and port. You can also provide comma separated list of IP/host addresses for each domain controller.


After filling in the credentials you need to clicks on the "link account" button. After account is successfully linked, follow the Instructions given below to setup Active Directory On-Prem Agent.

Instructions to set up On-Prem Agent

Figure 3. Instructions to set up On-Prem Agent

Exchange Online Connection

To establish Exchange Online connection, you need to have an Azure AD service account existing in a role group with neccessary permissions mentioned above.

Hybrid with Exchange Online Connection Name

Figure 4. Hybrid On-Premise with Exchange Online Connection set up

Here are the permissions requested by Hire2Retire from your Microsoft Exchange Online account:

Permission requested from Microsoft Exchange Online

Figure 5. Permissions requested from Microsoft Exchange Online