Benutzer-Werkzeuge

Webseiten-Werkzeuge


provisioning

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
provisioning [2025/12/16 11:11] – angelegt lwsystemsprovisioning [2025/12/18 09:56] (aktuell) – [SMTP-Import] lwsystems
Zeile 4: Zeile 4:
   * [[#Container]]: kleinste Speichereinheit eines Mandanten bestehend aus //[[#Repo]]// und //[[#Index]]//   * [[#Container]]: kleinste Speichereinheit eines Mandanten bestehend aus //[[#Repo]]// und //[[#Index]]//
   * [[#Import]]   * [[#Import]]
-    * //[[#BennoGW]]//+    * //[[#Mailserver|Mailserver (BennoGW)]]//
     * //[[#REST-Import]]//     * //[[#REST-Import]]//
     * //[[#Journal-Import]]//     * //[[#Journal-Import]]//
Zeile 11: Zeile 11:
   * [[#Journaladresse]]   * [[#Journaladresse]]
   * [[#Archivierung|Archivierung (technische Beschreibung)]]   * [[#Archivierung|Archivierung (technische Beschreibung)]]
 +  * [[#Produkt]]
 +
  
 ====== Begriffsbestimmungen ====== ====== Begriffsbestimmungen ======
Zeile 46: Zeile 48:
  
 ==== Rest-Import ==== ==== Rest-Import ====
 +
 +<code>
 +[Mailboxhost] ----> [Benno Import REST] ------------------------------------------> [Storagebackend]
 +                  
 +     ImportID ----> BennoGW ---+---> Storageurl (https://node-a/rest/archive) ----> file:///srv/benno/inbox
 +                               |
 +                               +---> Storageurl (https://node-b/rest/archive) ----> file:///srv/benno/inbox
 +                               |
 +                               +---> Storageurl (https://node-c/rest/archive) ----> file:///srv/benno/inbox
 +
 +</code>
 +
 +
  
 Beim REST-Import wird die E-Mail beim Reseller oder Mandanten zwischengespeichert und mit Hilfe eines REST-Clients an Benno Cloud übergeben. Der REST-Client authentisiert sich mittels Beim REST-Import wird die E-Mail beim Reseller oder Mandanten zwischengespeichert und mit Hilfe eines REST-Clients an Benno Cloud übergeben. Der REST-Client authentisiert sich mittels
Zeile 51: Zeile 66:
  
 ==== Journal-Import ==== ==== Journal-Import ====
 +
 +
 +<code>
 +[ M365 ] -----------------------------------> [ Benno Import SMTP (J) ] -----------------> [ Benno Import REST ]
 +
 +To: importid+checksum@journal.benno-cloud.de --------> ImportID ---------------------------> BennoGW ....
 +</code>
  
 Beim Journal-Import wird eine E-Mail an eine individuelle E-Mail Adresse für den Import dieses Mandanten geschickt. Die E-Mail Adresse besteht aus der Bezeichnung des [[#BennoGW]]s und einer Checkumme. Beim Journal-Import wird eine E-Mail an eine individuelle E-Mail Adresse für den Import dieses Mandanten geschickt. Die E-Mail Adresse besteht aus der Bezeichnung des [[#BennoGW]]s und einer Checkumme.
Zeile 57: Zeile 79:
  
 ==== SMTP-Import ==== ==== SMTP-Import ====
 +
 +
 +<code>
 +[ MTA ] ----------------------------------------> [ Benno Import SMTP ] -----------------> [ Benno Import REST ]
 +
 +To: importid+checksum@import.benno-cloud.de -------> ImportID -----------------------> BennoGW ....
 +</code>
  
 Beim SMTP-Import wird eine E-Mail ebenfalls an eine individuelle E-Mail Adresse für den Import des Mandanten geschickt. Diese E-Mail Adresse ist ebenso aufgebaut wie beim [[#Journal-Import]]. Beim SMTP-Import wird eine E-Mail ebenfalls an eine individuelle E-Mail Adresse für den Import des Mandanten geschickt. Diese E-Mail Adresse ist ebenso aufgebaut wie beim [[#Journal-Import]].
Zeile 66: Zeile 95:
 Der SMTP Import wird von LWsystems nicht empfohlen. Der SMTP Import wird von LWsystems nicht empfohlen.
  
-===== BennoGW ===== 
  
-Der Parameter //BennoGW// legt eindeutig fest, auf welchem Mailserver die Postfächer des jeweiligen Mandanten gespeichert werden. Diese Information ist bei der Archivierung essentiell um die E-Mail eindeutig dem +==== Mehrere Quellen ====
-jeweiligen Mandten als Ursprungsquelle zuzuordnen.+
  
 +Falls einem Produkt mehrere Quellen zugeordnet werden sollen, so wird dieses auf Seiten des Kunden abgebildet.
 +Falls der Kunde eine M365 und eine On-Premises Instanz betreibt, so kann beide Instanzen mittels Journal E-Mail exportieren. 
 +===== Mailserver =====
  
 +Der Parameter //BennoGW// definiert einen **Mailserver** Hiermt legt er eindeutig fest, auf welchem Mailserver die Postfächer des jeweiligen Mandanten gespeichert werden. Diese Information ist bei der Archivierung essentiell um die E-Mail eindeutig dem jeweiligen Mandten als Ursprungsquelle zuzuordnen.
 +
 +Beim Anlegen eines Mailservers wird für diesen im Backend ein Account angelegt. Über diesen Account wird der einzelnen E-Mail beim Import das BennoGW zugeordnet.
 +
 +Der Mailserver wird per REST Endpoint angelegt. Der Endpoint gibt im Response eine Konfigurationsdatei für das benno-send2rest oder die Journaling E-Mail Adresse zurück.
 ===== Archivierung ===== ===== Archivierung =====
  
 Bei der Archivierung wird die E-Mail als EML-Datei eingelesen und analysiert. Hier wird eine Liste der E-Mail Adressen des Senders und der Empfänger der E-Mail erstellt. Die Domains dieser Adressen Bei der Archivierung wird die E-Mail als EML-Datei eingelesen und analysiert. Hier wird eine Liste der E-Mail Adressen des Senders und der Empfänger der E-Mail erstellt. Die Domains dieser Adressen
 dienen beim Archivieren als Filterkrieterium. In der EML-Datei ist zusätzlich noch die Information des BennoGW gespeichert dieser Parameter wird per //UND// mit den Domains aus Sender und Empfänger verknüpft und dienen beim Archivieren als Filterkrieterium. In der EML-Datei ist zusätzlich noch die Information des BennoGW gespeichert dieser Parameter wird per //UND// mit den Domains aus Sender und Empfänger verknüpft und
-mit den Kriterien der Container verglichen.\\ Die E-Mail wird in den Containern gespeichert, auf die die Kriterien //<domain> AND <BennoGW// passen.+mit den Kriterien der Container verglichen.\\ Die E-Mail wird in den Containern gespeichert, auf die die Kriterien //<domain> AND <BennoGW>// passen. 
 + 
 + 
 +===== Produkt ===== 
 + 
 +Ein Produkt im Reseller-Portal definiert sich durch den Endkunden in Verbindung mit einem Container. 
 +Diesem Produkt wird eine Gateway-ID (BennoID oder Journal E-Mail Adresse) zugewiesen. 
 + 
 +==== Benno Cloud 365 ==== 
 + 
 +Die Konfiguration eines Benno Cloud 365 Produkts benötigt keinen expliziten Gateway-Indentifier und keine Domains. 
 +Der Gateway-Identifier wird durch die Journal E-Mail Adresse dargestellt. Die Domains werden vom Kunden in M365 gepflegt. 
 + 
 +Die Journal E-Mail Adresse wird nach Anlegen des Produkts vom Backend zurück gegeben. 
 + 
 +Hier wird ein Container über den Endpoint /container/standard erstellt. 
 +==== Benno Cloud Enterprise ==== 
 + 
 +Ein Benno Cloud Enterprise Produkt wird durch den Gateway-Identifier (BennoGW) und eine oder mehrere Domains definiert. 
 +In Benno Cloud dient diese Kombination als Filterkriterium. 
 + 
 +<code> 
 +BennoGW AND (domain-a OR domain-b OR domain-c) 
 +</code>
  
 +Dieser Container wird über den Endpunkg /create/extended erstellt.
 +===== Kunde =====
  
 +Der Kunde ist ein Endkunde eines Resellers.
 +Einem Kunden können mehrere Produkte zugewiesen werden.
provisioning.1765883488.txt.gz · Zuletzt geändert: 2025/12/16 11:11 von lwsystems