The EmaiI Signature Web Portal - Help Center

IT Pro: Deployment of Xink Add-in (Microsoft 365)

This article is intended for use by the Microsoft 365 administrators, IT Administrator, and Systems Administrator.

Follow these steps to mass deploy the Xink Outlook add-in to your employees. The purpose of this Add-in is to have multiple signatures for Outlook on the Web. The add-in only works with Microsoft 365 Exchange Online and does not work with On-Premise Exchange.

Unattended deployment via Powershell

The Powershell scripts must be executed on PowerShell ISE as an administrator.

The user account executing the deployment script mentioned below must have 'Application Impersonation' rights.

To grant Application impersonation rights:

1. Sign in to Microsoft 365 Admin Center

2. Create an account with a mailbox to use, or you can choose an existing one

3. Go to the Exchange Admin Center

4. Navigate to Permissions > Admin roles, then click on '+' to add a new role

5. Fill up the for to add a new role

Name
specify the name of the group, e.g. ‘XINK365.
Roles
select ‘ApplicationImpersonation’ and ‘ViewOnly-Configuration* role:
Impersonation management role enables applications to impersonate users in an organization to perform tasks on behalf of the user.
ViewOnly-Configuration management role enables administrators to view all the non-recipient Exchange configuration settings in an organization. Viewable examples of configuration are server configuration, transport configuration, database configuration, and organization-wide configuration.
Members
Select the previously created or chosen account with a mailbox for performing the admin roles specified above

6. Click on Save to add the new Admin role.


Part 1 - Download Xink-in files

Download the PowerShell scripts from -> https://downloads.xink.io/outlook/addin and extract the files.
The downloaded zip file 'XinkOutlookAddin' contains a file name "XinkOutlookAddinManifest.xml" and two PowerShell scripts for step 3.


Part 2 - Deployment of the Xink-in

Login to Exchange admin center > Organization > add from file and upload "XinkOutlookAddinManifest.xml"

Edit Xink Addin and select Optional, enabled by default or Mandatory, always enabled and then Save.

NOTE:


Part 3 - Deployment of Xink Domain Token

You need to obtain Xink 'DomainAuthToken' from Xink portal.


Login to Xink portal and copy the Xink Token here -> https://auth.xink.io/DomainToken

Click the icon to the right:


Locate the two PowerShell scripts files from the zip-file you downloaded from Step 1:


1.) Start Windows PowerShell ISE as an administrator.
2.) Now open or load the PS script "Load-Exchange-Session.ps1" and run it. You will be prompted to log in to your Microsoft 365 account (enter the PIN if MFA/2FA is enabled).

3.) Input code sent by Microsoft if prompted.

4.) It will execute the command for a while to install the required module.

5.) Open or load PS Script "Set-XinkDomainToken.ps1" and run it. It will prompt for the Xink domain token that you copied from https://auth.xink.io/DomainToken.



6.) Again, it will prompt your Microsoft 365 admin credential and may prompt you to provide permission if this is your first time to execute. Tick 'Consent on behalf of your Organization'.


7.) Once credentials are entered, and permissions are granted, it will inject the DomainAuthToken to user mailboxes. This may take a while, depending on the number of mailboxes. (see the preview of users)

8.) Notice the last line "Done!", It means 'DomainAuthToken' applied to all Xink Add-in users.


Note: For Outlook on the web, you need to refresh the Internet browser before any changes occur.

In case of additional users in the future, the PowerShell script will need to execute again to apply the DomainAuthToken for the new mailboxes.


Xink Add-in individual deployment


For Outlook on the Web

1.) Click New Message and click '...'.

2.) Select Admin-managed and find Xink Add-in, then click Add (this will initiate the installation).


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.