Centaurus-Platform
| Anbindung an Confixx | |
|---|---|
| Die Benutzung der Benutzeraccounts in der Manageranwendung |  |
|
Von:
Thorsten Kamann <thorsten.kamann@planetes.de> Peter Roßbach <pr@objektpark.de> |
|
| Confixx ist ein sehr bekanntes Server-Verwaltungstool. Es ist z.B. bei den ROOT-Servern bei 1+1 schon vorinstalliert und erlaubt eine einfache Verwaltung von Web, FTP und Emailaccounts. In diesem HowTo erklären wir, wie Sie die Confixx Benutzeraccounts für Ihre Manageranwendung verwenden können. | |
| Inhalt:
|
Was ist Confixx?
Confixx ist eine Serververwaltungs-Tool, welches von sehr vielen
Hostern eingesetzt wird. Die Konfiguration erfolgt mittels einer
Weboberfläche, die sich in einen Admin-, Reseller- und Kundenbereich
aufteilt.
Für den Kunden ist das eine feine Sache, da er selbständig
Emailadressen, FTP-Accounts, Domains und Datenbanken verwalten
kann.
Auch der Reseller kann somit schnell seine Kunden und Angebote
verwalten. Der Admin vermeidet durch Confixx oftmals einen extra
SSH-Login und kann dadurch von jedem Internet-PC bestimmte
Dinge konfigurieren.
Die Confixx-Benutzeraccounts
Confixx speichert alle Konfigurationsdaten in einer Datenbank ab. Das
ist meistens MySQL. Auch die Benutzeraccounts der Kunden sind in
dieser Datenbank gespeichert.
Man kann Confixx so konfigurieren, dass man für alles den gleichen
Login benutzen kann. Dies wäre auch für die Manager-Anwendung
der Centaurus-Platform wünschenswert.
Darüberhinaus muss auch überprüft werden, ob der Benutzer sich auf
dem Host überhaupt einloggen darf.
Der ConfixxDatasourceRealm
Die Centaurus-Platform stellt für diese Aufgabenstellung einen eigenen Realm zur Verfügung: den ConfixxDatasourceRealm
Dieser Realm vergleicht den Login und prüft, ob der Benutzer sich auf
dem Host überhaupt einloggen darf.
Folgende Parameter werden unterstützt:
| className | Der Klassennamen des Realms. Hier sollten Sie den Wert de.centaurus.platform.catalina.ext.realm.ConfixxDatasourceRealm benutzen. |
|---|---|
| dataSourceName | Der Name der Datasource, die verwendet werden soll. Die Datasource muss existieren und korrekt konfiguriert sein. |
| customerTable | Der Name der Tabelle mit den Kundendaten. Dies ist normalerweise die Tabelle kunden. |
| domainTable | Der Name der Tabelle, die die Domainnamen enthält ( standard: domains). |
| customerNameCol | Der Feldname aus der customerTable, der den Loginnamen des Benutzers enthält (Standard: kunde). |
| customerCredCol | Der Feldname aus der customerTable, der das Passwort des Benutzers enthält (Standard: longPW). |
| domainCustomerNameCol | Der Feldname aus der domainTable, der den Loginnamen des Benutzers enthält (Standard: kunde). |
| domainNameCol | Der Feldname aus der domainTable, der die Domainnamen enthält (Standard: domain). |
| debug | Gibt den Debug-Level an (Standard: 0). |
Diesen Realm können Sie also so konfigurieren:
<Realm className="de.centaurus.catalina.ext.realm.ConfixxDatasourceRealm" dataSourceName="db/confixx" customerCredCol="longpw" customerNameCol="kunde" domainNameCol="domain" domainCustomerNameCol="kunde" domainTable="domains" customerTable="kunden" />
Die zugehörige Datasource könnte so aussehen:
<Resource name="db/confixx" type="javax.sql.DataSource"/>
<ResourceParams name="db/confixx">
<parameter>
<name>driverClassName</name>
<value>com.mysql.jdbc.Driver</value>
</parameter>
<parameter>
<name>url</name>
<value>jdbc:mysql://localhost/confixx</value>
</parameter>
<parameter>
<name>username</name>
<value>IHR_DB_USERNAME</value>
</parameter>
<parameter>
<name>password</name>
<value>IHR_DB_PASSWORT</value>
</parameter>
<parameter>
<name>validationQuery</name>
<value>SELECT count(*) FROM kunden</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>5000</value>
</parameter>
<parameter>
<name>maxActive</name>
<value>4</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>2</value>
</parameter>
</ResourceParams>
<Resource name="db/confixx" auth="Container" type="javax.sql.DataSource"/>
HostCreator-Template
Der Hostcreator liefert ein Template mit, das das ConfixxDatasourceRelam
nutzt. Wählen Sie als Template host_confixx.xml aus.
In dem Template müssen Sie vor der ersten Verwendung die Parameter
username und password ersetzen.