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 is directly connected to the ComCenter's cloud.
If other settings are needed — for example, cross-country specifications — optional parameters can be specified in the LEXolution Server configuration.

In general, 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 specifications — 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 setting the following in the LEXolution Server configuration file:

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

The following optional parameters 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 reminder list, ADB generation result not yet available -->
<add key="ComCenterIsEnabled" value="true" />
<!-- The following 3 are optional and normally set in 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 empty, as this is the default set by LEXolution.
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 an on-premises Exchange setup, 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 the 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 for connection 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 synced to 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
Set ExchangeFristen to "true" if you want to sync deadlines.

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

Step 3
Set ExchangeTermine to "true" if you want to sync appointments.

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

Step 4
Set ExchangeWVL to "true" if you want to sync follow-ups.

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

Step 5
Save the 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 for connection 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 every night — for example, on terminal servers — users will need to log in again each day.