Jan Ulrich Hasecke
2019-11-06 8d081ac85398030bb1c1f5f6e59e5c995a6987fa
commit | author | age
8d081a 1 .. _kap-modul-domain:
0a126d 2
8d081a 3 ============
JUH 4 Modul domain
5 ============
0a126d 6
8d081a 7 Funktionen
JUH 8 ==========
0a126d 9
8d081a 10 .. option:: domain.search
JUH 11
12    Suche Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten
13
14 .. option:: domain.add
15
16    Füge einen neuen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
17
18 .. option:: domain.update
19
20    Aktualisiere einen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten.
21
22 .. option:: domain.remove
23
24    Lösche einen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten.
25
26 Editierbare Felder
27 ==================
28
29 Das HSAdmin-Modul ``domain`` kann entsprechend der folgenden Befehlssyntax von :command:`HSADmin` Felder setzen oder verändern::
30
31    domain.function({where:{field:'value',...}, set:{field:'value',...}})
32
33 Im Modul ``domain`` stehen folgende Felder zur Verfügung.
34
35 name
36    Name einer Domain
37 user
38    Name des Domain-Admins
39 validsubdomainnames
40    leichtgewichtige Subdomains in diesem virtual Host des Webservers, gültige Werte: ``*`` für beliebige Subdomains oder eine kommaseparierte Liste: ``www,blog,other``
41 greylisting
42    E-Mails werden verzögert durch den Mailserver angenommen, siehe :term:`Greylisting`. Ist die Option deaktivert, werden E-Mails ohne Verzögerung angenommen.
43 multiviews
44    Der Webserver berücksichtigt Einstellungen im Browser beim Abruf einer Domain (z.B. eine bevorzugte Sprache). Die Option kann mit einer :term:`.htaccess`-Datei für jedes Verzeichnis konfiguriert werden.
45 indexes
46    Der Webserver erzeugt für Verzeichnisse, die keine eigene Index-Datei enthalten, eine Liste mit den im Verzeichnis enthaltenen Dateien. Ist die Option deaktiviert, wird ein Fehler 303 ausgegeben. Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.
47 htdocsfallback
48    Der Webserver leitet auf die Hauptdomain, wenn keine Sub-Domain angelegt ist. Ist die Option deaktivert, wird ein Fehler 404 ausgegeben: Seite nicht gefunden.
49 includes
50    Der Webserver erkennt :term:`SSI`-Komandos und -Dateien. Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.
51 backupmxforexternalmx
52    Der Paket-Hive wird als Weiterleitung (transport) beim Mail-In-Server eingetragen. Ist die Option aktiv, ist der Hostsharing-Mail-In-Server Backup-MX. Der eigentliche Mailserver befindet sich außerhalb der Infrastruktur von Hostsharing (z.B. anderer Provider, DSL-Anschluss mit fester IP)
53 letsencrypt
54    Es wird automatisch ein TLS Zertifikat für diese Domain und alle im Feld „valid subdomain names“ angegebenen Subdomains erzeugt
55
56 .. note::
57
58         Die Option ``backupmxforexternalmx`` erfordert Änderungen am :doc:`Zonefile<../zonefile/index>` einer Domain.
59
60 Beispiele
61 =========
0a126d 62
JUH 63 .. code-block:: console
64
65     xyz00@hsadmin> domain.add ({set:{name:'hs-example.de',user:'xyz00'}})
66
8d081a 67 .. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition