ComCenter eMail Versand
Ab der Version Lexolution 9.5 ist es möglich eMails über das
ComCenter 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 Einrichtung
in der 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
Termine, Wiedervorlagen und Fristen
Grundsätzlich, also nicht nur in der Anbindung zum ComCenter, können Sie definieren ob Termine, Wiedervorlagen und auch Fristen über das ComCenter übergeben werden sollen.
Die Einstellung hierzu wird, wie zuvor in der Konfigurationsdatei des Lexolution Servers vorgenommen.
Führen Sie dazu folgende Schritte durch:
Schritt 5 Soll die Verbindung nicht mit einem On-Premise Exchange erfolgen, sondern über Exchange Online (O365) so sind weitere Einstellungen notwendig.
Im Bereich “IDesk/Exchange Connector” der Konfigurationsdatei muss ein Kalender Benutzer definiert werden.
<!-- IDesk/Exchange Connector Einstellungen -->
<add key="ExchangeKmsCalendarUser" value="User.Kalender@exchange365XXX.onmicrosoft.com" Bei dem ExchangeKmsCalendarUser handelt es sich um einen technischen
Benutzer, hierbei kann ein normaler Benutzer ohne besondere Rechte
verwendet werden.
Er ist aber unabdingbar für die Kommunikation Exchange Online.
Dieser dient zur Überprüfung, ob ein Benutzer mit der eMail des
Mitarbeiters im globalen Adressbuch von Exchange existiert.
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 .
Schritt 6
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.
🛈 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