LEXolution Connection to the STP Cloud - ComCenter

Email Sending via the STP Cloud

Starting with LEXolution version 9.5, it is possible to send emails via the STP Cloud using the ComCenter, which then forwards them to Exchange Online.
Authentication is handled by a component that uses the Microsoft Authentication Library (MSAL).
The LEXolution Server connects directly to the ComCenter's cloud.
If other settings are required — for example, cross-country specifications — optional parameters can be specified in the LEXolution Server configuration.

STP Support will assist you with connecting the LEXolution Server to the STP Cloud, as channels need to be set up in ComCenter Messaging to enable access. Your specific details, such as Tenant ID, email addresses, etc., are stored in these channels.

Once this is done, ComCenter email sending is enabled in the LEXolution Server simply by adding the following line to the LEXolution Server configuration file:

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

The following is a list of optional parameters that can be set in the LEXolution Server configuration file.

<!-- Stp Cloud -->
<!-- TenantId of the customer -->
<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 deadline list, ADB generation result not yet available -->
<add key="ComCenterIsEnabled" value="true" />
<!-- The following 3 are optional and normally set in the code, configurable for testing purposes only -->
<add key="ComCenterApiPath" value="" />
<add key="ComCenterClientId" value="" />
<add key="ComCenterCallbackUrl" value="" />

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

The Base URL is the address of the STP Cloud.
If you are using the German STP Cloud https://{TenantId}.stp-cloud.de, this field can be left blank, as LEXolution uses this as the default.
If you are using a different STP Cloud — for example, the Swiss Cloud — you must enter the appropriate value here: https://{TenantId}.stp-cloud.ch.
There are also additional addresses available, for example for test cloud environments.

ComCenterIsEnabled indicates whether the functionality is available (true) or not (false).

The following three settings are for testing purposes only and are entirely optional.

ComCenterApiPath - ComCenterClientId - ComCenterCallbackUrl

In the "MS 365 Login" section of the configuration file, the following settings must be filled in.

<!-- 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 option, this entry should be set to "false".
MS365TenantId is a unique identifier for tenants used in the cloud environment.
MS365ClientID uniquely identifies the application to the Microsoft Identity Platform.
MS365IsConfidentialClient indicates that this is a confidential client application — such as a web application or API — that runs on a server and can securely authenticate with an identity provider.
MS365ClientSecret is simply a 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, Follow-ups, and Deadlines

In general — not just when connecting to the STP Cloud — you can define whether appointments, follow-ups, and deadlines should be synchronized with Exchange.

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

To do so, set the following parameters in the configuration file:

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

Step 2
Under ExchangeFristen, set the value to "true" if you want to synchronize deadlines.

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

Step 3
Under ExchangeTermine, set the value to "true" if you want to synchronize appointments.

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

Step 4
Under ExchangeWVL, set the value to "true" if you want to synchronize follow-ups.

<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 configured to connect to Microsoft Exchange Server.

After the STP LEXolution Server starts, existing data will first be synchronized.

🛈 Note

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

Related to

Category -- Lexolution