Uvajanje WebDAV v Debian 10 z uporabo WsgiDAV

• Uvod
• Predpogoji
• Namestitev
• nadaljnje branje

Uvod

Spletno distribuirano avtorstvo in različice (WebDAV) je razširitev HTTP, ki zagotavlja okvir za oddaljeno ustvarjanje in spreminjanje datotek na strežniku. WsgiDAV je strežnik WebDAV, napisan v pythonu. Ta vodnik vam bo pomagal pri namestitvi WsgiDAV različice 3.0 na strežnik Vultr z operacijskim sistemom Debian 10. Pridobili bomo tudi certifikat SSL za zagotavljanje varne povezave in preverjanje pristnosti PAM.

Predpogoji

• Sistem Debian 10, do katerega imate privilegiran dostop (prek uporabnika root ali katerega koli uporabnika sudo.)
• Spremenljivka $EDITORokolja mora biti nastavljena na urejevalnik besedil po vaši izbiri.
• Potrebno je registrirano ime domene. Njegovi imenski strežniki morajo biti konfigurirani z Azapisom, ki kaže na naslov IPv4 vašega strežnika, in po želji AAAAzapisom, ki kaže na naslov IPv6.
• Priporočljivo je poznavanje sintakse YAML.

Nadomestni znak dav.example.combo uporabljen za ime domene vašega strežnika.

Namestitev

SSL certifikat

Začeli bomo s posodobitvijo sistema in pridobitvijo brezplačnega SSL certifikata pri Let's Encrypt . Če želite to narediti, najprej posodobite sistem in namestite certbotpripomoček:

sudo apt update sudo apt upgrade -y sudo apt install -y certbot

V spodnjem ukazu zamenjajte dav.example.comin email@domain.tlds svojim imenom domene oziroma e-poštnim naslovom, preden ga izvedete:

sudo certbot certonly --standalone --agree-tos -m email@domain.tld -d dav.example.com

Vašemu strežniku bo poslan izziv za preverjanje, ali nadzorujete navedeno ime domene. Če uspe, bo potrdilo izdano in shranjeno skupaj z drugimi datotekami, kot je zasebni ključ, pod /etc/letsencrypt/live/dav.example.com/.

Namestitev WsgiDAV

Najprej namestite upravitelja paketov python pip:

sudo apt update sudo apt install -y python3-pip

WsgiDAV zahteva strežnik HTTP, ki podpira WSGI. Namestili bomo privzeto možnost, ki je Cheroot. Namestili bomo tudi knjižnico python lxml, ki je boljša od privzeto nameščene knjižnice XML. Potrebna je tudi knjižnica PAM (Pluggable Authentication Module) python3. Namestite zahtevane pakete z piporodjem:

sudo pip3 install wsgidav cheroot lxml python-pam

Konfiguriranje WsgiDAV

Izvedljiva datoteka WsgiDAV je shranjena v /usr/local/bin, zato bomo konfiguracijsko datoteko postavili v /usr/local/etcimenik. Prenesite vzorčno konfiguracijsko datoteko z naslednjimi ukazi:

sudo mkdir -p /usr/local/etc sudo wget https://github.com/mar10/wsgidav/raw/master/sample_wsgidav.yaml -O /usr/local/etc/wsgidav.yaml

Odprite ga z urejevalnikom:

sudo $EDITOR /usr/local/etc/wsgidav.yaml

Poiščite naslednje vrstice v razdelku »SSL Support«:

# ssl_certificate: "wsgidav/server/sample_bogo_server.crt" # ssl_private_key: "wsgidav/server/sample_bogo_server.key" # ssl_certificate_chain: null

Zamenjajte jih z naslednjim:

ssl_certificate: "/etc/letsencrypt/live/dav.example.com/cert.pem" ssl_private_key: "/etc/letsencrypt/live/dav.example.com/privkey.pem" ssl_certificate_chain: "/etc/letsencrypt/live/dav.example.com/chain.pem"

Nato bomo konfigurirali poti skupne rabe s preslikavo poti HTTP (kot je /) na ustrezne lokacije v datotečnem sistemu (kot je /var/www/dir1). Za namene predstavitve si bomo delili dva imenika, od katerih bo eden samo za branje. Poiščite provider_mappingblok v razdelku »DELNICI«:

provider_mapping: "/": "/path/to/share1" "/pub": root: "/path/to/share2" readonly: true "/share3": provider: path.to.CustomDAVProviderClass args: ["/path/to/share3", "second_arg"] kwargs: {"another_arg": 42}

Zamenjaj ga:

provider_mapping: "/": root: "/var/www/html/documents" readonly: false "/reports": root: "/var/www/html/reports" readonly: true

S temi preslikavami https://dav.example.com:8080/bo ustrezal /var/www/html/documentsimeniku na strežniku, medtem ko https://dav.example.com:8080/reportsbo preslikal v /var/www/html/reportsbrez dostopa za pisanje.

Za preverjanje pristnosti bomo uporabili gonilnik PAM. To odpravlja potrebo po ločenih uporabniških računih WebDAV in uporabnikom sistema omogoča, da se prijavijo s svojimi običajnimi poverilnicami.

V razdelku »AVHENTIKACIJA« poiščite te vrstice:

accept_basic: true accept_digest: true default_to_digest: true domain_controller: null

Zamenjajte jih z naslednjim:

accept_basic: true accept_digest: false default_to_digest: false domain_controller: wsgidav.dc.pam_dc.PAMDomainController

Zdaj lahko preizkusite svoj strežnik:

sudo wsgidav -c /usr/local/etc/wsgidav.yaml

Odprite https://dav.example.com:8080/v svojem spletnem brskalniku. Ker smo konfigurirali preverjanje pristnosti PAM, se boste morali prijaviti s svojim uporabniškim računom za Linux. Uporabite CTRL+, Cda zaustavite strežnik, preden nadaljujete.

Namestitev kot storitev

Če želite zagnati strežnik WebDAV kot sistemsko storitev, ki jo upravlja systemd, ustvarite datoteko enote:

sudo $EDITOR /etc/systemd/system/wsgidav.service

Vnesite naslednje:

[Unit] Description=WsgiDAV WebDAV server After=network.target [Service] Type=simple ExecStart=/usr/local/bin/wsgidav -c /usr/local/etc/wsgidav.yaml StandardOutput=syslog StandardError=syslog SyslogIdentifier=wsgidav_service [Install] WantedBy=multi-user.target

Nato ustvarite konfiguracijsko datoteko za storitev sistemskega beleženja:

sudo $EDITOR /etc/rsyslog.d/wsgidav_service.conf

Napolnite datoteko z naslednjim:

if $programname == 'wsgidav_service' then /var/log/wsgidav.log & stop

Shranite in zapustite, nato uporabite spodnje ukaze, da ustvarite datoteko dnevnika:

sudo touch /var/log/wsgidav.log sudo chown root:adm /var/log/wsgidav.log

Končno naložite novo datoteko sistemske enote in znova zaženite storitev beleženja, preden zaženete WsgiDAV:

sudo systemctl daemon-reload sudo systemctl restart rsyslog.service sudo systemctl start wsgidav.service

Zdaj lahko uporabite systemctlza zagon, zaustavitev in ponovni zagon strežnika WebDAV. Standardni izhod in napaka WsgiDAV bosta zabeležena v /var/log/wsgidav.log, do njih pa lahko dostopate tudi z uporabo sudo journalctl -u wsgidav.service.

Če želite, da se strežnik WebDAV samodejno zažene ob zagonu sistema, izvedite:

sudo systemctl enable wsgidav.service

nadaljnje branje

• Kako nastaviti strežnik WebDAV z uporabo Apache na CentOS 7
• Dokumentacija WsgiDAV