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 mailbox to use, or you can choose an existing one
    3. Go to 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. Examples of configuration that are viewable are server configuration, transport configuration, database configuration, and organization-wide configuration.
    Members
    Select the previously created or chosen account with 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 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.) It will again prompt for 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 is granted, it will proceed to 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 take effect.

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.