Mandanten verwalten
Überblick
Als Reseller sind Mandanten die zentrale Einheit, die Sie verwalten. Jeder Mandant repräsentiert einen Ihrer Kunden und erhält eine eigene isolierte Umgebung mit separater Datenbank, eigenem Speicherbereich und eigener Subdomain. Sie können Mandanten über die REST-API oder die WHMCS-Integration verwalten.
Mandanten erstellen
Um einen neuen Mandanten zu erstellen, müssen Sie mindestens einen Slug und einen Namen angeben. Der Slug wird zur Subdomain (z. B. Slug acme wird zu acme.archiv.ihrefirma.de) und muss global eindeutig sein, darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und muss zwischen 3 und 48 Zeichen lang sein.
Beim Erstellen eines Mandanten passiert automatisch Folgendes:
- Eine dedizierte PostgreSQL-Datenbank wird angelegt (
ema_t_{slug}) - Ein dedizierter S3-Speicherpräfix wird zugewiesen (
ema-t-{slug}/) - Alle erforderlichen Datenbanktabellen werden über Migrationen provisioniert
- Der Mandant wird unter seiner Subdomain erreichbar
Mandanten auflisten
Sie können über die API eine Liste aller Mandanten unter Ihrem Reseller-Konto abrufen. Die Liste enthält für jeden Mandanten Slug, Name, Status, Benutzeranzahl, Speicherverbrauch und Erstellungsdatum. Die Ergebnisse werden für Konten mit vielen Mandanten paginiert.
Mandanten aktualisieren
Nach der Erstellung können Sie den Anzeigenamen eines Mandanten und die Branding-Überschreibungen (eigener Name, Primärfarbe, Logo, Favicon) aktualisieren. Der Slug kann nach der Erstellung nicht mehr geändert werden, da er mit dem Datenbanknamen und dem Speicherpräfix verknüpft ist.
Mandanten sperren
Wenn ein Kunde nicht zahlt oder Sie den Zugang vorübergehend deaktivieren müssen, können Sie einen Mandanten sperren. Gesperrte Mandanten:
- Sind für keine Benutzer zugänglich (Anmeldung ist blockiert)
- Behalten alle ihre Daten (Nachrichten, Benutzer, Einstellungen)
- Empfangen weiterhin eingehende E-Mails zur Archivierung
- Können jederzeit entsperrt werden, um den vollen Zugang wiederherzustellen
Die Sperrung ist nicht destruktiv. Sie ist die empfohlene Methode bei Zahlungsstreitigkeiten oder vorübergehender Deaktivierung.
Mandanten entsperren
Das Entsperren eines Mandanten stellt den vollen Zugang sofort wieder her. Alle Benutzer können sich wieder anmelden, und der Mandant funktioniert so, als wäre er nie gesperrt gewesen. Während der Sperrzeit gehen keine Daten verloren.
Mandanten löschen
Die Löschung eines Mandanten ist eine permanente Aktion und steht nicht über die Self-Service-API zur Verfügung. Um einen Mandanten und alle zugehörigen Daten zu löschen, kontaktieren Sie unser Support-Team. Diese Sicherheitsmaßnahme dient dazu, versehentlichen Datenverlust zu verhindern, insbesondere in compliance-sensiblen Umgebungen.
Best Practices
- Aussagekräftige Slugs verwenden - Wählen Sie Slugs, die den Kunden identifizieren (z. B.
acme-corp), da sie nachträglich nicht geändert werden können. - Nutzung regelmäßig überwachen - Nutzen Sie den Usage-Stats-Endpunkt, um aktive Benutzer und Speicherverbrauch pro Mandant zu verfolgen.
- Vor dem Löschen sperren - Wenn ein Kunde kündigt, sperren Sie zuerst. Das gibt Ihnen Zeit, die Kündigung zu bestätigen, und ermöglicht dem Kunden, es sich anders zu überlegen.
- Mit Test-Mandant testen - Erstellen Sie einen Test-Mandanten, um Branding und Konfiguration zu überprüfen, bevor Sie Produktionskunden einrichten.