====== 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/