Introduction


You use the Xink Exchange Connector to configure integration between Xink Cloud and your local on-premises Exchange server when you want to keep email signatures updated for.


  • Mobile devices
  • Outlook (browser)

  

The Xink Exchange Connector keeps the users in your local settings database in sync with your users in Xink Cloud.


This is only needed if you want to add email signatures when sending emails from mobile apps through your Exchange Server. 

Examples are Outlook for iPhone, iPhone Mail app etc.


  • NOT required for Outlook (desktop) email clients


Check out our infographic on this topic and FAQ - Exchange Connector.


Current release: v 1.0.4 January 19, 2017


Getting started


First download the Exchange Connector installer. You need to install it on a server in your domain.


Start the installer file and open the Configuration program:



The Configuration program will start elevated so you need to approve the program to start. Windows will ask you for this permission.


This will start the main menu of the Xink Exchange Connector Configuration:



Connect to the Settings database


First you need to connect to your local settings database. If you are using eMailSignature already, you just need to get your connection string and Exchange Connector will connect to this database.


If you do not have a local setting database, you need to create it in your SQL Server. Use this SQL create script to create it and you will need to construct the connection string yourself.


Enter the connection string in "Connect to the settings database"  and click “Test” to test if the connection string is correct.


Click “Save” to save and exit to the main menu.


 


Connect to Xink Cloud


Next you need to connect to Xink Cloud so that the Xink Exchange Connector can pull your users from Xink Cloud to your local settings database.


First you need to create an API user in Xink Cloud.


  1. Go to http://app.xink.io and sign in with you administrator credentials.
  2. Go to the settings menu (the cog-icon at the top-right corner) and choose “Admins”.
  3. Click “API Users” in the list to the left.
  4. Create a new API user by clicking the “+” button at the top right.


Now that you have created an API user you are ready to connect to Xink Cloud.


In Xink Exchange Connector enter the username and secret of your API user.  

Click “Test” to test the connection and “Save” to save your settings and exit to the main menu.



Start the Synchronization


After you are done with the configuration it is time to start the synchronization of users in Xink Cloud to the local settings database.


To synchronize, all you have to do is run XinkExchangeConnector.exe without any switches. This file is located in the installation folder. If you have not changed this during installation, it will be in your program files folder under sub folder "Xink Exchange Connector".  You should set it up to run as a Windows scheduled task to keep the users synchronized on a regular basis, e.g. once per day.


Xink Exchange Connector will only work on machines on your domain and it must run in the context of a user that is allowed to look up users in the Active Directory. This is necessary because the Xink Exchange Connector needs to look up the SAMAccountName in the AD. 


Note that Xink Exchange Connector will always overwrite whatever is in the local database with data pulled from Xink Cloud.


Status Monitor


The Status Monitor will show you any errors pertaining to pulling users from Xink Cloud or to running signOWA. You search for specific users by entering a search text and hitting “Enter” or clicking “Search”.


Set up mobile rules


Mobile Rules are used with the Exchange Filter. The Exchange filter works as a gateway solution. 


When an email is sent, the filter analyses the text and finds out if a signature needs to be added or replaced.


The Exchange Filter searches the email body for text rules created in the Mobile Rules module. If a rule text is found, it will be replaced with the user’s signature by the Exchange Filter.


You create a new rule by clicking the “Add new rule” button.  Enter a name and a description for the rule.  In the rule text field, enter the text to be replaced by the Exchange Filter.  

For example, you may put “((iphonesignature))”.  The Exchange Filter will then replace “((iphonesignature))” with the user’s signature when an email is sent with “((iphonesignature))” in the email body.


Click the pencil icon or double-click and item in the list to edit it. Click the trash icon to delete the item. Your changes will not be saved until you click “Save”.



Set up OWA


This is where you configure signOWA. signOWA is used for setting the signatures in OWA of your on-premise Exchange server.


You need to know the version of your Exchange server, whether it is using Forms Based Authentication or Windows Authentication, and if it is using SSL. You also need to put in the internal URL of OWA. Check the “Remove images in your Outlook Web signature” checkbox if you are having problems with images not showing in your OWA signatures. This happens on some Exhange servers due to a Microsoft bug.



Click “Save” to save your settings. Run signOWA.exe to check your settings.