Lexolution Integration with the STP Cloud - ComCenter

Sending Emails via the STP Cloud

Starting with Lexolution version 9.5, you can send emails through the STP Cloud using the ComCenter, which then forwards them to Exchange Online.
Authentication uses a component based on the Microsoft Authentication Library (MSAL).
The Lexolution Server is directly connected to the ComCenter Cloud.
If you need other settings, such as cross-country specifications, you can add optional parameters in the Lexolution Server.

STP Support will assist you with connecting the Lexolution Server to the STP Cloud, since channels need to be set up in ComCenter Messaging for access. These channels will store your specifications, such as Tenant ID, email addresses, etc.

Once this is done, you just need to enable ComCenter email sending in the Lexolution Server configuration file by adding

<add key="ComCenterIsEnabled" value="true" />

to activate it.

Below are the optional parameters you can set in the Lexolution Server configuration file.

<!-- Stp Cloud -->
<!-- Customer TenantId -->
<add key="StpTenantId" value="comcenter-dev" />
<!-- Optional address for Dev, Staging, ProdDE or ProdCH, default in code is ProdDE -->
<add key="StpBaseUrl" value="https://{TenantId}.stp-cloud-dev.de" />

<!-- ComCenter login -->
<!-- Setting applies to invoice sending and dunning list, ADB generation result not yet available -->
<add key="ComCenterIsEnabled" value="true" />
<!-- The next 3 are optional and usually set in code, only configurable for testing -->
<add key="ComCenterApiPath" value="" />
<add key="ComCenterClientId" value="" />
<add key="ComCenterCallbackUrl" value="" />

The Tenant ID is a unique identifier for your law firm in the STP Cloud.

The Base URL is the address of the STP Cloud.
If you are using the German STP Cloud https://{TenantId}.stp-cloud.de, you can leave this entry blank, as Lexolution will use this by default.
If you are using a different STP Cloud, such as the Swiss Cloud, you need to enter the appropriate value here https://{TenantId}.stp-cloud.ch.
There are also other addresses, for example, for test cloud environments.

ComCenterIsEnabled indicates whether the features are available (true) or not (false).

The next three settings are only for testing purposes and are completely optional.

ComCenterApiPath - ComCenterClientId - ComCenterCallbackUrl

In the “MS 365 Login” section of the configuration file, you need to fill in the following settings.

<!-- MS 365 Login --> 
<add key="Ms365IsEnabled" value="true" /> 
        <add key="Ms365TenantId" value="xxx" /> 
        <add key="Ms365ClientId" value="xxx" /> 
        <add key="Ms365IsConfidentialClient" value="true" /> 
        <add key="Ms365ClientSecret" value="xxx" /> 

MS365IsEnabled enables Exchange Online. If you are using the on-premises Exchange version, set this entry to “false”.
MS365TenantId is a unique identifier for tenants used in the cloud.
The MS365ClientID uniquely identifies the application to the Microsoft Identity Platform.
MS365IsConfidentialClient indicates that this is a client application, such as a web app or API running on a server, that can securely authenticate with an identity provider.
MS365ClientSecret is simply the client secret.

Save your changes and close the configuration file.
Stop the STP Lexolution Server service and restart it. >> The updated settings have been applied.
The STP Lexolution Server service is running.
The Lexolution Server is now configured to connect to the STP Cloud.

Appointments, Reminders, and Deadlines

In general, not just when connecting to the STP Cloud, you can define whether appointments, reminders, and deadlines should be sent to Exchange.

You can specify which data is transferred in the Lexolution Server configuration file.

Set the following parameters in the configuration file:

Step 1
Open the Lexolution Server configuration file with administrator rights. If you installed the Lexolution Server in the default directory, the configuration file STP.Kms.Server.exe.config is located in C:\Program Files (x86)\STP AG\LEXolution.KMS-Server\.

Step 2
Set ExchangeFristen to “true” if you want to synchronize deadlines.

<add key="ExchangeFristen" value="false"></add>

Step 3
Set ExchangeTermine to “true” if you want to synchronize appointments.

<add key="ExchangeTermine" value="false"></add>

Step 4
Set ExchangeWVL to “true” if you want to synchronize reminders.

<add key="ExchangeWVL" value="false"></add>

Step 5
Save your changes and close the configuration file.
Stop the STP Lexolution Server service and restart it.
>The updated settings have been applied.
The STP Lexolution Server service is running.
The Lexolution Server is now configured to connect to Microsoft Exchange Server.

After starting the STP Lexolution Server, existing data will be synchronized first.

🛈 Note

The token cache for logging in to the STP Cloud is saved in the file msal.comcenter.integration.cache in the {User}\AppData\Local folder. If this folder is deleted every night, for example on terminal servers, users will need to log in again every day.