Changes between Version 11 and Version 12 of Documentatie/Beheerder/Modules/Documentserver

Timestamp:

01/06/22 14:02:12 (4 years ago)

Author:

henk

Comment:

--

Documentatie/Beheerder/Modules/Documentserver

@@ -30 +30 @@
 }}}
 
-||**Type**||"WebDAV" om WebDAV te gebruiken, anders "Filesystem"||
-||**Host**||De hostnaam van de server waar OpenAC 3 en de WebDAV-server op draaien. OpenAC clients moeten de server met deze naam kunnen benaderen||
-||**Port**||Het poortnummer waarop de WebDAV-server te bereiken is. Het poortnummer mag niet in gebruik zijn (ook niet door OpenAC 3) en moet worden vrijgegeven in de firewall||
-||**Dir**||De documentenmap van OpenAC. Het pad mag zowel in UNC-notatie of met een schijfletter worden opgegeven maar gebruik altijd **forward slashes**||
-||**!LogDir**||Lokale servermap waar de WebDAV-server zijn logbestand naartoe schrijft. Gebruik een schijfletter en **forward slashes**||
-||**KeyFile**||De key van het SSL-certificaat in PEM-formaat||
-||**CertFile**||Het SSL-certificaat in PEM-formaat||
+||{{{Type}}}||"WebDAV" om WebDAV te gebruiken, anders "Filesystem"||
+||{{{Host}}}||De hostnaam van de server waar OpenAC 3 en de WebDAV-server op draaien. OpenAC clients moeten de server met deze naam kunnen benaderen||
+||{{{Port}}}||Het poortnummer waarop de WebDAV-server te bereiken is. Het poortnummer mag niet in gebruik zijn (ook niet door OpenAC 3) en moet worden vrijgegeven in de firewall||
+||{{{Dir}}}||De documentenmap van OpenAC. Het pad mag zowel in UNC-notatie of met een schijfletter worden opgegeven maar gebruik altijd **forward slashes**||
+||{{{LogDir}}}||Lokale servermap waar de WebDAV-server zijn logbestand naartoe schrijft. Gebruik een schijfletter en **forward slashes**||
+||{{{KeyFile}}}||De key van het SSL-certificaat in PEM-formaat||
+||{{{CertFile}}}||Het SSL-certificaat in PEM-formaat||
 
 **Let op:** De WebDAV-server gebruikt dezelfde configuratiebestanden als OpenAC (appsettings.json en hosting.json) maar is strikter dan OpenAC wat JSON-fouten betreft. Bij syntactische fouten in de JSON-bestanden start de WebDAV-server niet op.
@@ -44 +44 @@
 * Als openac-webdav niet opstart, probeer de executable dan op te starten vanaf de command line. Foutmeldingen verschijnen op de console.
 
+Bij configuratiewijzigingen moet de WebDAV-server worden gestopt en gestart. Zie "Stoppen & Starten".
+
 == Certificaat ==
-Communicatie tussen Office en de WebDAV-server is beveiligd met een SSL-certificaat. Om ingebruikname van de server te vergemakkelijken leveren we een door de Fenac uitgegeven certificaat mee met OpenAC. Dit certificaat is te vinden in de map Modules\WebDAV. Om het te kunnen gebruiken moet het rootcertificaat hiervan worden vertrouwd. Doe dit door FenacCA.cer te installeren als vertrouwd basiscertificaat.
+Communicatie tussen Office en de WebDAV-server is beveiligd met een SSL-certificaat. Zonder een geldig certificaat werkt de koppeling niet.
+
+Uit bovenstaande voorbeeldconfiguratie blijkt dat de WebDAV-server moet worden geconfigureerd met een SSL-certificaat en -key in aparte bestanden. Als je een certificaat in PKCS#12-formaat hebt (met pfx- of p12-extensie) dan kun je met behulp van openssl het certificaat en key exporteren naar de vereiste bestanden in PEM-formaat. In beide gevallen zal openssl vragen om het wachtwoord van de private key:
+
+Exporteer private key
+{{{#
+openssl pkcs12 -in openac-certificaat.pfx -out openac-certificaat.key -nodes -nocerts
+}}}
+
+Exporteer certificaat
+{{{
+openssl pkcs12 -in openac-certificaat.pfx -out openac-certificaat.crt -nokeys
+}}}
+
+Om de server te testen leveren we een door de Fenac uitgegeven certificaat mee met OpenAC. Dit certificaat is te vinden in de map Modules\WebDAV. Om het te kunnen gebruiken moet het rootcertificaat hiervan worden vertrouwd. Doe dit door FenacCA.cer te installeren als vertrouwd basiscertificaat. **Let op:** het meegeleverde certificaat is uitgegeven voor localhost en kan alleen lokaal op de server worden getest. Om de server te testen met het meegeleverde bestaat moet de TLS-sectie uit het configuratiebestand worden weggelaten
 
 == Stoppen & Starten ==