Summary

This article provides details on how to configure Signature Agent.

Note:

This is a new and additionally paid feature, licenses for which can be acquired from MachSol Customer Portal / Store. Please contact MachSol Sales for more information.

Applies To

MachPanel build version 8 and above

Pre-Requisites:

To be installed on all Exchange Servers:
Required Exchange Server Version: Exchange Server 2019 version 15.2.1544.4 - 15.2.1748.24

(If you do not with to update to latest CU for Exchange, Please contact Support after purchasing license to deploy on older version of Exchange)

https://learn.microsoft.com/en-us/exchange/new-features/build-numbers-and-release-dates#exchange-server-2019

MachSol Signature Agent Configuration

Below are MachSol Signature Agent configuration steps:

Step - 1: Server Group Signature Settings

• Please configure Server Group Signature Settings by navigating to following path: Home > Service Director > Exchange Hosting > Exchange Server Groups
• Select options against desired Server Group and Select Signature Settings:

​

• Check the box against: Server Transport Agent Signature enabled.
• Input Comma separated IP Addresses of Exchange servers: example 10.2.210.13,10.2.210.14.
  Note: The MachSol Signature Agent have to be installed on all Exchange Transport servers and Private IP must be mentioned for all servers.
• Input Secure Key (32 Characters Alpha Numeric) and note the value. Example X7P9G2LQF5T1M8WZK4V6D3CYRJ0BNSAH

​​

Step - 2: Download the attached file and copy MachSol Signature Agent Folder to 1st Exchange Transport server, example 10.2.210.13.

• Update "MachSol SignatureAgent\Settings.json" as per your environment.
  {
      "WebServicePath": "https://YourPanelURL.com/webservices/ExtAgent.asmx",
      "LogMode": "Simple",
      "EWSUrl": "https://localhost/ews/exchange.asmx",
      "SecureKey": "Type32CharsSecureKeyHere"
    }


• Update YourPanelURL.com with your MachPanel Control Server url, make sure the web service is accessible by opening the url in browser.
• LogMode: "Simple" for basic logging, "Verbose" for detailed logging.
• EWSUrl: EWSUrl of local Exchange Server, no need to change if default installation is same.
• SecureKey: Mention the Secure Key Set in Server Group Settings example: X7P9G2LQF5T1M8WZK4V6D3CYRJ0BNSAH
• Allow "Network Service" full permissions on the "MachSol SignatureAgent" folder and sub folder and files. If the Exchange Transport Service is running under another user then "Network Service", allow that user full permissions on the "MachSol SignatureAgent" folder.

Step - 3: Install Signature Agent

• To install Signature Agent, please update AssemblyPath "C:\MachSol SignatureAgent\MachSol.SignatureAgent.dll" according to the location of MachSol SignatureAgent folder on your system in below commands:
• Copy below commands and run on Exchange Shell:
  Install-TransportAgent -Name "MachSolSignatureAgent" -AssemblyPath "C:\MachSol SignatureAgent\MachSol.SignatureAgent.dll" -TransportAgentFactory "MachSol.SignatureAgent.AgentFactory"
  Enable-TransportAgent "MachSolSignatureAgent" 
  Set-TransportAgent "MachSolSignatureAgent" -Priority 6
  Restart-Service MSExchangeTransport

Step - 4: Copy the MachSol SignatureAgent From 1st Exchange Server to all other Exchange Servers

Copy the MachSol SignatureAgent folder from 1st Exchange Server, example 10.2.210.13 to all other servers and run the commands mentioned in Step - 3.