regain manual

====== How-To: Zugriff auf Desktopsuche von anderen Rechnern aus ====== ===== Das Problem ===== Der Zugriff auf die Desktopsuche ist in der offiziellen regain-Version aus Sicherheitsgründen nur vom lokalen Rechner aus (''localhost'') erlaubt. ===== Lösungsansatz ===== Per Konfiguration den Zugriff auch für externe Aufrufer erlauben. ===== Vorteile ===== Die Desktopsuche lässt sich dadurch auch im Netzwerk wie ein Server benutzen. ===== Nachteile ===== Jeder Rechner im gleichen Netzwerk hat Zugriff auf alle Dokumente, die im Suchindex enthalten sind. Falls der Rechner mit der regain-Installation direkt im Internet hängt und der von regain verwendete Port nicht durch eine Firewall geschützt ist, dann jeder Rechner im Internet auf alle Dokumente im Index zugreifen! ===== Implementierung ===== In der DesktopConfiguration wurde folgender Tag eingefügt: <code xml> <!-- Allow/Disallow external access to the running desktop instance --> <allow_external_access>true</allow_external_access> </code> ==== Änderungen im Quelltext ==== * In der Schnittstelle ''DesktopConfig.java'' hinzufügen: <code java> public boolean getExternalAccessAllowed() throws RegainException; </code> * In der Klasse ''XmlDesktopConfig.java'' zu Methode ''loadConfig()'' hinzufügen: <code java> node = XmlToolkit.getChild(config, "allow_external_access"); mExternalAccessAllowed = ( node == null ) ? false : XmlToolkit.getTextAsBoolean(node); </code> <code java> public boolean getExternalAccessAllowed() throws RegainException { loadConfig(); return mExternalAccessAllowed; } </code> Definition von ''mExternalAccessAllowed'' als private boolean. * In Klasse ''FileService.java'': Ändern Zeile 43 in: <code java> if (!localhost && !DesktopToolkit.getDesktopConfig().getExternalAccessAllowed() ) { </code> * In Klasse ''SharedTagService.java'': Ändern Zeile 88 in: <code java> if (!localhost && !DesktopToolkit.getDesktopConfig().getExternalAccessAllowed() ) { </code> ===== Umgesetzt in ===== Branch: ''contrib-v1.2.3-thtesche'' Revision: ''312'' ===== Einschränkungen ===== Defaultmäßig sollte der externe Zugriff nicht erlaubt sein. **Autor:** Thomas Tesche, cluster:Consult, http://www.thtesche.com/