README

Das Contao System Info Bundle stellt geschützte Systeminformationen einer Contao-Installation für den Contao Domain Manager bereit.

Es wird auf jeder Contao-Installation installiert, die zentral überwacht oder synchronisiert werden soll.

Funktionen

automatische Erzeugung einer eindeutigen Installations-ID
automatische Erzeugung eines sicheren Secrets
geschützter System-Info-Endpunkt
Bereitstellung von Contao-Version und PHP-Version
Bereitstellung von Datenbankname und DocumentRoot
Backend-Modul zur Anzeige und Verwaltung der Zugangsdaten
Secret standardmäßig verborgen und nur auf ausdrückliche Aktion sichtbar
Secret kann bei Bedarf neu erzeugt werden
keine manuelle Bearbeitung von .env-, JSON- oder Composer-Dateien erforderlich

Voraussetzungen

PHP ^8.2
Contao ^4.13 || ^5.0

Installation

Installiere das Bundle über den Contao Manager:

lebensbaum/contao-system-info-bundle

Führe anschließend die von Contao angebotene Datenbankmigration aus.

Nach erfolgreicher Installation steht im Backend unter System → System-Info die Verbindungskonfiguration zur Verfügung.

Einrichtung

Beim ersten Aufruf erzeugt das Bundle automatisch:

eine Installations-ID
ein Secret
den System-Info-Endpunkt

Das Secret wird standardmäßig verborgen angezeigt. Über Secret anzeigen kann es für den aktuellen Seitenaufruf einmalig eingeblendet und kopiert werden. Beim nächsten Seitenaufruf ist es wieder verborgen.

Diese Daten werden benötigt, um die Installation mit dem Contao Domain Manager zu verbinden.

Verbindung mit dem Domain Manager

Öffne auf der Zielinstallation System → System-Info.
Kopiere die Installations-ID.
Klicke auf Secret anzeigen und kopiere das Secret.
Öffne im Domain Manager die gewünschte Installation.
Trage Installations-ID und Secret ein.
Führe Verbindung testen aus.
Nach erfolgreichem Test können die Systeminformationen synchronisiert werden.

Bei der Synchronisation können unter anderem folgende technische Angaben übernommen werden:

Contao-Version
PHP-Version
Datenbankname
DocumentRoot

Secret neu erzeugen

Das Secret kann im Backend jederzeit neu erzeugt werden.

Nach einer Änderung muss das neue Secret auch im zugehörigen Eintrag des Domain Managers hinterlegt werden. Das bisherige Secret ist danach nicht mehr gültig. Das neu erzeugte Secret wird einmalig angezeigt und ist nach dem nächsten Seitenaufruf wieder verborgen.

Sicherheit

Der System-Info-Endpunkt ist nicht für eine öffentliche Nutzung vorgesehen. Der Zugriff wird über Installations-ID und Secret geschützt und die Anfrage signiert.

Das Secret wird verschlüsselt gespeichert und im Backend nicht ohne ausdrückliche Aktion im Klartext ausgegeben. Es sollte vertraulich behandelt und nur an Personen weitergegeben werden, die die Verbindung zum Domain Manager administrieren.

Es werden keine Datenbank-Zugangsdaten wie Benutzername oder Passwort übertragen. Aus der Datenbankverbindung wird ausschließlich der Datenbankname bereitgestellt.

Domain Manager

Die zentrale Verwaltung erfolgt mit:

lebensbaum/contao-domain-manager-bundle

Repository:

https://github.com/lebensbaum-gmbh/contao-domain-manager-bundle

Lizenz

Dieses Projekt ist unter der MIT License veröffentlicht.

Siehe LICENSE.

Support und Fehlerberichte

Fehler und technische Probleme können über die GitHub-Issues des Projekts gemeldet werden:

https://github.com/lebensbaum-gmbh/contao-system-info-bundle/issues

Quellcode:

https://github.com/lebensbaum-gmbh/contao-system-info-bundle

lebensbaum / contao-system-info-bundle

Maintainers

Package info

Statistics

Security