Lexolution Anbindung an die STP Cloud

eMail Versand über die STP Cloud

Ab der Version Lexolution 9.5 ist es möglich eMails über die STP Cloud mittels des ComCenter’s zu senden, die von dort aus an Exchange Online übergeben werden.
Für die Anmeldung wird eine Authentifizierungskomponente die die Microsoft Authentication Library (MSAL) verwendet. Der Lexolution Server ist mit der Cloud des ComCenters direkt verbunden. Sollten andere Einstellungen, z.B. länderübergreifende Spezifikationen, benötigt werden, so können optionale Parameter im Lexolution Server angegeben werden.

Grundsätzlich unterstützt Sie der Support der STP bei der Anbindung des Lexolution Servers an die STP Cloud.
Für das ComCenter müssen Kanäle im ComCenter Messaging eingerichtet werden, in denen Ihre Spezifikationen wie Tennant ID, eMail Adressen etc. hinterlegt sind.

Ist dies erfolgt, so wird der ComCenter eMail Versand im Lexolution Server lediglich in der Konfigurationsdatei des Lexolution Servers über

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

aktiviert.

Im Folgenden sind die optionalen Parameter aufgeführt, die in der Lexolution Server Konfigurationsdatei gesetzt werden können.

<!-- Stp Cloud -->
<!-- TenantId des Kunden -->
<add key="StpTenantId" value="comcenter-dev" />
<!-- Optional Adresse für Dev, Staging, ProdDE oder ProdCH, default im Code ist ProdDE -->
<add key="StpBaseUrl" value="https://{TenantId}.stp-cloud-dev.de" />

<!-- ComCenter Anmeldung -->
<!-- Einstellung gilt für Rechnungsversand und Mahnliste, Ergebnis ADB Generierung noch nicht verfügbar -->
<add key="ComCenterIsEnabled" value="true" />
<!-- Die 3 folgenden sind optional und normalerweise im Code gesetzt, nur zu Testzwecken konfigurierbar -->
<add key="ComCenterApiPath" value="" />
<add key="ComCenterClientId" value="" />
<add key="ComCenterCallbackUrl" value="" />

Die Tenant ID (Mandanten-ID) ist eine eindeutige eindeutige Kennung der Kanzlei in der STP-Cloud, die Ihre Kanzlei identifiziert.

Bei der Basis-URL handelt es sich um die Adresse der STP Cloud.
Handelt es sich um die deutsche STP Cloud https://{TenantId}.stp-cloud.de so kann der Eintrag leer gelassen werden, da dies durch Lexolution vorgegeben ist.
Handelt es sich hingegen um eine andere STP Cloud, z.B. die schweizer Cloud, so muss hier ein entsprechender Wert eingetragen werden https://{TenantId}.stp-cloud.ch und muss angegeben werden.
Darüber hinaus gibt noch weitere Adressen z.B. für Test-Cloud-Umgebungen.

ComCenterIsEnabled kennzeichnet ob die Funktionalitäten zur Verfügung stehen (true) oder nicht (false).

Die drei folgenden Einstellungen dienen nur zu Testzwecken und sind rein optional.

ComCenterApiPath - ComCenterClientId - ComCenterCallbackUrl

Im Bereich “MS 365 Anmeldung” der Konfigurationsdatei müssen folgende Einstellungen gefüllt werden.

<!-- MS 365 Anmeldung --> 
<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" />

Mit MS365IsEnabled wird Exchange Online eingeschaltet, im Fall der On-Premise Exchange Variante ist dieser Eintrag auf “false” zu setzen.
MS365TenantId hierbei handelt es sich um eine einzigartige Kennung von Mandanten, die im Cloud Bereich verwendet wird.
Die MS365ClientID identifiziert die Anwendung eindeutig gegenüber der Microsoft Identity Platform.
Mit MS365IsConfidentialClient wird beschrieben, dass es sich um eine Client-Anwendung, wie z. B. eine Webanwendung oder ein API, die auf einem Server läuft und sich sicher mit einem Identitätsprovider authentifizieren kann.
Bei MS365ClientSecret handelt es sich schlicht um ein ClientSecret .

Speichern Sie die Änderungen und schließen Sie die Konfigurationsdatei.
Beenden Sie den Dienst STP Lexolution Server und starten Sie den Dienst neu. >> Die geänderten Einstellungen wurden übernommen.
Der Dienst STP Lexolution Server ist gestartet.
Der Lexolution-Server ist für die Anbindung an Microsoft Exchange Server konfiguriert.

Termine, Wiedervorlagen und Fristen

Grundsätzlich, also nicht nur in der Anbindung zur STP Cloud, können Sie definieren ob Termine, Wiedervorlagen und auch Fristen an Exchange übergeben werden sollen.

Welche Daten hierbei übertragen, können Sie in der Konfigurationsdatei des Lexolution Servers festgelegt.

Setzen Sie hierzu die folgenden Parameter in der Konfigurationsdatei:

Schritt 1
Öffnen Sie die Konfigurationsdatei des Lexolution-Server mit Administratorrechten. Falls Sie den Lexolution-Server im Standard-Installationsverzeichnis installiert haben, befindet sich die Konfigurations-datei STP.Kms.Server.exe.config im Verzeichnis C:\Programme (x86)\STP AG\LEXolution.KMS-Server\.

Schritt 2
Stellen Sie unter ExchangeFristen die Kommunikation auf „true“ an, falls Sie die Fristen synchronisieren möchten

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

Schritt 3
Stellen Sie unter ExchangeTermine die Kommunikation auf „true“ an, falls Sie die Termine synchronisieren möchten

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

Schritt 4
Stellen Sie unter ExchangeWVL die Kommunikation auf „true“ an, falls Sie die Wiedervorlagen synchronisieren möchten

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

Schritt 5
Speichern Sie die Änderungen und schließen Sie die Konfigurationsdatei.
Beenden Sie den Dienst STP Lexolution Server und starten Sie den Dienst neu.
>Die geänderten Einstellungen wurden übernommen.
Der Dienst STP Lexolution Server ist gestartet.
Der Lexolution-Server ist für die Anbindung an Microsoft Exchange Server konfiguriert.

Nach dem Start des STP Lexolution Server werden zunächst die vorhandenen Daten synchronisiert.

🛈 Hinweis

Der Tokencache für die Anmeldung bei der STP Cloud wird in der Datei msal.comcenter.integration.cache im Ordner {Benutzer}\AppData\Local gespeichert. Wenn dieser Ordner z.B. auf Terminalservern jede Nacht gelöscht wird, müssen sich die Benutzer täglich neu anmelden.

Verknüpfung mit

Category -- Lexolution