# &kwuftpd; käsiraamat

## Sissejuhatus

&UNIX; operatsioonisüsteemid on vahest kõige paremini tuntud võimekate serveritena. Kasutajatel võib siiski olla üsna raske seadistada selliseid teenuste pakkumiseks vajalikke seadistustefaile. Samal ajal kipuvad paljud distributsioonid vastassuunas liiga kaugele minema, pakkudes kasutajatele süsteeme, mille seadistusvõimalused on ohtlikult avatud ja ebaturvalised.

&kwuftpd; on &kde; kasutajaliides wu-ftpd ftpaccess-failide redigeerimiseks. &kwuftpd; kirjutati esialgu rakendusele BeroFTPD 1.2.1 ning kohandati seejärel wu-ftpd versioonile 2.6.1, mis käis kaasas &RedHat; &Linux; 7.0-ga. Kui kasutad wu-ftpd uuemat ja võimalusterohkemat versiooni, tuleb sul kõigi võimaluste ärakasutamiseks uuendada &kwuftpd;-d (või redigeerida `ftpaccess`-faile käsitsi).

&kwuftpd; on ikka veel beetastaadiumis, st. mitte-päris-valmis, mistõttu võiksid enne seda, kui võtad &kwuftpd; kasutusele, teha oma ftpaccess-failidest varukoopia.

&kwuftpd; kirjutas Bernhard Rosenkraenzer bero@redhat.com ning selle autoriõigus (c) kuulub aastast 2000 firmale &RedHat; Inc.

### Lahtiütlus

Lisaks tavalisele lahtiütlusele (Me ei võta endale vastutust millegi halva eest, mis võib juhtuda), tuleks märkida, et &kwuftpd; võimaldab kontrollida kasutajate ühendusevõtmist süsteemiga ning nende õigusi faile lisada, kustutada ja muuta. Meeles tuleks pidada järgmisi asju:

- &kwuftpd; muudab hõlpsamaks turvalise serveri loomise -- kuid ei taga seda. Võrguturvalisuse kohta on olemas terve hulk raamatuid, veebilehekülgi ja kursusi ning administraatorid peaksid esmalt nendega vaeva nägema.

- Käesolevas käsiraamatus toodud näited on mõeldud piltlikustama &kwuftpd; tööd. Need ei ole turvanõuanded ja neid ei peaks kindlasti sellistena arvesse võtma.

- Kontrolli kindlasti, et old failist `/etc/ftpaccess` varukoopia teinud, enne kui hakkad seda &kwuftpd; abil redigeerima.

## &FTP; põhiseadistused

&kwuftpd; on mõttekas ainult töötava &FTP; serveriga süsteemis. Serveri loomine väljub käesoleva käsiraamatu raamest, kuid kõige olulisem on silmas pidada:

1. paigaldatud peab olema wu-ftpd või mõni sarnane &FTP; server. Anonüümse &FTP; rakendamiseks kulub ära ka näiteks pakett anonftp.

2. failis `/etc/inetd.conf` peab leiduma umbes järgmine rida:

       # ftp   stream  tcp nowait  root    /usr/sbin/tcpd  in.ftpd -l
       -a

   Eemalda rea eest kommentaaritähis #. Kui süsteemis on see juba eemaldatud, võta seda kui ohumärki ning kommenteeri kõik muud teenused, mida sa ei soovi kasutada. Käivita `/etc/inetd.conf` uuesti. (&RedHat; ja sarnaste süsteemide puhul käsureal ``/etc/rc.d/init.d/inet` `restart``.)

## &kwuftpd; kasutamine

### &kwuftpd; käivitamine

&kwuftpd; käivitamiseks vali &kde; menüüst Süsteem Muud rakendused KWuFTPd või anna käsureal korraldus ``kwuftpd``. Kasutada saab tavapäraseid &Qt; ja &kde; käsureaparameetreid, mida saab täpsemalt uurida käsuga ``kwuftpd` `--all``.

### &FTP; klassid

&kwuftpd; palub kasutajal sageli vahet teha kolme tüüpi kasutajatel:

Anonüümne

- Kõik, kes suudavad serveriga ühendust võtta, saavad end sisse logida kui kasutaja `ftp` või `anonymous` ning anda paroolina oma e-posti aadressi.

Külaline

- Kasutajad, kelle &FTP; konto on kirjas failis `/etc/ftpusers`, kuid kel puudub täiskonto süsteemis.

Tegelik

- Kasutajad süsteemse kontoga.

### Menüükäsud

#### Menüü Fail

Fail Lae /etc/ftpaccess

- Avab redigeerimiseks wu-ftpd standardse seadistustefaili `/etc/ftpaccess`.

Fail Lae muu fail...

- Avab redigeerimiseks mingi muu faili. Kasulik valik, kui soovid katsetada mõne muu faili peal, enne kui hakata muutma faili `/etc/ftpaccess`.

Fail Salvesta /etc/ftpaccess

- Salvestab muudadused faili `/etc/ftpaccess`.

Fail Salvesta muu fail...

- Salvestab muudatused määratud faili.

Fail Välju

- Sulgeb&kwuftpd;.

#### Menüü Abi

&help.menu.documentation;

### Kasutajate klassid

Kaart Kasutajate klassid Kaart Kasutajate klassid

Kaart Kasutajate klassid

See kaart võimaldab luua kasutajate klasse teatud IP aadressidele või aadressiblokkidele ning määrata nende klasside õigusi. Näiteks on siin võimalik anda anonüümsetele või külaliskasutajatele tavalisest suuremad õigused, kui nad logivad sisse teatud kindlast masinast.

Uue klassi loomiseks klõpsa nupul Lisa klass ning sisesta ilmuvas dialoogis uue klassi nimi, sellele kehtivad privileegid (nende kohta vt. lähemalt edaspidi) ja klassi IP aadress. Märki `*` saab kasutada aadressibloki määramiseks (Nt. `127.0.0.*` tähendab kõiki käesoleva arvuti kasutajaid). Kui see on tehtud, klõpsa kinnituseks nuppu OK.

Kaardil Kasutajate klassid saab ka valida klassi ning muuta selle kirjeldust ja omadusi. Muuta saab ka IP aadressi. Klassi saab kaasata antud aadressilt anonüümseid, külalis- ja/või tegelikke kasutajaid. Märkides ära kasti Automaatne grupp, saab määrata klassi kuuluvaks valitud gruppi koos sellele kuuluvate õigustega.

Kaardil saab määrata klassidele ka piiranguid üheaegse sisselogimise kohta teatud aegadel. Määrata saab ka sõnumi, mida näidatakse siis, kui kasutajate limiit on täis.

Pildil on aadressilt 127.0.0.* sisse logivad tegelikud kasutajad automaatselt määratud gruppi jsinger ning korraga on lubatud selles klassis sise logida vaid ühel kasutajal.

### Kataloogid

Kaart Kataloogid Kaart Kataloogid

Kaart Kataloogid

Sellel kaardil saab määrata juurkataloogi anonüümsetele ja külaliskasutajatele. (Tegelikud kasutajad näevad tegelikku failisüsteemi.) Siin saab määrata ka kasutatavad parooli- ja variparoolifailid. Kui ühtegi faili pole määratud, kasutatakse vaikimisi süsteemset faili.

Pildil näevad anonüümsed kasutajad juurfailisüsteemina asukohta `/home/ftp/pub`, külaliskasutajad aga vaikeväärtust. Süsteemsete failide asemel on kasutusel spetsiaalsed &FTP; paroolid.

### Turvalisus

Kaart Turvalisus Kaart Turvalisus

Kaart Turvalisus

See kaart võimaldab määrata mitmesuguseid turvalisusega seotud seadistusi. Osas Mittesaadetavad saab teatud faile või katalooge määrata mitte-allalaaditavaks. Klõpsa nupul Lisa... ja vali fail, mida soovid blokeerida. Vali kirje ning klõpsa nupul Eemalda, kui soovid faili nimekirjast kõrvaldada.

Lubatud ebaõnnestunud sisselogimiste arv põhjustab ühenduse katkestamise pärast määratud arvu ebaõnnestunud sisselogimiskatseid.

Märkides ära Luba SITE GROUP, antakse kasutajate õigus muuta gruppi, kuhu nad kuuluvad, käsuga ``SITE` `GROUP``.

Luba kasutada käske `chmod`, `delete`, `overwrite`, `rename` ja `umaks` võib laiendada või keelata anonüümsetele, külalis- ja/või tegelikele kasutajatele.

Anonüümsetelt kasutajatelt eeldatakse, et nad annavad paroolina oma e-posti aadressi. Siin saab määrata, kui tugevasti seda nõutakse.

Ei

- Antud parooli ei kontrollita.

Lihtne

- Parool peab sisaldama märki @.

RFC822

- Parool peab olema igati korrektne e-posti aadress.

Kui märgitud on Sunnitud, keeldutakse lubamast ühendust, kui sisselogimine ei läbi testi. Vastasel juhul näidatakse hoiatust.

Pildil on kataloogid `/bin` ja `/sbin` ning fail `/etc/passwd` allalaadimiseks blokeeritud. Ühendus katkestatakse pärast viit ebaõnnestunud sisselogimise katset, ``SITE` `GROUP`` on keelatud, anonüümsed kasutajad ei saa käske kasutada, küll aga külalis- ja tegelikud kasutajad. Anonüümsed kasutajad, kes annavad RFC-ga sobimatu e-posti aadressi, saavad hoiatuse.

### Teated

Kaart Teated Kaart Teated

Kaart Teated

Sellel kaardil saab määrata teateid, mida näidatakse sisse loginud kasutajale.

Vali ühenduse võtmisel (enne sisselogimist) näidatava tervitusteksti fail. Mõned erakordselt iidsed &FTP; kliendid võivad küll tervitustekstist segadusse sattuda.

Määrata saab masinanime. Seda näidatakse kasutajale sisselogimisel ning seda saab kasutada ka teistes teadetes (muutuja %L). Kui masinanime ei määrata, kasutatakse tegelikku masinanime.

Ka administraatori e-posti aadressi saab määrata nii, et seda kasutataks teisteski teadetes (muutuja %E).

Vastavate kastide märkimine võimaldab teateid ja faili `README` näidata kasutajale iga kord, kui tuleb ette vastav sündmus (vt lähemat selgitust allpool). Vastasel juhul näidatakse neid ainult üks kord.

Klõpsuga nupul Lisa sõnum... saab määrata teksti, mida kasutajale näidatakse. Teil palutakse määrata tekstifaili asukoht, see, kas seda näidatakse sisselogimisel või mingisse konkreetsesse kataloogi sisenemisel, samuti see, kas seda näidatakse kõigile kasutajate klassidele või ainult mõnele konkreetsele.

Samamoodi saab määrata kasutajale faili `README` näitamise, kui ta sisse logib või kataloogi vahetab.

Pildil näidatakse ühenduse võtmisel teksti `/home/ftp/welcome.txt`. Teadetes näidatakse masina nime `camelot` ja administraatori aadressi jsinger@leeta.net, kuid teated ega `README` ei ole veel kindlaks määratud.

### Logimine

Kaart Logimine Kaart Logimine

Kaart Logimine

See kaart võimaldab määrata, millised tegevused logitakse (faili `/var/log/xferlog`). Anonüümsete, külalis- ja tegelike kasutajate puhul võib logida erinevaid sündmusi, sealhulgas antud käske, üleslaadimisi, allalaadimisi, turvanõuete rikkumisi (nt. ebaõnnestunud sisselogimisi).

Märge kastis Logi suunatakse syslogi saadab logikirjed &FTP; logi asemel süsteemi logifaili.

Failide üleslaadimisel on võimalik määrata, et administraatorile saadetakse meilitsi sellekohane sõnum. Siin saab anda kirja välja `Kellelt:`, meiliserveri ja administraatori e-posti aadressi.

Pildil logitakse kõik käsud ja failiedastused, samuti tegelike kasutajate turvanõuete rikkumised. Üleslaadimisest antakse märku administraatorile aadressilt Üleslaadimisteade, meil ise saadetakse vaikemeiliserveri kaudu.

### Suhted

Kaart Suhted Kaart Suhted

Kaart Suhted

Sellel kaardil on võimalik piirata anonüümsete ja külaliskasutajate tegevusvabadust. Kõiki piiranguid saab rakendada kas anonüümsetele või külaliskasutajatele.

Üles/allalaadimiste suhe

- Määrates selleks näiteks 1:5, peab kasutaja iga allalaaditud 5 megabaidi kohta üles laadima 1 megabaidi. Siin optimaalse suhte leidmine muudab sind w4r3z-imelapseks.

Ajalimiit

- Lubab kasutajatel määratud aja kestel ühendust võtta.

Üleslaadimise limiit

- Määrab maksimaalse baitide hulga, mida seansi kestel võib üles laadida.

Allalaadimise limiit

- Määrab maksimaalse baitide hulga, mida seansi kestel võib alla laadida.

Faile ja katalooge on võimalik ka üles- ja allalaadimise limiidist vabastada.

Pildil ei ole suhteid sisse lülitatud, anonüümsetele kasutajatel lubatakse ühenduse kohta 15 minutit aega ja 10 megabaiti alla laadida.

### Üleslaadimised

Kaart Üleslaadimised Kaart Üleslaadimised

Kaart Üleslaadimised

See kaart võimaldab määrata, kuhu ja kuidas saavad kasutajad faile serverile laadida. Uute reeglite määramiseks klõpsa nuppu Lisa..., valitud reeglistiku muutmiseks Redigeeri... ning eemaldamiseks Eemalda.

Iga reeglistik kehtib konkreetselt määratud juurkataloogiga ning spetsiaalse üleslaadimiskataloogiga kasutajatele. Üleslaadimiskataloog võib olla globaalne ( nt. `/home/ftp/upload/*` sisaldab kogu kataloogi `/home/ftp/upload`).

Üleslaadimis saab lubada või keelata, samuti saab määrata loodud failide õigused ning nende omaniku ja grupi. Võib lubada või keelata õiguse luua olemasolevas kataloogis uusi alamkatalooge.

### Virtuaalserverid

Kaart Virtuaalserverid Kaart Virtuaalserverid

Kaart Virtuaalserverid

Iga aadressi puhul saab määrata järgmisi elemente:

Juurkataloog

- Sisse loginud kasutaja näeb seda failisüsteemi juurkataloogina (`/`).

Tervitustekst

- Fail, mille sisu näidatakse kasutajale ühenduse võtmisel. Faili asukoht on suhteline ülal määratud juurkataloogi suhtes.

Logifail

- Failiedastused logitakse määratud faili.

Paroolifail

- Siin saab määrata alternatiivse paroolifaili, vastasel korral kasutatakse süsteemset paroolifaili.

Variparoolifail

- Siin saab määrata alternatiivse variparoolide faili, vastasel korral kasutatakse süsteemset variparoolide faili.

Serveri nimi

- Serveri nimi, mida näidatakse sisselogimisel ning teadetes muutuja %L asemel.

Administraatori e-post

- E-posti aadress, mida näidatakse teadetes muutuja %E asemel.

Anonüümsete kasutajate sisselogimist saab lubada või keelata.

Tegelikel kasutajatel saab keelata või lubada juurdepääsu virtuaalserveri(te)le. Sama saab teha ka konkreetsete kasutajatega.

Pildil on virtuaalserveri `211.22.55.114` failisüsteemi juurkataloog tegeliku süsteemi kataloog `/home/ftp/virtual`. See kasutab omaette parooli- ja variparoolifaili kataloogist `/home/ftp`, näitab enda nimeks `ganesh`, administraatori e-posti aadressiks root ning võimaldab anonüümsete ja kõigi reaalsete kasutajate sisselogimist.

## Tänusõnad ja litsents

&kwuftpd;

Rakenduse kirjutas Bernhard Rosenkraenzer bero@redhat.com ja selle autoriõigust valdab aastast 2000 &RedHat;, Inc.

Dokumentatsiooni autoriõigus 2000: Jonathan Singer jsinger@leeta.net.

Tõlge eesti keelde Marek Laane bald@online.ee

&underFDL; &underGPL;

## Paigaldamine

&install.intro.documentation;

Kui soovid hankida &kwuftpd; eraldi, siis arvestam, et see on osa paketist kdeadmin ning selle peab kompileerima ja paigaldama nii, nagu on osutatud paketi põhikataloogis. Kdeadmini uusi versioone leiab aadressilt ftp://ftp.kde.org/pub.

&install.compile.documentation;

Vaja läheb ka ftpd-d, mis suudab käsitleda tekitatud ftpaccess-faile - &kwuftpd; kirjutati wu-ftpd 2.6.1 jaoks (ftp://ftp.wu-ftpd.org/pub/wu-ftpd/). Kasutada saab ka wu-ftpd 2.5.0 faile, kuid sel juhul ära loodagi, et kõik võimalused toimiksid.