Help Center / api

Domains aus FOSSBilling verkaufen mit dem OSIR-Plugin

Mit dem OSIR-Registrar-Plugin verkauft Ihre FOSSBilling-Installation Domains. Ihre Kunden suchen, registrieren, transferieren und verlängern in Ihrem Shop, unter Ihrer Marke und zu Ihren Preisen; OSIR führt die Registrierung aus und belastet Ihr Reseller-Guthaben. Das Plugin ist kostenlos und quelloffen unter der Apache-Lizenz 2.0.

Die Einrichtung dauert etwa zwanzig Minuten. Diese Anleitung beschreibt alle fünf Schritte und die Stolpersteine.

Bevor Sie beginnen

Es gibt keinen Testmodus. OSIR hat keine Testumgebung, jede Aktion ist echt und wird Ihrem Guthaben belastet. Solange FOSSBillings eigener Test Mode eingeschaltet ist, verweigert das Plugin jede Aktion und schreibt eine entsprechende Zeile ins Log. Zum Ausprobieren registrieren Sie eine günstige Domain für sich selbst.

Schritt 1: API-Schlüssel erstellen

Erstellen Sie im OSIR-Panel einen API-Schlüssel. Er beginnt mit osir_live_. Testschlüssel gibt es nicht.

Bitten Sie uns, den Schlüssel auf die IP-Adresse Ihres FOSSBilling-Servers zu beschränken. Wenden Sie sich dafür an den Support.

Wo der Schlüssel gehört. Am robustesten ist FOSSBillings config.php, die ein Array zurückgibt. Ergänzen Sie einen osir-Eintrag:

return [
    // ... FOSSBillings eigene Einstellungen ...
    'osir' => [
        'api_key' => 'osir_live_...',
    ],
];

Ein so gesetzter Schlüssel hat Vorrang vor dem Feld im Adminbereich, taucht nicht in Datenbank-Backups auf und überlebt das Neuschreiben der config.php durch FOSSBilling-Updates. Alternativ fügen Sie den Schlüssel in die Registrar-Einstellungen ein: FOSSBilling 0.8.7 speichert ihn und zeigt ihn nie wieder an, sondern nur ein Abzeichen "Configured".

Schritt 2: Plugin installieren

Laden Sie osir-fossbilling-registrar-1.2.1.zip aus dem neuesten Release und prüfen Sie es gegen die veröffentlichten Prüfsummen:

sha256sum -c SHA256SUMS --ignore-missing

Entpacken Sie es in Ihr FOSSBilling-Stammverzeichnis. Das Archiv enthält nur diese Pfade und kann daher keine FOSSBilling-Datei überschreiben:

library/Registrar/Adapter/Osir.php
library/Registrar/Adapter/Osir/...
modules/Osir/...            (das optionale Admin-Modul "OSIR import")

Schritt 3: Verbinden

1. Öffnen Sie im Adminbereich Domain Management und dann Registrars.
2. Suchen Sie Osir unter den installierbaren Registraren und klicken Sie auf Install.
3. Tragen Sie Ihren API-Schlüssel ein, sofern er nicht bereits in Schritt 1 in der config.php steht.
4. Lassen Sie Test Mode ausgeschaltet.

Die Einstellungen im Einzelnen:

Der API-Endpunkt ist bewusst keine Admin-Einstellung, damit jemand mit Zugang zu Ihrem Panel Ihren API-Schlüssel nicht auf einen anderen Server umleiten kann.

Schritt 4: Preise festlegen

Aktivieren Sie unter Extensions das Modul OSIR import und öffnen Sie dann System und OSIR import. Beide Schritte lesen ausschließlich von OSIR: es wird nichts registriert, verlängert oder belastet.

TLDs und Preise. Laden Sie den Katalog (rund 450 TLDs), filtern oder suchen Sie, wählen Sie die gewünschten aus und legen Sie Ihren Aufschlag fest: ein Prozentsatz, dazu optional ein fester Betrag, aufgerundet auf .99 oder auf einen ganzen Betrag.

• Ihre Kosten sind das Angebot von OSIR für Ihr Konto: der Registry-Preis für einen Standardnamen plus ICANN-Gebühr und OSIR-Gebühr, pro Jahr.
• Aktionspreise für das erste Jahr werden ignoriert, weil FOSSBilling nur einen Preis pro TLD führt.
• Preview prices zeigt Kosten und Verkaufspreis, ohne etwas zu speichern. Import selected legt die TLDs mit dem gezeigten Preis an. Bereits bei OSIR vorhandene TLDs werden nur neu bepreist, wenn Sie Also re-price ankreuzen; TLDs anderer Registrare werden nie verändert.
• Zeilen mit Warndreieck haben geschätzte Verlängerungs- oder Transferkosten. Prüfen Sie diese vor dem Verkauf.

Domains. Laden Sie im Reiter Domains Ihre bestehenden OSIR-Domains, wählen Sie einen FOSSBilling-Kunden und die zu importierenden Domains. Jede wird zu einem aktiven Auftrag dieses Kunden mit echtem Ablaufdatum, Nameservern und Registrant-Kontakt von OSIR. Nichts wird erneut registriert und nichts belastet. Importieren Sie zuerst die TLDs.

Schritt 5: Selbst ausprobieren

Registrieren Sie eine günstige Domain für Ihr eigenes Konto. Sobald der Auftrag aktiv ist, können Sie verkaufen.

So funktionieren Verlängerungen

FOSSBilling stellt Ihrem Kunden vor dem Ablauf eine Rechnung. Ist sie bezahlt, verlängert das Plugin die Domain bei OSIR. Die automatische Verlängerung von OSIR ist für diese Domains bewusst ausgeschaltet, weil FOSSBilling den Verlängerungszyklus steuert. Eine kurz nach Ablauf bezahlte Verlängerung wird noch ausgeführt, solange die Registry es zulässt.

Eine Domain, deren Verlängerung bei OSIR unbezahlt ist, kann nicht importiert werden: die Registry hat das Ablaufdatum bereits um ein Jahr verschoben, sodass FOSSBilling nicht rechtzeitig abrechnen würde. Verlängern Sie sie zuerst bei OSIR.

Häufige Stolpersteine

Sie zahlen nie doppelt. Jede Registrierung, Verlängerung und jeder Transfer trägt einen eindeutigen Schlüssel, sodass eine abgebrochene Verbindung, ein wiederholter Cron-Lauf oder ein Doppelklick das Ergebnis des ersten Versuchs liefert statt erneut zu belasten. Lässt sich eine Aktion nicht bestätigen, wird der Auftrag zur Prüfung vorgelegt und nicht geraten.

DNS, die Ihre Kunden selbst verwalten

Ab Version 1.2.1 erhält jede Domain, die ein Kunde bei Ihnen hält, eine DNS-Seite in Ihrem Kundenbereich. Dort listet, ergänzt, ändert und löscht er die Einträge dieser einen Domain - A, AAAA, CNAME, MX, TXT und weitere - ohne ein Ticket bei Ihnen zu öffnen.

• Sie ist in der bereits gekauften Domain enthalten. Kein separater Tarif, keine zusätzliche Bestellung, keine Rechnung.
• Sie gilt pro Domain, für den Kunden. Es ist kein DNS-Hosting-Produkt und kein Sammel-Editor für Sie als Reseller.
• Ein Kunde sieht die Seite nur für seine eigenen Domains und nur für Domains, die über OSIR registriert sind. Die Zugehörigkeit wird aus seinem eigenen Auftrag ermittelt und bei jedem Aufruf erneut bei OSIR geprüft.
• Der Zonen-Apex ist geschützt: der SOA-Eintrag und die Nameserver-Einträge der Domain selbst lassen sich weder ändern noch löschen, sodass niemand versehentlich seine Zone offline nimmt. Ein CNAME auf die Domain selbst wird ebenfalls abgelehnt, weil er Mail und Web zerstören würde.
• Einträge werden vor dem Senden validiert, und die Seite warnt, wenn die Domain nicht die Nameserver von OSIR verwendet, damit keine Einträge bearbeitet werden, die ohnehin nie auflösen könnten.

Woher der DNS-Reiter kommt. Die Seite liegt unter /osir/dns/<order id>. Die Domain-Seite von FOSSBilling lässt sich nicht durch ein Modul erweitern, daher stammt der Reiter neben Nameservers aus dem Theme. Mit dem OSIR-Theme erhalten Sie ihn automatisch; in Ihrem eigenen Theme ergänzen Sie den einzeiligen Link aus der README. Die Seite selbst funktioniert in beiden Fällen.

Nicht in dieser Version enthalten: DNSSEC-Verwaltung, Zonen-Import und Sammelbearbeitung von Einträgen.

Das optionale Theme

Jedes Release enthält außerdem osir-fossbilling-theme-1.2.1.zip, ein Theme für den Kundenbereich mit Domainsuche auf der Startseite. Es ist unabhängig vom Registrar-Plugin: nutzen Sie es, passen Sie es an, oder behalten Sie Ihr eigenes. Siehe die Theme-README.

Hilfe erhalten

Wenden Sie sich an den Support und nennen Sie die Referenznummer aus der Fehlermeldung. Sicherheitsprobleme melden Sie bitte vertraulich über denselben Kanal mit dem Vermerk "security".

Siehe auch: die Übersicht zum FOSSBilling-Plugin und den Quellcode auf GitHub.