HS Admin Dokumentation

Modul domain

Funktionen

domain.search

Suche Domain nach den im Befehlsausdruck angegebenen Feldern und Werten

domain.add

Füge eine neue Domain nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.

domain.update

Aktualisiere eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.

domain.remove

Lösche eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.

Editierbare Felder

Das HSAdmin-Modul domain kann entsprechend der folgenden Befehlssyntax von HSAdmin Felder setzen oder verändern:

domain.function({where:{field:'value',...}, set:{field:'value',...}})

Im Modul domain stehen folgende Felder zur Verfügung.

name

Name einer Domain

user

Name des Domain-Admins

validsubdomainnames

leichtgewichtige Subdomains in diesem Virtual-Host des Webservers, gültige Werte: * für beliebige Subdomains oder eine kommaseparierte Liste: www,blog,other

domainoptions

im Parameter domainoptions wird ein Array mit allen Domain-Optionen erwartet, die aktiv sein sollen. Werte, die nicht aufgezählt sind, werden inaktiv gesetzt!

Folgende Domain-Optionen werden unterstützt:

greylisting

E-Mails werden verzögert durch den Mailserver angenommen, siehe Greylisting. Ist die Option deaktivert, werden E-Mails ohne Verzögerung angenommen.

dkim

ausgehende E-Mails werden auf dem zuständigen Server mit einer DKIM-Signatur versehen. Für die Signatur wird ein geheimer Schlüssel verwendet. Der öffentliche Schlüssel zu diesem Schlüsselpaar muss im DNS für die Domain hinterlegt sein, bevor diese Option aktiviert wird!

multiviews

Der Webserver berücksichtigt Einstellungen im Browser beim Abruf einer Domain (z.B. eine bevorzugte Sprache). Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.

indexes

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.

htdocsfallback

Der Webserver leitet auf die Hauptdomain, wenn keine Sub-Domain angelegt ist. Ist die Option deaktivert, wird ein Fehler 404 ausgegeben: Seite nicht gefunden.

includes

Der Webserver erkennt SSI-Komandos und -Dateien. Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.

backupmxforexternalmx

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)

letsencrypt

Es wird automatisch ein TLS Zertifikat für diese Domain und alle im Feld „validsubdomainnames" angegebenen Subdomains erzeugt

autoconfig

Eine Unterstützung für die Konfiguration von E-Mail-Programmen durch die Verfahren "Autoconfig" (Mozilla) und "Autodiscover" (Microsoft) wird für die Domain eingeschaltet

Die Optionen autoconfig, backupmxforexternalmx und dkim erfordern Änderungen am Zonefile einer Domain.

Beispiele

Mit dem folgenden Befehl schalten wir die Domain hs-example.de auf und ordnen Sie dem Domain-Admin xyz00-hsexample zu.

xyz00@hsadmin> domain.add({set:{name:'hs-example.de',user:'xyz00-hsexample'}})

Mit dem Befehl domain.search werden alle Informationen zu einer Domain angezeigt. Die gesuchte Domain wird mit dem Befehlsausdruck where ausgewählt.

xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})

Und mit dem Befehl domain.remove können wir eine Domain entfernen.

xyz00@hsadmin> domain.remove({where:{name:'hs-example.de'}})

Mit dem Befehl domain.update lassen sich die Einstellungen für eine Domain verändern. Bei einer Änderung der Domain-Optionen, wie im folgenden Beispiel, müssen immer alle Optionen angegeben werden, die gesetzt sein sollen, da der Befehl die bereits gesetzten Domain-Optionen komplett überschreibt.

xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:['htdocsfallback','indexes','greylisting','letsencrypt','autoconfig']}})
Hostsharing Maskottchen mit Notizbuch
Inhalt auf dieser Seite
Weitere Informationen

Dokumentation

Webfrontend: Domain einrichten

Dokumentation

Webfrontend: Domain-Benutzer anlegen

Dokumentation

Domains

Dokumentation

Dokumentation: Web-Paket

Genossenschaftliche IT-Betreuung aus einer Hand
Beratung

Kompetente Beratung bei Auswahl und Anwendung von freier Software

Umsetzung

Tatkräftige Unterstützung bei der Umsetzung Ihrer Pläne.

Betrieb

Dienstleistungen für einen reibungslosen IT-Betrieb

Häufig gebuchte Produkte
Managed Webspace

Nutzen Sie alle Vorteile der Managed Operations Platform preisgünstig im Hostsharing Managed Webspace.

Managed Server

Nutzen Sie die Managed Operations Platform mit exklusiv zugewiesenen Ressourcen für größere Projekte.

Cloud Server

Hochverfügbarer Server mit dem Betriebssystem Ihrer Wahl und Root-Zugriff.