Konfiguration der App-Passwörter in Webapplikationen und Servlets

Die neu generierten Passwörter müssen in die Konfiguration der jeweiligen Webapplikationen und Servlets übernommen werden. Dazu gibt es unterschiedliche Möglichkeiten.

Über die Datei web.xml: Für die FirstSpirit-Webapplikationen können die App-Passwörter in der Datei web.xml der jeweiligen Webanwendung über den Parameter firstspirit.password konfiguriert werden, z. B.:

<!--  App Password for server connection. Not set = use default password   -->
<context-param>
  <param-name>firstspirit.password</param-name>
  <param-value>uNue gFTh pxtv D23C</param-value>
</context-param>

Nach dem Bearbeiten der Datei web.xml müssen die Webanwendungen neu gestartet werden, damit sich die Änderungen auswirken.

Über das System-Environment: Abhängig vom Betriebssystem kann die Konfiguration der App-Passwörter über betriebssystemspezifische Parameter direkt auf dem Application-Server erfolgen.

In einer Windows-Umgebung beispielsweise über den Aufruf:                                             
set FIRSTSPIRIT_PASSWORD=uNuegFThpxtvD23C  

In einer Linux-Umgebung über den Aufruf:                           
export FIRSTSPIRIT_PASSWORD=uNuegFThpxtvD23C

Über das Java-Environment: als –D-Property über:          
-Dfirstspirit.password=uNuegFThpxtvD23C 

Über die Datei fs-wrapper.conf (nur für den „Jetty Web Server“): Für den „Jetty Web Server“ kann die Konfiguration der App-Passwörter über Java-Properties innerhalb der Datei fs-wrapper.conf konfiguriert werden, z. B.: 
wrapper.java.additional.5=-Dfirstspirit.password=uNuegFThpxtvD23C

Wird anstelle eines Werts ein Leerstring übergeben oder wird der Parameter nicht konfiguriert, wird die Authentifizierung immer über das Default-Passwort ausgeführt. Das ist aber nur möglich, wenn das Default-Passwort aktiviert ist.

Wird das Passwort als System- oder Java-Parameter übergeben, darf es keine Leerzeichen enthalten.

Über die Servlet-Konfiguration: Für einzelne Applikationen kann eine Konfiguration auch über Servlet-Kontextparameter (in der Datei web.xml) erfolgen.

Auswertungsreihenfolge: Dabei gilt folgende Auswertungsreihenfolge von der höchsten bis zur niedrigsten Priorität:

1. Konfiguration des Parameters über das Java-Environment
2. Konfiguration des Parameters über das System-Environment      
3. Konfiguration des Parameters über die web.xml