Mandanten-Provisionierung | Easy Mail Archive

Überblick

Mandanten-Provisionierung ist der Prozess der Einrichtung einer neuen Kundenumgebung in Easy Mail Archive. Wenn Sie einen Mandanten über die API oder das WHMCS-Modul erstellen, konfiguriert die Plattform automatisch eine isolierte Umgebung mit eigener Datenbank, eigenem Speicher und eigener Zugangs-URL. Dieser Artikel erklärt, was im Hintergrund passiert und was Sie als Reseller wissen müssen.

Was bei der Provisionierung passiert

Wenn Sie eine Erstellungsanfrage an die API senden, werden folgende Schritte automatisch durchgeführt:

Slug-Validierung - Das System prüft, ob der Slug eindeutig ist, den Namensregeln entspricht (3-48 Zeichen, Kleinbuchstaben und Bindestriche) und kein reserviertes Wort ist
Mandanten-Datensatz erstellen - Ein Eintrag wird in der Plattform-Datenbank angelegt, der den Mandanten mit Ihrem Reseller-Konto verknüpft
Datenbank erstellen - Eine dedizierte PostgreSQL-Datenbank wird mit dem Namen ema_t_{slug} angelegt
Schema-Migration - Alle erforderlichen Tabellen (Nachrichten, Benutzer, Einstellungen, Audit-Logs usw.) werden in der neuen Datenbank erstellt
Speicher zuweisen - Ein S3-Speicherpräfix ema-t-{slug}/ wird für die archivierten Nachrichten des Mandanten zugewiesen
Branding vererben - Der Mandant erbt Ihr Reseller-Branding (Name, Logo, Farben, Favicon), sofern keine Überschreibungen angegeben werden

Der gesamte Provisionierungsprozess dauert in der Regel nur wenige Sekunden.

Der Slug

Der Slug ist der wichtigste Bezeichner eines Mandanten. Er bestimmt:

Die Subdomain - {slug}.archiv.ihrefirma.de
Den Datenbanknamen - ema_t_{slug}
Den Speicherpräfix - ema-t-{slug}/

Da der Slug tief in der Infrastruktur verankert ist, kann er nach der Erstellung nicht mehr geändert werden. Wählen Sie Slugs sorgfältig und verwenden Sie eine einheitliche Namenskonvention für Ihren gesamten Kundenstamm.

Slug-Namensregeln

Mindestens 3 Zeichen, maximal 48 Zeichen
Nur Kleinbuchstaben (a-z), Zahlen (0-9) und Bindestriche (-)
Muss mit einem Buchstaben beginnen
Darf nicht mit einem Bindestrich enden
Muss global über alle Reseller hinweg eindeutig sein

Empfohlene Namenskonventionen

Firmennamen des Kunden verwenden: acme-corp, mueller-recht, nordtech
Domain-basierter Ansatz: acme-com, mueller-recht-de
Eigenen Präfix voranstellen: meinefirma-acme, meinefirma-mueller

Datenisolation

Jeder Mandant ist auf Infrastrukturebene vollständig isoliert:

Datenbank-Isolation - Jeder Mandant hat seine eigene PostgreSQL-Datenbank. Es gibt keine gemeinsamen Tabellen oder Schemas. Abfragen eines Mandanten berühren nie die Daten eines anderen Mandanten.
Speicher-Isolation - Die archivierten Nachrichten jedes Mandanten werden unter einem eigenen S3-Präfix gespeichert. Zugriffskontrollen stellen sicher, dass Mandanten nicht auf die Dateien anderer Mandanten zugreifen können.
Sitzungs-Isolation - Benutzersitzungen sind auf einen bestimmten Mandanten beschränkt. Ein bei einem Mandanten authentifizierter Benutzer kann nicht auf die Daten eines anderen Mandanten zugreifen.

Einrichtung nach der Provisionierung

Nachdem ein Mandant provisioniert wurde, führt der Mandanten-Administrator typischerweise folgende Schritte durch:

Domains hinzufügen - Die E-Mail-Domains registrieren, die archiviert werden sollen
Benutzer erstellen - Benutzerkonten für Teammitglieder anlegen, die Zugang zum Archiv benötigen
E-Mail-Routing konfigurieren - Journaling oder SMTP-Weiterleitung einrichten, um Kopien von E-Mails an das Archiv zu senden
Sicherheitsrichtlinien festlegen - Anforderungen für Zwei-Faktor-Authentifizierung und andere Sicherheitseinstellungen konfigurieren

Als Reseller können Sie Ihre Kunden bei diesen Schritten unterstützen oder ihnen Dokumentation zur selbstständigen Einrichtung bereitstellen.

Provisionierungsfehler

In seltenen Fällen kann die Provisionierung fehlschlagen aufgrund von:

Slug-Konflikte - Der Slug ist bereits vergeben (API gibt 409 Conflict zurück)
Validierungsfehler - Der Slug oder Name entspricht nicht den Formatierungsanforderungen (API gibt 422 zurück)
Infrastrukturprobleme - Vorübergehende Probleme mit der Datenbank- oder Speicher-Provisionierung (API gibt 500 zurück)

Wenn die Provisionierung mit einem Serverfehler fehlschlägt, warten Sie einen Moment und wiederholen Sie die Anfrage. Sollte das Problem bestehen bleiben, kontaktieren Sie unser Support-Team.