Systemvoraussetzungen

Lauffähige WHMCS 8.6 – 8.10 Installation
Admin Zugang zu WHMCS
installierter Ioncube Loader (mindestens Version 12)
Account bei DomainOffensive bzw. bei einem Reseller welcher das Resellerinterface verwendet, mit API Zugang zum 2022 eingeführten System (nicht kompatibel mit dem alten Domain-Bestellsystem)
PHP 7.4, 8.1

Installation

Laden Sie die Moduldateien bitte auf Ihren Webspace hoch
Loggen Sie sich in WHMCS ein und gehen im Adminbereich zur Auflistung der Registrarmodule und klicken dort beim Registrar DomainOffensive auf Activate und dann auf Configure
Geben Sie nun bitte Ihre Zugangsdaten ein und nehmen die sonstigen Einstellungen vor. Eine Erklärung der Einstellungsoptionen finden Sie im nächsten Abschnitt.

Einstellungsoptionen

API_Username = Ihr Benutzername für Ihren API-User, sollten Sie noch keinen angelegt haben, legen Sie diesen bitte über Verwaltung-Benutzer im resellerinterface an.
Resellerid = Ihre Reseller-ID. Diese finden Sie z.B. im Resellerinterface, wenn Sie oben rechts auf das User Icon klicken.
API_Key = Passwort ihres API-Benutzers
Licensekey = Ihr Lizenzkey für dieses Modul von Plambee.de
IPv4 Address = Die IPv4 Adresse für die Standardrecords, wenn Sie die NS von DomainOffensive nutzen und eine Standardzone erstellen lassen möchten (leer lassen, falls nicht benötigt). Wird beim DNS Template auch für den IPv4 Platzhalter verwendet.
IPv6 Address = Die IPv6 Adresse für die Standardrecords, wenn Sie die NS von DomainOffensive nutzen und eine Standardzone erstellen lassen möchten (leer lassen, falls nicht benötigt). Wird beim DNS Template auch für den IPv6 Platzhalter verwendet.
Template MX IPv4 Address = Wert für den mxIPv4 Platzhalter im DNS Template
Template MX IPv6 Address = Wert für den mxIPv6 Platzhalter im DNS Template
MX Record = Der MX Record für die Standardrecords, wenn Sie die NS von DomainOffensive nutzen und eine Standardzone erstellen lassen möchten (leer lassen, falls nicht benötigt)
Admin Contact = Aktivieren Sie diese Option, wenn Sie die WHMCS eigene Aufteilung der Domain Kontakte überschreiben möchten und Sie als Hoster immer als Billing/TechC hinterlegt werden möchten
Default Records = Aktivieren Sie diese Option, wenn Sie die Nameserver von DomainOffensive nutzen möchten und auf diesen eine Standardzone für neu registrierte Domains erstellt werden soll.
Default Template = Wenn Sie ein bereits über das Resellerinterface erstelltes DNS Template verwenden möchten, tragen Sie hier bitte die ID des zu verwendeten Templates ein. Hinweis: Bei Verwendung eines Defaulttemplates müssen im Modul alle im Template verwendeten Platzhalter hinterlegt werden. Verwenden Sie z.B. mxIPv6 in Ihrem Template, dann muss dies in der oben erwähnten Option hinterlegt werden. Your DO.de Nameserver = Wenn Sie die Nameserver von DomainOffensive nutzen, tragen Sie diese bitte hier ein, ein Nameserver je Zeile.
DNSSEC = Wenn Sie diese Option aktivieren, wird dem Kunden ein zusätzlicher Menüpunkt zur Hinterlegung von DNSKEYs für DNSSEC angezeigt. Diese Keys werden dann bei der Registry hinterlegt.
Hinweis: Stand 14.08.2023 unterstützen die mainns Nameserver kein DNSSEC. Wenn DNSSEC genutzt werden soll, werden DNSSEC fähige Nameserver benötigt.

Denken Sie bitte daran, Ihre Server-IPs im Resellerinterface unter Verwaltung-Einstellungen freizugeben.

Domainchecker

Wenn Sie die Verfügbarkeitsprüfung über DomainOffensive laufen lassen möchten, gehen Sie im WHMCS Adminbereich nach Setup/Product,Services/Domain Pricing und klicken dort beim Lookup Provider auf Change. Wählen Sie dann „Domain Registrar“ aus und wählen dann DomainOffensive aus. Nun nutzt der WHMCS Domainchecker die API von DomainOffensive für seine Verfügbarkeitsprüfungen.

Beachten Sie aber bitte, dass Sie eventuell ein begrenztes Abfragekontingent haben.

Funktionen

Im Adminbereich haben Sie bei der Domain neben den WHMCS Default Buttons noch zusätzliche Buttons. Diese Buttons haben folgende Funktionen:

Transit (Immediately) = Sofortige Rückgabe einer Domain an die Registrierungsstelle, sofern von der Registrierungsstelle unterstützt
Transit (on Expiritydate) = Rückgabe der Domain an die Registrierungsstelle zum Auslaufdatum, sofern von der Registrierungsstelle unterstützt
Restore = Wiederherstellen einer gelöschten Domain.
Start Sync = Manueller Start des Domainsync für diese Domain

Wird in WHMCS die Checkbox aktiviert das die Domain nicht verlängert werden soll, wird diese Einstellung an Domain-Offensive übertragen. Als Kündigungszeitpunkt wird das Auslaufdatum verwendet. Das Modul berücksichtigt keine Kündigungsfristen der einzelnen TLDs.
Wird die Checkbox später wieder deaktiviert, dann wird die Kündigung widerrufen.

Verwendung

DNS Verwaltung

Ist für die Domain die DNS Verwaltung aktiviert, kann der Kunde über den Kundenbereich DNS Records anlegen. Wenn der Kunde einen Eintrag löschen möchte, ist es bei WHMCS standardmäßig so, dass er die Werte beim betroffenen Record entfernt und die Einstellungen speichert.

DNSSEC Management

Ist die DNSSEC Verwaltung aktiviert, kann der Kunde seine DNSKEY’s über den Kundenbereich hinterlegen. Zum Entfernen von DNS muss der Kunde, wie bei der DNS Verwaltung die Werte (in diesem Fall den Key) des betroffenen Schlüssels löschen und die Einstellungen speichern.

Update Hinweise

Version 3.0

Ab Version 3.0 unterstützt das Modul die neue REST-Api Schnittstelle, sollte Ihr Account noch nicht auf das neue System von DomainOffensive migriert worden sein, können Sie das Modul noch nicht einsetzen. Sprechen Sie hierzu mit Ihrem Anbieter, um einen Zeitpunkt der Migration festzulegen.

Wenn Sie vorher das Domain-Bestellsystem Modul verwendet haben, und da auch die Domain-Bestellsystem Version genutzt haben, laden Sie die neuen Moduldateien bitte hoch und ändern bei allen betroffenen Domains den zuständigen Registrar von Domain-Bestellsystem auf DomainOffensive. Dazu können Sie z.B. folgenden SQL Befehl verwenden:

UPDATE 'tbldomains' SET 'registrar' = 'DomainOffensive' WHERE 'tbldomains'.'registar' = DomainBestellsystem;

Vor manuellen Anpassungen an der Datenbank sollte ein Backup erstellt werden

WHMCS

DomainOffensive Registrarmodul