Search

InterAction® Web Client Answer Center

Install the InterAction Admin Tool

  • Updated

The process to add the Microsoft Outlook to InterAction Sync - Graph API from the InterAction Admin Tool begins by running the installer, choosing between HTTP or HTTPS protocols, and providing the necessary database and certificate details. After successful installation, you configure the Microsoft Outlook to InterAction Sync settings by entering Graph API credentials and setting default process values, with additional guidance available for updating certificates or changing the port if needed.

  1. Double click on installer and it will prompt the screen to choose Microsoft Outlook to InterAction Sync-Graph API.

     InterAction Administrator Tool - Custom Setup

  2. Choose the unencrypted HTTP protocol or the encrypted HTTPS protocol. Enter the selected Port and the Certificate Thumbprint if HTTPS is selected. InterAction Administrator Tool - Select HTTP/HTTPS
  3. Select the radio button based on your current database information.  If you have an initialized InterAction database, select the first option.  If you do not have an initialized InterAction database and want to create a new database, select the second option. InterAction Administrator Tool - Check for database
  4. Enter the existing database server name and database name. InterAction Administrator Tool - Microsoft SQL Server Connection

  5. Continue with the installation.

    InterAction Administrator Tool - Confirm User Data FolderInterAction Administrator Tool - Set Windows Security OptionInterAction Administrator Tool - Begin InstallationInterAction Administrator Tool - Installation StatusInterAction Administrator Tool - Installation Confirmation

  6. Once you completed the installation successfully, log in to InterAction Administrator and go to Process Schedule and Results. Click on the New button to create a new process.Process Schedule and Results - New Process

  7. Select the new Microsoft Outlook to InterAction Sync - Graph API process from the dropdown menu.

    Click on Edit Process Settings and fill the Graph API Credentials: Application ID, Tenant ID and Client Secret Key. Click OK when done.

     Microsoft Outlook to InterAction Sync Settings - Graph API

  8. Once you created the new Graph O2C Process, you can see the process under the Process Schedule and Results page.

    Go to Set Process Defaults and fill the Application ID, Tenant ID and Secret Key for future use. These credentials will be used as default values whenever you create new processes. Set Process Defaults

    Microsoft Outlook to InterAction Sync Settings - Graph API Synchronization ModeEdit Scheduled Process

  9. You can run the Microsoft Outlook to InterAction Sync-Graph API process for both Contact and Calendar events as you would for the MAPI process.

    Manage Process Schedule

  10. A message will display under the Synchronization tab when users enter the Exchange Server address and chooses Check Account.

    If the Exchange Server Name starts with https, the Check Account button should grey out and a message displayed to the right saying:

    "The Check Account function is not available for mailboxes synced via the Graph API"

    If the Exchange Server Name does not start with https, the Check Account button will be enabled, and no message will be displayed.

     Edit User Contact List

Frequently Asked Questions

How do I change the certificate after installation?

If you want to use a different certificate, first install it in Windows.

After installation, follow these steps to remove the old certificate assignment, create a new one, and update the registry:

  1. Open an elevated command prompt and enter the following commands, replacing <Port Number> with the port number and <New certificate thumbprint> with the new certificate's thumbprint.
  2. Remove the current certificate assignment: 
    • netsh http delete sslcert ipport=0.0.0.0:<Port Number>
  3. Add a new certificate assignment: 
    • netsh http add sslcert ipport=0.0.0.0:<Port Number> certhash=<New 
      certificate_thumbprint> appid= {df496788-318e-435c-8a79-a0386eb5c241}
  4. Update the registry to use the new certificate: 
    • reg add "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Interface 
      Software\Connection Settings" /v O2CGraphHttpsThumbPrint /t Reg_Sz /d <New 
      certificate_thumbprint>  /F

You may need to reboot the server after completing these steps.

How do I change the port after installation?

To change the port after installing the Admin tool, you need to delete the old port assignment and create a new one in both the registry and a configuration file. Follow these steps, replacing <Old Port Number>, <New Port Number>, and <certificate thumbprint> with the correct values:

  1. Delete the old port assignment:
    • netsh http delete sslcert ipport=0.0.0.0:<Old Port Number>
  2. Create a new port assignment:
    • netsh http add sslcert ipport=0.0.0.0:<New Port Number> certhash=<certificate_thumbprint> appid={df496788-318e-435c-8a79-a0386eb5c241}

Update the Registry:

  1. Click Start, type regedit, and press ENTER.
  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Interface Software\Connection Settings.
  3. Edit the key named O2CGraphAPI to include the new port number in the URL (e.g., change 8150 to the new port number).  

Update the Configuration File:

Launch Notepad as Administrator and open LexisNexis.O2C.GraphAPI.exe.config located in C:\Program Files (x86)\LexisNexis\InterAction\ServerProcesses\GraphRestApiService.

  • If using HTTPS, find the setting named HttpsPort and change its value to the new port number.
  • If using HTTP, find the setting named HttpPort and change its value to the new port number.