Zuletzt geändert von Jonas Mayer am 2023/10/14 21:30

Von Version 1.2
bearbeitet von David Haido
am 2022/04/04 11:18
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 16.1
bearbeitet von Jonas Mayer
am 2022/05/30 19:22
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.davidhaido@sbede
1 +XWiki.jonasmayer@sbede
Inhalt
... ... @@ -1,5 +1,9 @@
1 -Alle Konfigurationen, finden in der ldhost.yaml statt.
1 +(% style="color:#000000" %)WPAD macht es möglich, dass der LD-Server den Clients im pädagogischen Netzwerk automatisch eine dynamische Web-Proxy Konfiguration mitteilt. Dies funktioniert sowohl an festen Clients als auch an privaten Geräten der Benutzer (BYOD).
2 +Über die WPAD-Konfigurationsdatei entscheiden alle gängigen Browser, ob und über welchen Proxy-Server die Verbindung zur Zieladresse hergestellt werden muss. Hierzu bietet LogoDIDACT seit Puppet-Version 1.4.x einige Einstellmöglichkeiten, die nachfolgend beschrieben werden.(%%)
3 +
2 2  
5 +(% style="color:#000000" %)Alle Konfigurationen finden in der YAML-Datei **/etc/logodidact/hiera/custom.d/ldhost.yaml** im Puppeteer statt.
6 +
3 3  {{code language="bash" width="100%"}}
4 4  lxc-ssh -n puppeteer
5 5  {{/code}}
... ... @@ -9,32 +9,47 @@
9 9  {{/code}}
10 10  
11 11  
12 -Bei den möglichen Einstellungen, handelt es sich um:
16 +(% style="color:#000000" %)Darin können seit Puppet-Version 1.4 folgende drei Einstellungen konfiguriert werden:
13 13  
14 -1. Use Proxy
15 -1. Direct Domains
16 -1. Use Proxy Sites
18 +{{toc numbered="true" start="6"/}}
17 17  
18 18  
19 -~1. Use Proxy
20 20  
22 +====== (% style="color:#000000" %)Use Proxy(%%) ======
23 +
21 21  {{code language="bash" width="100"}}
22 -ld_legacy::wpad::use_proxy: true/false
25 +ld_legacy::wpad::use_proxy: true/false #Default = true
23 23  {{/code}}
24 24  
25 -Hier wird festgelegt ob überaupt ein Peoxy verwendet werden soll. Mit den paramtetern true/false wird das festgelegt.
28 +(% style="color:#000000" %)Hier wird festgelegt, ob der Server generell als Proxy verwendet werden soll. Mit den Parametern true/false wird das entsprechend festgelegt.
26 26  
27 27  
28 28  
29 -todo...erklären:
32 +====== (% style="color:#000000" %)Direct Domains(%%) ======
30 30  
34 +{{code language="bash" width="100"}}
35 +ld_legacy::wpad::direct_domains:
36 + - "www.beispiel.de"
37 + - "www.beispiel.com"
31 31  
32 - - [REF] Replace ld-wpad with puppet managed wpad:
33 - . [NEW] Allow to enable/disable wpad (switch to always DIRECT vs PROXY)
34 - . [NEW] Allow to avoid content filter for:
35 - . specific domains
36 - . SSL/TLS connections (https)
37 - . Avoiding proxy for:
38 - . local and s4 domain
39 - . known internal networks
40 - . [NEW] defined networks
39 +{{/code}}
40 +
41 +(% style="color:#000000" %)Mit dem Parameter Direct Domains kann festgelegt werden, welche Seiten explizit ohne Proxy vom Client aus angesteuert werden sollen. Bei Eintragung in die YAML-Datei ist es wichtig, sich am Beispiel zu orientieren, falls mehrere Zieladressen als Proxy-Ausnahme definiert werden sollen. Auch auf die Einrückung muss pro Zeile geachtet werden (diese muss  identisch zum restlichen Inhalt der Datei gewählt werden, z.B. 2 Leerzeichen). Der Vorteil dieser Variante ist ist, dass Einträge über das Kommando {{box}}git commit{{/box}} wie sonstige Optionen im Puppeteer eingespeichert werden müssen und dadurch in der {{box}}git log{{/box}} Historie des Verzeichnisses /etc/logodidact/ nachvollziehbar bleiben.
42 +
43 +
44 +
45 +====== (% style="color:#000000" %)Use NoProxySites(%%) ======
46 +
47 +{{code language="bash" width="100"}}
48 +ld_legacy::wpad::use_no_proxy_sites: true/false #Default = false
49 +{{/code}}
50 +
51 +Bei Aktivierung wird der Proxy für ausgewählte Zieladressen am Client ausgelassen. Diese Einstellung ähnelt dem vorherigem Parameter, die Liste der Proxy-Ausnahmen wird in diesem Falle jedoch ergänzend aus der Datei **/etc/logodidact/Internet.conf** im Container logosrv geladen. Die Liste setzt sich dynamisch aus dem Parameter "NoProxySites" und den darin befindlichen Einträgen zusammen, so wie in der **internet.conf** definiert. Statt eine solche Liste direkt im Puppeter zu pflegen, wird in dieser Variante also am Git-System im Puppeteer vorbei gearbeitet.
52 +
53 +
54 +
55 +(% style="color:#000000" %)Sollten die Einstellungen vorgenommen oder später geändert worden sein, muss im **ldhost **noch ein {{box}}prun{{/box}} zur Aktivierung ausgeführt werden.
56 +
57 +{{code language="batch" width="100"}}
58 +prun
59 +{{/code}}