Summary

This article provides step by step guide on how to Activate License for MachSync Utility.

Applies To

This article applies to MachSync v1.0

Pre-Requistes

Before you can activate MachSync License, you need to download and install MachSync v1.0. Please review below KB:

MachSync Installation Guide

What is MachSync?

MachSync is a software which contains a windows application, a windows service, windows module extension and some related libraries. Main purpose of MachSync is to synchronizes multiple active directory identities (Users & Groups) data.

Why MachSync?

MachSync supports Cross Forest multi-targeting Active Directory user synchronization. It refers to the process of synchronizing user accounts across multiple Active Directory (AD) forests. In large organizations or those with complex IT infrastructures, it's not uncommon to have multiple AD forests due to mergers, acquisitions, or other reasons. Each forest might have its own set of user accounts, groups, and resources.

Synchronizing user accounts across these forests allows for a unified identity management system, enabling users to access resources in any of the forests with a single set of credentials. This synchronization typically involves replicating user account information, including attributes such as usernames, passwords, group memberships, and other relevant data.

The goal of MachSync is to manage and simplify cross-forest multi Active Directory synchronization and is to streamline identity and access management, improve security, and enhance user experience by providing seamless access to resources across disparate AD forests.

Understanding MachSync?

MachSync Active Directories in MachSync context can be classified as either ‘Source’ or ‘Target’ active directories and are explained below.

Note: The active directory domains are defined as Source and Target for ease of understanding. In case of Two Way Sync, the concept becomes void as change in any AD will be pushed to other AD configured.

Source Active Directory (Client or Originator)​​

This is AD from where it is required to sync/push data to other active directories to make identities data consistent across multiple ADs. There it is required to define ‘Sync Templates’ and ‘Profiles’.

• What are Templates?
  • Template is set of configurations, where it is defined that what data of identity will get synced ,  in which fashion it will sync (like keeping nested OU structure or not, copying source UPN suffixes and etc..) and what license type rules will be applied to template (if there are multiple type of licenses purchased).
• What are Profiles?
  • Profile is defined mapping of source and target ADs. Where it is defined that from which source organization to which target Organization data will get synced and applying sync rules from selected template. It also get configuration for whether to sync security groups also, and also takes custom filter for excluding unwanted identities from sync.

Target Active Directory (Host or Destination)

This is AD which expects data from source AD to synchronize into specified identities under specific Organizations. On target AD, we first need to define one or more Endpoints.

• What are Endpoints?
  • Endpoint in MachSync on target machine is a configuration of group of selected Organizations, which are exposed for identities data capture/catch. By defining endpoint, it is specified that which Organizational Units will capture/sync-into data from source(s) AD(s).
• There is no license required for target machine.​​

MachSync License Activation

Before License Activation

Once MachSync is installed then default dashboard page will appear.

​

You will not be allowed to navigate to Templates and Profiles sections.

Steps to activate license

You can either purchase license or request a trial.

If you click on "YES" new page will open, from MachSol Website Store and allow you to generate license.

First you have to Sign In using your registered account:

You will be taken to License Generation Page to get a trial license:

Copy the license information "Installation ID" and "Machine ID" from MachSync License page:

​

This will generate your Trial License Key:

Press the "Copy to Clipboard" button and the License key will get copied:

On the MachSync utility, under License section, click the "Update" button and paste the License Key:

Click on Apply and your Trial License gets applied:

​

Now you can continue and access the blocked items:

Configuration

The next step after the installation and license activation is the configuration of MachSync using below KB article:​

MachSync Configuration Guide