conf/srm.conf

Tartalmazza a leírásokat azokról a dokumentumokról amelyeket a server a clienseknek szolgáltat. Valamint azokat a server beállításokat amleyek a requestek kiszolgálását, a végeredmények formáját meghatározzák A file neve a ResourceConfig paranccsal definiálható át.

DocumentRoot

Az a directory ahoonnan a httpd szolgáltataja a file-okat.

UserDir public_html

A user-ek home directory-ja. Ezt fogják hozzáfûzni a ha egy ~user request érkezik.

Directory_index index.html

File vagy file-ok nevei amelyek elôre megírt HTML dokumentumokat tartalmaznak. Ha több ilyen van akkor space-szel kell ôket elválasztva felsorolni

FancyIndexing on

AddIconByEncoding icon mime-encoding mime-encoding..

AddiconByType icon mime-type mime-type..

AddIcon icon name name name ...

Ezek a direktívák állítják be, hogy milyen icon jelenjen meg egy file mellett. Az mindhárom esetben az icon vagy egy relativ URL az iconhoz, vagy (alttext,url). Az alttext egy betûszó a nem grafikus browserekhez.

Például :

• AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
• AddIconByType (TXT,/icons/text.gif) text/*
• AddIcon /icons/binary.gif .bin .exe

DefaultIcon /icons/unknown.gif

Azokhoz a file-okhoz amelyekhez nincs explicit icon definiálva.

AddDescription description file file

Egy rövidke lis megjegyzést fûzhetünk minden server által generált file-hoz, amelynek a neve egyezik a file-névvel, ami lehet egy kiterjesztés is.

ReadmeName filename

HeaderName filename

Az adott directoy-ban az index lista végére ill. elejére teszi be a filename.html-t, vagy ha ilyet nem talál akkor a filename-t keresi mint text file-t.

IndexIgnore file file

Az itt felsorolt file-ok nem lesznek megjelenítva ha kilistázunk egy directory-t. A file lehet egy név, egy részleges név , egy wildcard karakteres név. A lista defaultként tartalmazza a '.'

Például : IndexIgnore README .htaccess *~

AccessFileName .htaccess

Annak a file-nak a neve amelyet minden directory-ban az access control konfigurációt tartalmazza. Abban az esetben nem olvassa csak el ha :

<directory />

Alloverride None

</directory>

DefaultType

Azt adja meg, hogy ha egy file-nak nincs meghatározható tipusa a MIME mapping alapján akkor ezt veszi defaultnak. Például: van egy aldir. images/   és abban .gi file-ok , akkor DefalutType images/gif azt eredményezi , hogy ha egy file-nak ebben az aldir-ban nincs meg a .gif kiterjesztése akkor automatikusan annak veszi a server.

AddEncodig mime-enc extension extension

Azt eredményezi, hogy a felsorolt extensionnal rendelkezô file-ok a mime-encodingnak megfelelôen lesznek azonosítva. Mire jó ez? Arra, hogy egyes browserek menetközben tudnak kitömöríteni ez alapján.

Pl: AddEncoding x-compress Z, akkor uncompress fog használni minden .Z végû file-hoz.

AddLanguage mime-lang extension extension

pl: AddEncoding x-compress Z

AddLanguage en .en

AddLanguage fr .fr

Ekkor az xxx.en.Z dokument úgy lesz kezelva mint egy comressált English dokumentum.

LanguagePriority

Ez egy precedenciát ad meg hogy milyen sorrendben oldja fel a kötéseket.

ReDirect url-path url

Megmondja a client-nek , hogy próbálkozzon a dokumentum elérésével az új URL címen. Pl:Redirect /service http://foo2.bar.com/service

Akkor egy kérés ami a http://myserver/service/foo.txt akarja elérni a http://foo2.bar.com/service/foo.txt URL irányul át.

Alias url-path directory-filename

Lehetôvé teszi , hogy a local filesystemben is tartsunk dokumantumokat, ne csak a DocumentRoot alatt.

Pl: Alias /image /ftp/pub/image

Akkor egy kérés http://myserver/image/foo.gif a k;ovetkezô filet fogja szolgáltatni /ftp/pub/image/foo.gif.

ScriptAliases url-path directory-filename

Ugyanaz a viselkedése mint az Alias-nak csak ez scriptekre érvényes.

pl : ScriptAlias /cgi-bin/ /web/cgi-bin

Akkor http://myserver/cgi-bin/foo kérés /web/cgi-bin/foo scriptet fogja indítani.

AddType mime-type extension ...

Egy új mime tipus hozható így létre.

pl : AddType image/gif GIF

Így nem kell átdefiniálni a TypesConfig file-t.

AddHandler handler-name extension

Azt eredményezi, hogy az adott extension-nal rendelkezô file-okat a hendler-name handler fogja kezelni

pl : AddHandler cgi-script cgi

Akkor minden .cgi kiterjesztésû file CGI-scriptként lesz kezelve.

Action mime-type cgi-script

Ha egy kérés érkezik a mime-type tipusú file-ra, akkor a cgi-scriptet aktivizáljuk.

pl:AddHandler foot-action foot

Action foot-action /cgi-bin/footer

MetaDir

Metasuffix

A CERN HTTPD meta file szemantikát emulálja. A MetaDir azt a directory-t adja meg amelyben a meta információk file-jai vannak. Ez általában egy 'rejtett' subdirectory. A neve '.' -al kezdôdik.

A MetaSuffix azt a file név kiterjesztést adja meg amelyben a meta információk tárolódnak.

ErrorDocument Error-code document

Lehetôség van arra , hogy egy adott hiba esetén a mi általunk definiált hibaüzenet jelenjen meg.

Háromféle hibakezelés lehetséges ezzel a módszerrel:

1. plain text : Ekkor egy elôre meghatározott hibaüzenet jelenik meg.
   pl : ErrorDocument 500 "The server made a boo boo.
   Ebben a (") jel azt jelenti, hogy ez egy text.
2. local átirányítás :
   pl : ErrorDocument 404 /missing.html
   Ekkor a helyi /missing.html fog betöltôdni
3. külsô átirányítás :
   pl : ErrorDocument 402 http://other.server.com/subscription_info.html

conf/access.conf

A dokumentumok elérését szabályozó utasításokat tarttalmaz.Ez a file azokat a server beállításokat tartalmazza amelyek szabályozzák, hogy mely szolgáltatásokat milyen körülmények között érhetünk el. A file neve az AccessConfig utasítással értelmezhetô át. Itt lehet megadni, hogy mely directory-kat akarunk password-el védeni , melyeket teszünk nem hozzáférhetôvé.

<Directory dir-name> ...</Directory>

Arra szolgál , hogy egységbe zárja azokat a direktívákat amalyek az adott directory-ra ill. az összes aldirectorykra érvényesek. Elsôsorban az access.conf file-ban jelenhet meg, de persze a többi config file-ban is felhasználható. Nem lóghat át ill. nem jelenhet meg a <Limit> szekcióban.

<Limit method method> ... </Limit>

A felsorolt access method-okra a közbezárt elérési direktívák lesznek érvényesek.

Például :

<Limit GET POST>
require valid-user

</Limit>

<Location URL path> ... </Location>

Access control-t tesz lehetôvé az adott URL-nek. A URL path formátuma /directory/ legyen. A <DIrectory> section után kell következnie.

Példa :

<Location /status>

SetHandler server-status

order deny,allow

deny from all

allow from .foo.com

</Location>

Options options options

Szabályozza , hogy mely extra szolgáltatások érhetôek el az adott Directory-ban.

Példa :

<Directory [documentroot] >

Options Indexes FollowSymlinks

</Directory>

Azt eredményezi, hogy ha nincs index.html az [documentroot]-ban akkor ad egy directory listát és követi a szimbólikus linkeket az adott directory-ban.

AllowOverride override override

Ha a server talál egy .htaccess file-t az adott dir-ban akkor tudnia kell, hogy az ott felsorolt utasítások felülbírálhatják-e a már elôzôleg tett beállïtásokat. Ha az override None akkor a server nem olvassa el a .htaccess-t

Példa :

<Directory [Documentroot]>

Options Indexes FollowSymlinks

AllowOverride None

</Directory> .

allow from host host

CSak azok a host-ok érhetik el az adott direktory-t amelyek a fel vannak sorolva a host-ok között. Tipikusan a <Limit> szekcióban használandó.

A host lehet :

all

Ekkor minden host kap access-t

A (partial) domain-name

Az a host, vagy hostok kapnak access melyeknek a neve vagy a nevének a domain része egyezik.

A full IP address

Az adott IP address-szel rendelkezô host kap accesst.

A partial IP address

Az IP cím 1-tôl 3 byte-ig terjedô része, subnetting esetén.

allow from .ncsa.uiuc.com

Ekkor a hostok a fenti domain névvel mind kapnak access-t a directory-ra.

deny from host host ...

Azt sorolja fel , hogy mely hostok nem kaphatnak access jogot az adott directory-ra. Hasonlóan az elôzôhöz ez is a <Limit> szekcióban használandó.

A host az elôzôben leírt szerint értendô.

Pl: deny from 16

Akkor a specifikált network nem kaphat eccess jogokat.

order ordering

Ez határozza meg , hogy az allow és deny direktívák hogyan , milyen sorrendben értékelôdjenek ki.

Példa :

<Directory [Documentroot]>

Options Indexes FollowSymlinks

AllowOverride None

order allow, deny

</Directory>

Vagyis az allow direktíva a deny elôtt értékelôdik ki.

lehet még az ordering :

deny, allow

Elsônek a deny , majd utána az allow értékelôdik ki.

mutual-failure

Csak azok a hostok kapnak elérési jogot az adott direktory-ra amelyek szrepelnek az allow listában és nem szerepelnek a deny listában

require entity-name entity

Ez állítja be , hogy mely userek érhetnek el egy dir-t.

entity-name entity lehet:t:

user userid userid...

Csak a nevezett userek kaphatnak access jogokat

group group-name group-name..

Csak az adott csoportoknak lehet access joga

valid-user

Minden valid-user elérheti a dir-t.

Ha a <Limit> szekcióban jelenik meg akkor csak az adott method-ra érvényes, egyébként minden access methodra.

Egy példa ennek presentálására :

AuthType Basic

AuthName somedomain

AuthUserFile /web/users

AuthGroupFile /web/groups

Limit <GET POST>

require group admin

</Limit>

AuthName auth-domain

This directive sets the name of the authorization realm for a directory.

AuthType type

Ez adja meg , hogy a user azonosítás mely tipusát használjuk egy adott dir-ra. Jelenleg még csak a Basic mûködik.

mod_auth

Ez a modul szóveges file-okon alapuló user azonosítást tesz lehetôvé.

Defaultként fordítódik.

Direktívák:

AuthGroupFile filename

Ez a file fogja tartalmazni a user gropuokat amelyek kaphatnak access-t. Egy sora : mygroup: bob joe anne.

Nagy méretû file esetén nem szerencsés alkalmazni . Ekkor az AuthDBMGroupFile jobb hatásfokkal alkalmazható.

A filename abszolút path-al kell megadni.

AuthUserFile filename

Ez a file tattalmazza a userek neveit és a hoozzájuk tartozó password-t. Nagy file esetén az AuthDBMUserFile gyorsabb lesz.

Egy sor tartalmazza a user nevét majd kettôspont után a crypt()-tel titkosított password következik.

mod_auth_msql

Ez is default-ként fordítódik. Lehetôvé teszi , hogy public domain mSQL adatbázis file-okat használjunk user azonosításra.

Példa :

<directory /web/docs/private>

Auth_MSQLhost localhost vagy ehelyett

Auth_MSQLhost datab.machine.your.org

Auth_MSQLdatabase www

Auth_MSQLpwd_table user_records

Auth_MSQLuid_field User_id

Auth_MSQLpwd_field Cpasswd

Auth_MSQL_nopasswd off

Auth_MSQL_Authorative on

Auth_MSQL_EncryptedPasswords on

AuthName example mSQL realm

AuthType basic

</directory>

<Limit get post head>

order deny, allow

allow from all

require valid-user

require group has_paid

</limit>

mod_auth_dbm

A user azonosításra DBM file-okat használ. Nem fordítódik defaultként.

Néhány száz azonosítandó user, vagy csoport fölött a sima text file azonosítás nagyon hosszú idôt vesz igénybe. Ekkor ezt érdemes használni.

A DBM file-ok nem text állományok, 'es nem vihetôk 'at egyik platformról a másikra csak úgy.

A direktívák :

AuthDBMGroupFile filename

A filename file adja a user csoportok azonosítását. Egy sora egy user és utána felsorolva a csoprotok ahova tartozik.

AuthDBMUserFile filename

A userek azonosítására szolgáló file.

A kettô összekombinálható :

AuthDBMGroupFile /www/userbase

AuthDBMUserFile /www/userbase

Ekkor egyetlen DBM file fog azonosítani. A kulcs a username lesz , és a következô formátumban tartalmaz bejegyzéseket :

Unix Crypted Password : List of Groups [ : (ignored) ]

mod_auth_db

A user azonosïtásra Berkley DB file-okat használ. Ez is egy opcionális modul.

AuthDBGroupFile filename

AuthDBUserFilename filename

Anonymous access controll

A mod_auth_anon modulban található, és default-ként fordítódik.

Az anonymous ftp site-okhoz hasonló viselkedést tesz lehetôvé. Vagyis lesz egy 'magic' userid 'anonymous' és a hozzá tartozó password az e-mail cím.

Egy példán keresztül a mûködése :

Anonymous anonymous guest www test welcome

Anonymous_MustGiveEmail on

Anonymous_VerifyEmail on

Anonymous_NoUserId off

Anonymous_LogEmail on

AuthName Use 'anonymous' & Email address for guest entry

AuthType basic

conf/mime.types

Tartalmazza a default mime tipusokat. Ezt a file-t szerkeszteni nem igazán ajánlott, helyette inkább az AddType direktíva használandó új mime tipusok hozzáadására.

Azonban nem kell feltétlenül ragaaszkodni ezekhez a név konvenciókhoz.

Log file-ok

pid file

Error log

Transfer log

Cookie log

mod_cookies.c-ben található. Nem fordítódik defaultként.

CookieLog filename: adja meg a log file helyét.

Agent_log

mod_log_agent.c-ben található.

AgentLog logs/agent_log