859
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − {{Incomplete}} − {{Needs review}} − {{Level|Developer}} − + − + − + Line 25:
Line 22: − Add EPEL repo+ − /sbin/e-smith/db yum_repositories set epel repository \ − Name 'Epel - EL7' \ − BaseURL 'http://download.fedoraproject.org/pub/epel/7/$basearch' \ − MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-7&arch=$basearch' \ − EnableGroups no \ − GPGCheck yes \ − GPGKey http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL \ − Exclude perl-Razor-Agent \ − Visible no \ − status disabled − + − yum install smeserver-wsdd-0.1-2.noarch.rpm --enablerepo = epel,smecontribs+ − Signal-event reboot - the rpm now does systemctl enable wsdd+ − + + + + + + + + + + + + + − [root@sme10 ~]# config show wsdd Line 52:
Line 50: − # systemctl status wsdd + − # systemctl enable wsdd+ − # systemctl start wsdd+ − # systemctl restart wsdd+ − # systemctl disable wsdd+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − /usr/lib/systemd/system/wsdd.service+ − [Unit]+ − Description=Web Services Dynamic Discovery host daemon − After=network-online.target − After=bootstrap-console.service − Wants=network-online.target − # Wants=smb.service − [Service]+ − Type=simple+ − ExecStart=/usr/bin/wsdd 4 -i eth0 -w TF_SL --shortlog − ExecStartPre=/bin/sleep 30 − # User=wsdd − # Group=wsdd − + − [[Category:Howto]] − [[Category:Security]] − [[Category: Administration:Certificates]]
→Maintainer
{{Languages}}
{{Languages}}
===Maintainer===
===Maintainer===
[mailto:jcrisp@safeandsoundit.co.uk [[User:ReetP|Jonn C.]]] from [ https://www.reetspetit.com/
[mailto:jcrisp@safeandsoundit.co.uk][[User:ReetP|John C.]] from [https://www.reetspetit.com/]
=== Version ===
===Version===
{{#smeversion: smeserver-wsdd }}
{{#smeversion: smeserver-wsdd }}
=== Description ===
===Description===
wsdd implements a Web Service Discovery host daemon. This enables (Samba) hosts, like your local server device, to be found by Web Service Discovery Clients like Windows.
wsdd implements a Web Service Discovery host daemon. This enables (Samba) hosts, like your local server device, to be found by Web Service Discovery Clients like Windows.
===Installation===
===Installation===
yum install smeserver-wsdd --enablerepo=smecontribs
signal-event yum-modify
signal-event post-upgrade; signal-event reboot
The rpm now does a # systemctl enable wsdd
systemctl status wsdd.service
===Usage===
[root@sme10a5 ~]# systemctl status wsdd.service
● wsdd.service - Web Services Dynamic Discovery host daemon
Loaded: loaded (/usr/lib/systemd/system/wsdd.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2020-11-28 23:53:59 AEDT; 8min ago
Main PID: 2597 (python3)
CGroup: /system.slice/wsdd.service
└─2597 python3 /usr/bin/wsdd -4 -i eth0 -w sme-server -s
Nov 28 23:53:59 sme10a5.xxxx.xxxx.org systemd[1]: Started Web Services Dynamic Discovery host daemon.
====Usage====
config show wsdd
wsdd=service
wsdd=service
TCPPorts=3702,5357
TCPPorts=3702,5357
status=enabled
status=enabled
config setprop wsdd status enabled/disabled
Stop/Start/Restart/Disable
systemctl status wsdd
systemctl enable wsdd
systemctl start wsdd
systemctl restart wsdd
systemctl disable wsdd
Templated unit file
/usr/lib/systemd/system/wsdd.service
[Unit]
Description=Web Services Dynamic Discovery host daemon
After=network-online.target
After=bootstrap-console.service
Wants=network-online.target
# Wants=smb.service
[Service]
Type=simple
ExecStart=/usr/bin/wsdd 4 -i eth0 -w workgroup --shortlog
ExecStartPre=/bin/sleep 30
# User=wsdd
# Group=wsdd
====Example Usage====
handle traffic on eth0 only, but only with IPv6 addresses
wsdd -i eth0 -6
or
wsdd --interface eth0 --ipv6only
===Known Issues===
====Security====
wsdd does not implement any security feature, e.g. by using TLS for the http service. This is because wsdd's intended usage is within private, i.e. home, LANs. The Hello message contains the hosts transport address, i.e. the IP address which speeds up discovery (avoids Resolve message).
In order to increase the security, use the capabilities of the init system or consider the -u and -c options.
====Using only IPv6====
If wsdd is running on FreeBSD using IPv6 only, the host running wsdd may not be reliably discovered. The reason appears to be that Windows is not always able to connect to the HTTP service for unknown reasons. As a workaround, run wsdd with IPv4 only.
====Usage with NATs====
Do not use wssd on interfaces that are affected by NAT. According to the standard, the ResolveMatch messages emitted by wsdd, contain the IP address ("transport address" in standard parlance) of the interface(s) the application has been bound to into. When such messages are retrieved by a client (Windows hosts, e.g.) they are unlikely to be able to connect to the provided address which has been subject to NAT. To avoid this issue, use the -i/--interface option to bind wsdd to interfaces not affected by NAT.
====Tunnel/Bridge Interface====
If tunnel/bridge interfaces like those created by OpenVPN or Docker exist, they may interfere with wsdd if executed without providing an interface that it should bind to (so it binds to all). In such cases, the wsdd hosts appears after wsdd has been started but it disappears when an update of the Network view in Windows Explorer is forced, either by refreshing the view or by a reboot of the Windows machine. To solve this issue, the interface that is connected to the network on which the host should be announced needs to be specified with the -i/--interface option. This prevents the usage of the tunnel/bridge interfaces.
Background: Tunnel/bridge interfaces may cause Resolve requests from Windows hosts to be delivered to wsdd multiple times,´i.e. duplicates of such request are created. If wsdd receives such a request first from a tunnel/bridge it uses the transport address (IP address) of that interface and sends the response via unicast. Further duplicates are not processed due to the duplicate message detection which is based on message UUIDs. The Windows host which receives the response appears to detect a mismatch between the transport address in the ResolveMatch message (which is the tunnel/bridge address) and the IP of the sending host/interface (LAN IP, e.g.). Subsequently, the wsdd host is ignored by Windows.
===Bugs===
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
and select the smeserver-wsdd component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-wsdd|title=this link}}.
Below is an overview of the current issues for this contrib:{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component=smeserver-wsdd|noresultsmessage=No open bugs found.}}
===Changelog===
Only released version in smecontrib are listed here.
{{#smechangelog: smeserver-wsdd}}
----
[[Category:Contrib]]
[[Category:Contrib]]