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 want 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

Introduction

The MachSol Signature Agent is a newly introduced, premium add-on for MachPanel (version 8 and above) designed to automate and manage email signatures across Microsoft Exchange environments.

• Key Features and Configuration Overview
  • Centralized Signature Management: Enables administrators to define and enforce consistent email signature policies across all users within specified Exchange Server Groups.
  • Transport Agent Integration: Utilizes a transport agent to append signatures to outbound emails, ensuring uniformity and compliance.
  • Secure Key Implementation: Employs a 32-character alphanumeric secure key to authenticate and authorize signature operations across servers.
  • Customizable Settings: Configuration is managed via a Settings.json file, allowing customization of parameters such as:
    • WebServicePath: URL to the MachPanel web service endpoint.
    • LogMode: Defines the logging level (e.g., Simple).
    • EWSUrl: Exchange Web Services URL.
    • SecureKey: The aforementioned secure key

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.

Management

First you have make sure that Signature allowed for Mailboxes (using Transport Agent) is allowed in Service Plan or in the particular Exchange Subscription, You can review the Exchange Subscription interface for any particular Exchange Organization (Click Subs Id of that organization) and then under Resources tab click Edit Resources and make sure below resources are available.

​

Then navigate to Service Director > Exchange Hosting > Accounts and then click 'Manage' as Exchange Organization. Under the Management interface click "Rules" tab.

You can give the Name of Signature, Set the priority and then select the mailbox to apply this signature.

​

You have two option either you can Signature HTML or Signature Text.

Also you can add custom variable for each user/mailbox like (Display Name, Phone and Department etc.).

Then click Save button to add the signature.