www.dedoimedo.com apache web server cm

8/8/2019 Www.dedoimedo.com Apache Web Server Cm

1/147

P a r t I

A p a c h e W e b s e r v e r - C o m p l e t e

G u i d e

1


2/147

F o r e w o r d

S i n c e I c a n n o t b e s u r e y o u h a v e r e a d m y i n t r o d u c t o r y a r t i c l e o n m y w e b s i t e

( h t t p : / / w w w . d e d o i m e d o . c o m / ) , h e r e ' s a n a b s t r a c t o f w h a t y o u s h o u l d e x p e c t

f r o m t h i s d o c u m e n t .

T h e W e b s e r v e r - A p a c h e - C o m p l e t e G u i d e i s o n e o f t h e m a n y t o p i c s

c o v e r e d i n t h e s e r i e s o f b o o k s t h a t I ' m w r i t i n g o n L i n u x , t h e g o a l o f w h i c h i s

t o h e l p a n y e n t h u s i a s t i c W i n d o w s u s e r o r a L i n u x n e w b i e b e c o m e a p o w e r f u l ,

c o n d e n t L i n u x p r o f e s s i o n a l . A s a p r e v i e w o f w h a t y o u s h o u l d e x p e c t w h e n

t h e s e b o o k s b e c o m e p u b l i s h e d , I h a v e d e c i d e d t o p o s t a s i n g l e P a r t o n m y

w e b s i t e .

I a m t r u l y c o n v i n c e d t h a t y o u w i l l t h o r o u g h l y e n j o y t h i s d o c u m e n t , f o r i t

h a s b e e n w r i t t e n w i t h c a r e a n d a t t e n t i o n t o t i n i e s t d e t a i l s . E v e r y p r o c e d u r e i s

e x p l a i n e d s t e p b y s t e p , a c c o m p a n i e d b y n u m e r o u s e x a m p l e s a n d s c r e e n s h o t s .

I h o p e t h i s w i l l b e t h e b e s t g u i d e o n t h e A p a c h e W e b s e r v e r y o u w i l l h a v e

e v e r r e a d .

T h e o n l y t h i n g t h a t y o u w i l l m i s s i s t h e f a c t t h a t l i n k s t o o t h e r P a r t s , c o v -

e r i n g o t h e r m a t e r i a l , a r e n o t a v a i l a b l e i n t h i s s t a n d - a l o n e r e l e a s e . H o w e v e r ,

e v e r y p r o c e d u r e r e q u i r e d t o s e t u p t h e W e b s e r v e r i s f u l l y s e l f - c o n t a i n e d . Y o u

w i l l b e a b l e t o f u l l y c o n g u r e t h e A p a c h e s e r v e r b y j u s t u s i n g t h i s d o c u m e n t

a s y o u r g u i d e .

2
http://www.dedoimedo.com/


3/147

w w w . d e d o i m e d o . c o m a l l r i g h t s r e s e r v e d

L a s t l y , l e t ' s g e t o n e t h i n g s t r a i g h t : y o u w i l l n o t b e c o m e A p a c h e g u r u s

b y r e a d i n g t h i s d o c u m e n t . F o r t h a t m a t t e r , I ' m n o t a n A p a c h e g u r u , e i t h e r .

T h e r e a r e s o m a n y a s p e c t s t o t h e u s a b i l i t y a n d s e c u r i t y o f t h e A p a c h e W e b

s e r v e r , i t i s p r a c t i c a l l y i m p o s s i b l e t o p u t t h e m a l l i n a s i n g l e b o o k .

H o w e v e r , b y r e a d i n g t h i s d o c u m e n t , y o u W I L L l e a r n h o w t o u s e t h e

A p a c h e W e b s e r v e r o n t h e b a s i c a n d i n t e r m e d i a t e l e v e l . A n d t h e r e ' s n o g u i d e

t h a t w i l l e x p l a i n t h i n g s a s s i m p l y a n d a s b e a u t i f u l l y a s m i n e , I g u a r a n t e e t h a t .

F r o m h e r e o n , t h e s k y ' s y o u r l i m i t .

3


4/147

C o p y r i g h t

T h i s d o c u m e n t c a n b e u s e d u n d e r t h e f o l l o w i n g c o n d i t i o n s :

I f y o u w a n t t o m o d i f y o r e x t e n d a n y p a r t o f t h i s d o c u m e n t , p l e a s e c o n t a c t

m e b y e m a i l f o r p e r m i s s i o n . I n a n y c a s e , y o u m u s t p u b l i c l y c r e d i t m e f o r t h e

o r i g i n a l w o r k , i n c l u d i n g a l i n k t o m y w e b s i t e .

I f y o u w i s h t o m i r r o r e i t h e r t h e o r i g i n a l a r t i c l e o n m y w e b s i t e o r j u s t t h i s

d o c u m e n t , p l e a s e c o n t a c t m e b y e m a i l f o r p e r m i s s i o n . I f y o u w a n t t o h o t l i n k ,

p l e a s e d o s o w i t h a c o m p l i m e n t a r y e x p l a n a t i o n , n e c e s s a r y c r e d i t s a n d a l i n k

t o m y w e b s i t e .

I f y o u w a n t t o u s e t h i s d o c u m e n t f o r c o m m e r c i a l o r b u s i n e s s p u r p o s e s ,

p l e a s e c o n t a c t m e b y e m a i l w i t h t h e d e t a i l s o f y o u r e n d e a v o r s o w e c a n d i s c u s s

i t .

Y o u m a y n o t p u b l i s h a b o o k c o n t a i n i n g p a r t s o r a l l o f t h i s d o c u m e n t .

I f a n d w h e n m y b o o k s ( a n d t h i s P a r t ) g e t p u b l i s h e d , I r e t a i n t h e w h o l e

o f i n t e l l e c t u a l a n d n a n c i a l r i g h t s t o t h e m .

4


5/147

D i s c l a i m e r

I a m n o t v e r y f o n d o f d i s c l a i m e r s , b u t t h e y a r e a n e c e s s a r y p a r t o f o u r w o r l d .

S o h e r e w e g o :

I m u s t e m p h a s i z e t h e p u r p o s e o f t h i s d o c u m e n t i s f o r e d u c a t i o n a l p u r -

p o s e s . I t i s n o t a n o c i a l d o c u m e n t a n d s h o u l d n o t b e t r e a t e d a s s u c h .

F u r t h e r m o r e , I c a n n o t t a k e a n y r e s p o n s i b i l i t i e s f o r e r r o r s , i n a c c u r a c i e s o r

d a m a g e s r e s u l t i n g f r o m t h e u s e o f t h i s b o o k ( a n d i t s c o n t e n t s ) .

A l l o f t h e m a t e r i a l i n t h i s d o c u m e n t h a s b e e n c a r e f u l l y w o r d e d a n d p r e -

p a r e d b y m e . H o w e v e r , i f f o r s o m e r e a s o n y o u m a y f e e l t h i s d o c u m e n t i n -

f r i n g e s o n c o p y r i g h t o r i n t e l l e c t u a l p r o p e r t y o f a n o t h e r w o r k , p l e a s e c o n t a c t

m e w i t h a d e t a i l e d e x p l a n a t i o n p o i n t i n g t o a t r o u b l e s o m e p a r t a n d I w i l l t r y

t o s o r t t h e p r o b l e m i n t h e b e s t w a y p o s s i b l e .

5


6/147

I f y o u l i k e t h i s d o c u m e n t . . .

I f y o u l i k e t h i s d o c u m e n t , t h e n p l e a s e d o o n e o f t h e f o l l o w i n g :

A d v e r t i s e i t a s m u c h a s p o s s i b l e .

C o n s i d e r h i r i n g m e a s a w r i t e r , a t r a i n e r o r a n I T m a n a g e r .

C o n t a c t i n f o r m a t i o n :

F o r a l l i s s u e s r e g a r d i n g t h i s d o c u m e n t - c o m m e n t s , s u g g e s t i o n s , c o r r e c t i o n s ,

c o m p l a i n t s , a n d o t h e r s - p l e a s e c o n t a c t m e a t t h e b e l o w e m a i l a d d r e s s w i t h

S u b j e c t : A p a c h e W e b s e r v e r - C o m p l e t e G u i d e . U s e p l a i n t e x t o n l y w i t h o u t

i m a g e s o r a t t a c h m e n t s , o t h e r w i s e y o u r e m a i l w i l l b e d i s c a r d e d .

E m a i l a d d r e s s : w e b m a s t e r @ d e d o i m e d o . c o m

6


7/147

A b o u t t h e A u t h o r

I a m a p h y s i c i s t b y e d u c a t i o n a n d v o c a t i o n , w o r k i n g i n t h e m e d i c a l h i - t e c h

i n d u s t r y . M y w o r k e x p e r t i s e f o c u s e s o n p r o b l e m s o l v i n g a n d a l g o r i t h m d e v e l -

o p m e n t . T o t h i s e n d , I u s e M a t l a b e x t e n s i v e l y , m a i n l y f o r s i g n a l a n d i m a g e

p r o c e s s i n g . F u r t h e r m o r e , I ' m c e r t i e d i n s e v e r a l m a j o r e n g i n e e r i n g m e t h o d -

o l o g i e s , i n c l u d i n g M E D I C S i x S i g m a G r e e n B e l t , D e s i g n o f E x p e r i m e n t , a n d

S t a t i s t i c a l E n g i n e e r i n g .

I h a v e b e e n u s i n g L i n u x s i n c e 2 0 0 4 , h a v i n g t e s t e d a t l e a s t 3 0 - 4 0 d i s t r i b u -

t i o n s . M y f a v o r i t e d i s t r i b u t i o n s a r e U b u n t u a n d R e d H a t . I a m a l s o a c e r t i e d

L i n u x S y s t e m A d m i n i s t a t o r a n d I h o l d t h e i n t e r n a t i o n a l L P I C - 1 c e r t i c a t i o n .

C u r r e n t l y , I ' m p r e p a r i n g f o r t h e s e c o n d e x a m o f t h e L P I C - 2 c e r t i c a t i o n .

M y c r o s s - O S s k i l l s a r e i n t e r o p e r a b i l i t y b e t w e e n d i e r e n t s y s t e m s , w i t h

e m p h a s i s o n n e t w o r k - r e s o u r c e s t r a n s p a r e n c y , a u t o m a t i o n o f t a s k s , s c r i p t i n g ,

v i r t u a l i z a t i o n , a n d L A N s e c u r i t y .

I h a v e a l s o m a i n t a i n e d a w e b s i t e , m o s t l y d e d i c a t e d t o c o m p u t e r - r e l a t e d

t o p i c s s i n c e m i d - 2 0 0 6 ; t h e w e b s i t e i s o f t e n l i s t e d a n d r e f e r e n c e d t h r o u g h t h e

b o o k . O n m y s i t e , y o u w i l l n d a w e a l t h o f g u i d e s a n d t u t o r i a l s o n m a n y

s u b j e c t s , i n c l u d i n g m a n y p o p u l a r L i n u x d i s t r i b u t i o n s .

F o r m o r e d e t a i l s , p l e a s e v i s i t m y w e b s i t e : h t t p : / / w w w . d e d o i m e d o . c o m / .

7
http://www.dedoimedo.com/


8/147

C o n t e n t s

I A p a c h e W e b s e r v e r - C o m p l e t e G u i d e 1

1 I n t r o d u c t i o n 1 3

2 B a s i c S e t u p 1 5

2 . 1 V e r i f y i n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . 1 5

2 . 2 P a c k a g e l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5

2 . 3 M a i n c o n g u r a t i o n l e ( s ) . . . . . . . . . . . . . . . . . . . . . 1 7

2 . 4 B a c k u p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7

2 . 5 E d i t t h e h t t p d . c o n f c o n g u r a t i o n l e . . . . . . . . . . . . . . 1 7

2 . 5 . 1 S e r v e r R o o t . . . . . . . . . . . . . . . . . . . . . . . . 1 9

2 . 5 . 2 P i d F i l e . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9

2 . 5 . 3 S e r v e r N a m e . . . . . . . . . . . . . . . . . . . . . . . . 2 0

2 . 5 . 4 / e t c / h o s t s l e . . . . . . . . . . . . . . . . . . . . . . . 2 1

2 . 5 . 5 D o c u m e n t R o o t . . . . . . . . . . . . . . . . . . . . . . 2 4

2 . 5 . 6 E r r o r L o g . . . . . . . . . . . . . . . . . . . . . . . . . . 2 5

2 . 5 . 7 L i s t e n . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 6

2 . 6 C r e a t e y o u r H T M L d o c u m e n t s . . . . . . . . . . . . . . . . . . 2 7

2 . 7 S t a r t t h e W e b S e r v e r . . . . . . . . . . . . . . . . . . . . . . . 2 8

2 . 8 A c c e s s t h e w e b s i t e . . . . . . . . . . . . . . . . . . . . . . . . 3 1

2 . 8 . 1 L o c a l a c c e s s . . . . . . . . . . . . . . . . . . . . . . . . 3 1

2 . 8 . 2 E x t e r n a l a c c e s s . . . . . . . . . . . . . . . . . . . . . . 3 3

2 . 9 S u m m a r y o f b a s i c s e t u p . . . . . . . . . . . . . . . . . . . . . 3 6

8


9/147


3 A d v a n c e d s e t u p 3 8

3 . 1 D i r e c t o r y t a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 9

3 . 1 . 1 O r d e r ( a l l o w , d e n y ) . . . . . . . . . . . . . . . . . . . . 4 1

3 . 1 . 2 I n d e x e s . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4

3 . 1 . 3 D i r e c t o r y M a t c h . . . . . . . . . . . . . . . . . . . . . . 4 7

3 . 2 F i l e s t a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 7

3 . 3 L o c a t i o n t a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 9

3 . 4 D i r e c t o r y , F i l e s a n d L o c a t i o n . . . . . . . . . . . . . . . . . . 5 0

3 . 5 R e d i r e c t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1

3 . 6 V i r t u a l H o s t s . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3

3 . 6 . 1 S i n g l e I P , t w o w e b s i t e s . . . . . . . . . . . . . . . . . . 5 5

3 . 6 . 2 T w o I P s , t w o w e b s i t e s . . . . . . . . . . . . . . . . . . 6 0

3 . 6 . 3 O t h e r s c e n a r i o s . . . . . . . . . . . . . . . . . . . . . . 6 5

3 . 6 . 3 . 1 D i e r e n t c o n t e n t f o r i n t r a n e t a n d I n t e r n e t . . 6 6

3 . 6 . 3 . 2 D i e r e n t w e b s i t e s o n d i e r e n t p o r t s . . . . . . 6 8

3 . 7 M o d u l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 9

3 . 7 . 1 M o d u l e t y p e s . . . . . . . . . . . . . . . . . . . . . . . 7 0

3 . 8 V i e w i n s t a l l e d m o d u l e s . . . . . . . . . . . . . . . . . . . . . . 7 0

3 . 8 . 1 L o a d M o d u l e . . . . . . . . . . . . . . . . . . . . . . . . 7 2

3 . 8 . 2 m o d _ a c c e s s . . . . . . . . . . . . . . . . . . . . . . . . 7 4

3 . 8 . 3 m o d _ d i r . . . . . . . . . . . . . . . . . . . . . . . . . . 7 4

3 . 8 . 4 m o d _ p e r l . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

3 . 8 . 5 m o d _ p y t h o n . . . . . . . . . . . . . . . . . . . . . . . 7 5

3 . 8 . 6 m o d _ s s l . . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

4 . h t a c c e s s 7 6

4 . 1 C r e a t e . h t a c c e s s l e . . . . . . . . . . . . . . . . . . . . . . . . 7 9

4 . 2 C r e a t e . h t p a s s w d l e . . . . . . . . . . . . . . . . . . . . . . . 7 9

4 . 3 C o p y . h t a c c e s s t o r e s t r i c t e d d i r e c t o r y . . . . . . . . . . . . . . 8 1

4 . 4 C o n g u r e h t t p d . c o n f t o a l l o w a u t h e n t i c a t i o n v i a . h t a c c e s s . . . 8 1

4 . 5 R e s t a r t s e r v e r . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2

9


10/147


4 . 6 T e s t s e t u p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2

4 . 7 O t h e r c o n g u r a t i o n s . . . . . . . . . . . . . . . . . . . . . . . 8 6

4 . 7 . 1 I n h e r i t a n c e & p e r f o r m a n c e l o s s . . . . . . . . . . . . . 8 6

4 . 7 . 2 D i s a b l e w e b a c c e s s t o . h t a c c e s s . . . . . . . . . . . . . 8 7

5 S e c u r e W e b s e r v e r 8 9

5 . 1 E n c r y p t e d s e s s i o n . . . . . . . . . . . . . . . . . . . . . . . . . 9 0

5 . 2 R e q u i r e m e n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1

5 . 3 L i m i t a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2

5 . 4 S e t u p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3

5 . 4 . 1 M a i n c o n g u r a t i o n l e ( s ) . . . . . . . . . . . . . . . . . 9 3

5 . 4 . 2 B a c k u p . . . . . . . . . . . . . . . . . . . . . . . . . . 9 4

5 . 4 . 3 E d i t t h e s s l . c o n f c o n g u r a t i o n l e - p a r t 1 . . . . . . . 9 4

5 . 4 . 3 . 1 L o a d M o d u l e . . . . . . . . . . . . . . . . . . . 9 4

5 . 4 . 3 . 2 L i s t e n . . . . . . . . . . . . . . . . . . . . . . 9 5

5 . 4 . 3 . 3 V i r t u a l H o s t . . . . . . . . . . . . . . . . . . . 9 6

5 . 4 . 4 C r e a t e S S L c e r t i c a t e . . . . . . . . . . . . . . . . . . 9 7

5 . 4 . 4 . 1 C r e a t e C e r t i c a t e A u t h o r i t y ( C A ) . . . . . . 9 8

5 . 4 . 4 . 2 C r e a t e s e r v e r k e y . . . . . . . . . . . . . . . . 1 0 2

5 . 4 . 4 . 3 C r e a t e C e r t i c a t e S i g n i n g R e q u e s t ( C S R ) . . 1 0 3

5 . 4 . 4 . 4 S i g n C e r t i c a t e S i g n i n g R e q u e s t ( C S R ) w i t h

C e r t i c a t e A u t h o r i t y ( C A ) . . . . . . . . . . 1 0 5

5 . 4 . 4 . 5 V e r i f y c e r t i c a t e s . . . . . . . . . . . . . . . . 1 0 7

5 . 4 . 5 E d i t s s l . c o n f c o n g u r a t i o n l e - p a r t 2 . . . . . . . . . 1 1 0

5 . 4 . 5 . 1 S e r v e r C e r t i c a t e . . . . . . . . . . . . . . . . 1 1 0

5 . 4 . 5 . 2 S e r v e r P r i v a t e K e y . . . . . . . . . . . . . . . 1 1 1

5 . 4 . 5 . 3 C e r t i c a t e A u t h o r i t y . . . . . . . . . . . . . . 1 1 1

5 . 4 . 6 T e s t s e t u p . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 2

5 . 4 . 7 M i n i - s u m m a r y . . . . . . . . . . . . . . . . . . . . . . . 1 1 6

5 . 4 . 7 . 1 N a m e s . . . . . . . . . . . . . . . . . . . . . . 1 1 7

5 . 4 . 7 . 2 C o m m a n d s . . . . . . . . . . . . . . . . . . . 1 1 7

1 0


11/147


5 . 4 . 7 . 3 D i e r e n c e b e t w e e n s e l f - s i g n e d a n d C A - s i g n e d

c e r t i c a t e s . . . . . . . . . . . . . . . . . . . 1 1 8

5 . 4 . 7 . 4 V e r i c a t i o n . . . . . . . . . . . . . . . . . . . 1 1 9

5 . 4 . 7 . 5 F i l e n a m e s a n d l o c a t i o n s . . . . . . . . . . . . 1 1 9

5 . 5 E x t r a s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 9

5 . 5 . 1 D o n o t u s e p a s s w o r d - p r o t e c t e d s e r v e r k e y s . . . . . . . 1 1 9

5 . 5 . 1 . 1 C r e a t e s e r v e r k e y w i t h o u t p a s s w o r d . . . . . . 1 2 0

5 . 5 . 2 S u b m i s s i o n o f C S R t o C A . . . . . . . . . . . . . . . . 1 2 1

5 . 5 . 2 . 1 C r e a t e C S R . . . . . . . . . . . . . . . . . . . 1 2 1

5 . 5 . 2 . 2 S e n d C S R t o C A . . . . . . . . . . . . . . . . 1 2 2

5 . 5 . 2 . 3 V e r i f y c e r t i c a t e . . . . . . . . . . . . . . . . 1 2 2

5 . 6 G e n e r a l c o n s i d e r a t i o n s . . . . . . . . . . . . . . . . . . . . . . 1 2 3

5 . 6 . 1 U s e s e c u r e s e r v e r o n l y . . . . . . . . . . . . . . . . . . 1 2 3

5 . 6 . 2 U s e o n l y I P - b a s e d v i r t u a l h o s t s . . . . . . . . . . . . . 1 2 3

5 . 6 . 3 U s e s e r v e r . k e y a s l e n a m e f o r t h e s e r v e r k e y . . . . . . 1 2 3

6 O t h e r c o n g u r a t i o n s 1 2 4

6 . 1 F i r e w a l l r u l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 4

6 . 1 . 1 A d v a n c e d r e w a l l r u l e s . . . . . . . . . . . . . . . . . . 1 2 5

6 . 1 . 1 . 1 P o r t f o r w a r d i n g . . . . . . . . . . . . . . . . . 1 2 6

6 . 1 . 1 . 2 D e s t i n a t i o n N A T . . . . . . . . . . . . . . . . 1 2 7

6 . 1 . 1 . 3 S t a t i c N A T . . . . . . . . . . . . . . . . . . . 1 2 8

6 . 2 E n a b l e W e b s e r v e r o n s t a r t u p . . . . . . . . . . . . . . . . . . 1 2 9

7 S e c u r i t y 1 3 0

7 . 1 U p d a t e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 1

7 . 2 H i d e y o u r s e r v e r v e r s i o n . . . . . . . . . . . . . . . . . . . . . 1 3 1

7 . 3 L o g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 3

7 . 4 P e r m i s s i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 3

7 . 5 A c c e s s t o r o o t ( / ) . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 5

7 . 6 A l l o w O v e r r i d e . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 5

1 1


12/147


7 . 7 D i s a b l e p u b l i c a c c e s s t o . h t l e s . . . . . . . . . . . . . . . . . 1 3 6

7 . 8 D y n a m i c c o n t e n t . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 6

7 . 8 . 1 D i s a b l e C G I . . . . . . . . . . . . . . . . . . . . . . . . 1 3 6

7 . 8 . 2 D i s a b l e S e r v e r S i d e I n c l u d e s ( S S I ) . . . . . . . . . . . . 1 3 6

7 . 9 D i s a b l e u n n e c e s s a r y m o d u l e s . . . . . . . . . . . . . . . . . . . 1 3 7

7 . 1 0 U s e M o d S e c u r i t y ( m o d _ s e c u r i t y ) m o d u l e . . . . . . . . . . . . 1 3 7

7 . 1 1 C h r o o t J a i l . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 8

7 . 1 2 S e c u r e w e b s e r v e r o n l y . . . . . . . . . . . . . . . . . . . . . . 1 3 8

7 . 1 2 . 1 D i e r e n t D o c u m e n t R o o t . . . . . . . . . . . . . . . . . 1 3 8

7 . 1 2 . 2 P e r m i s s i o n s . . . . . . . . . . . . . . . . . . . . . . . . 1 3 9

7 . 1 2 . 3 D u r a t i o n o f c e r t i c a t e s . . . . . . . . . . . . . . . . . . 1 3 9

7 . 1 3 W o r d o f c a u t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 9

8 A d d i t i o n a l r e s o u r c e s 1 4 0

9 E x e r c i s e s 1 4 1

9 . 1 Q u e s t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 2

9 . 1 . 1 S e c u r e W e b s e r v e r & V i r t u a l H o s t . . . . . . . . . . . . 1 4 2

9 . 1 . 2 D i r e c t o r y , F i l e s a n d L o c a t i o n s . . . . . . . . . . . . . . 1 4 3

9 . 1 . 3 S e r v e r f u n c t i o n a l i t y , 1 . . . . . . . . . . . . . . . . . . 1 4 3


9 . 1 . 5 . h t a c c e s s . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 4

9 . 2 A n s w e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 5

9 . 2 . 1 S e c u r e W e b s e r v e r & V i r t u a l H o s t . . . . . . . . . . . . 1 4 5

9 . 2 . 2 D i r e c t o r y , F i l e s a n d L o c a t i o n s . . . . . . . . . . . . . . 1 4 5



9 . 2 . 5 . h t a c c e s s . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 7

1 2


13/147

C h a p t e r 1

I n t r o d u c t i o n

A W e b s e r v e r i s a s e r v e r t h a t i s r e s p o n s i b l e f o r a c c e p t i n g H T T P r e q u e s t s

f r o m w e b c l i e n t s a n d s e r v i n g t h e m H T T P r e s p o n s e s , u s u a l l y i n t h e f o r m o f

w e b p a g e s c o n t a i n i n g s t a t i c ( t e x t , i m a g e s e t c ) a n d d y n a m i c ( s c r i p t s ) c o n t e n t .

T h e A p a c h e W e b s e r v e r h a s b e e n t h e m o s t p o p u l a r a n d w i d e l y u s e d W e b

s e r v e r f o r t h e l a s t d e c a d e . I t i s u s e d b y a p p r o x i m a t e l y 5 0 % o f a l l w e b s i t e s .

A p a c h e i s c r o s s - p l a t f o r m , l i g h t w e i g h t , r o b u s t , a n d u s e d i n s m a l l c o m p a n i e s

a s w e l l a s l a r g e c o r p o r a t i o n s . A p a c h e i s a l s o f r e e a n d o p e n - s o u r c e .

T h e A p a c h e W e b s e r v e r h a s a l m o s t e n d l e s s p o s s i b i l i t i e s , d u e t o i t s g r e a t

m o d u l a r i t y , w h i c h a l l o w s i t t o b e i n t e g r a t e d w i t h n u m e r o u s o t h e r a p p l i c a -

t i o n s . O n e o f t h e m o s t p o p u l a r b u n d l e s i s t h e L A M P W e b s e r v e r a p p l i c a t i o n

s t a c k , w h i c h i n c l u d e s t h e A p a c h e W e b s e r v e r a l o n g s i d e M y S Q L , P H P , P e r l ,

a n d P y t h o n .

T h e A p a c h e W e b s e r v e r i s d e v e l o p e d b y t h e A p a c h e S o f t w a r e F o u n d a t i o n .

Y o u c a n r e a d m o r e a b o u t A p a c h e o n W i k i p e d i a .

B e i n g a b l e t o c o n g u r e a n d s e c u r e t h e A p a c h e W e b s e r v e r i s o n e o f t h e

m o s t i m p o r t a n t t a s k s f o r a ( L i n u x ) s y s t e m a d m i n i s t r a t o r . A l m o s t e v e r y

c o m p a n y h a s s o m e s o r t o f a w e b s i t e t h a t a d v e r t i s e s i t , i n c l u d i n g i n t r a n e t

p a g e s t h a t a r e u s e d b y t h e c o m p a n y ' s w o r k e r s . T h e W e b i n t e r f a c e i s u s e d f o r

m a n y t a s k s b e s i d e p u r e b r o w s i n g , i n c l u d i n g t a s k s a s s i m p l e a s m e a l o r d e r s

1 3
http://en.wikipedia.org/wiki/Apache_HTTP_Serverhttp://www.apache.org/


14/147


a n d s h i f t r o s t e r s , b u t a l s o i m p o r t a n t t a s k s l i k e a d m i n i s t r a t i o n o f d a t a b a s e s .

I n m o s t c a s e s , a l o c a l w e b s e r v e r i s s e t u p t o a c c o m m o d a t e t h e s e n e e d s .

I f y o u a r e w o r k i n g f o r a c o m p a n y t h a t h o s t s p u b l i c w e b s i t e s , t h e t a s k

b e c o m e s e v e n m o r e c o m p l i c a t e d . W e b s i t e s a r e u s e d t o s e r v e c o n t e n t t o

b i l l i o n s o f u s e r s d a i l y . W h o e v e r c o n t r o l s t h i s c o n t e n t - c o n t r o l s t h e W o r l d

W i d e W e b , f r o m n e w s a n d b l o g s t o n a n c i a l t r a n s a c t i o n s . W e b s e r v e r s a r e

h u b s o f i n f o r m a t i o n a n d p o w e r . M i s c o n g u r e d o r c o m p r o m i s e d s e r v e r s c a n

e x p o s e a l a r g e n u m b e r o f p e o p l e t o u n d e s i r e d c o n t e n t a n d p o t e n t i a l l y i n c u r

h u g e d a m a g e s t o i n v o l v e d p a r t i e s .

R u n n i n g a W e b s i t e i s m u c h m o r e t h a n o p e n i n g a p o r t a n d s e r v i n g a

f e w H T M L p a g e s . T h e r e a r e t r e m e n d o u s n e t w o r k u s a b i l i t y a n d s e c u r i t y

c o n s i d e r a t i o n s t h a t m u s t c o n t i n u o u s l y b e m e t , e v a l u a t e d a n d i m p r o v e d i n

o r d e r t o m a i n t a i n a s a f e a n d e e c t i v e W e b s e r v e r .

I n t h i s P a r t o f t h e B o o k , w e w i l l l e a r n h o w t o p r o p e r l y s e t u p a n d r u n t h e

A p a c h e W e b s e r v e r , i n c l u d i n g t h e s e c u r e ( H T T P S ) s e r v e r .

1 4


15/147

C h a p t e r 2

B a s i c S e t u p

I n t h i s c h a p t e r , w e w i l l s e t u p a W e b s e r v e r t h a t w i l l s e r v e p a g e s o n o u r

i n t e r n a l n e t w o r k . I n t h i s c h a p t e r , w e w i l l p e r f o r m t h e m o s t b a s i c s e t u p w i t h

t h e m i n i m u m n u m b e r o f s t e p s r e q u i r e d t o g e t t h e s e r v e r r u n n i n g . L a t e r , w e

w i l l s l o w l y e x p a n d , i n t r o d u c i n g n e w f e a t u r e s a n d o p t i o n s .

2 . 1 V e r i f y i n s t a l l a t i o n

F i r s t , w e ' l l v e r i f y t h a t A p a c h e i s i n d e e d i n s t a l l e d :

r p m - q h t t p d

I f y o u g e t a n e m p t y p r o m p t o r a m e s s a g e s a y i n g t h e p a c k a g e i s n o t i n -

s t a l l e d , y o u w i l l n e e d t o d o w n l o a d a n d i n s t a l l i t . I f t h e s h e l l d i s p l a y s t h e

p a c k a g e n a m e a n d v e r s i o n , y o u ' r e g o o d t o g o .

2 . 2 P a c k a g e l e s

R u l e n o . 1 : d o n ' t p a n i c ! T h e l i s t b e f o r e y o u m i g h t s e e m i n t i m i d a t i n g a t t h e

m o m e n t , b u t t h a t i s s i m p l y b e c a u s e y o u a r e n o t y e t f a m i l i a r w i t h A p a c h e .

1 5


16/147


B u t d o n ' t w o r r y . F o r n o w , t r e a t t h e l i s t a s a r e f e r e n c e o n l y . A t t h i s s t a g e , y o u

d o n ' t n e e d t o k n o w a n y t h i n g o r r e m e m b e r a n y t h i n g . W e w i l l s l o w l y c o v e r

e v e r y t h i n g , s t e p b y s t e p .

N o w , l e t u s o v e r v i e w t h e l o c a t i o n a n d p u r p o s e o f t h e l e s u s e d b y t h e

A p a c h e s e r v e r . P l e a s e n o t e t h a t t h e l i s t i s p a r t i a l a n d i n c l u d e s o n l y t h e m o s t

i m p o r t a n t e n t r i e s . W e w i l l s l o w l y e x p a n d t h i s l i s t a s w e g o t h r o u g h t h e P a r t .

F i l e n a m e D e s c r i p t i o n

/ u s r / s b i n / h t t p d s e r v e r b i n a r y

/ e t c / h t t p d d i r e c t o r y c o n t a i n i n g s e r v e r

c o n g u r a t i o n l e s

/ e t c / h t t p d / c o n f d i r e c t o r y c o n t a i n i n g m a i n

c o n g u r a t i o n l e s

/ e t c / h t t p d / c o n f . d d i r e c t o r y c o n t a i n i n g

c o n g u r a t i o n l e s f o r

i n d i v i d u a l l y p a c k a g e d

m o d u l e s , l i k e s s l , p h p , p e r l e t c

/ e t c / h t t p d / l o g s s y m b o l i c l i n k t o

/ v a r / l o g / h t t p d

/ e t c / h t t p d / m o d u l e s s y m b o l i c l i n k t o

/ u s r / l i b / h t t p d / m o d u l e s

/ e t c / h t t p d / r u n s y m b o l i c l i n k t o / v a r / r u n

/ u s r / l i b / h t t p d / m o d u l e s s e r v e r m o d u l e s

/ v a r / l o g / h t t p d s e r v e r l o g

/ v a r / r u n r u n t i m e v a r i a b l e s

/ v a r / r u n / h t t p d . p i d s e r v e r p r o c e s s I D

/ v a r / w w w / h t m l p u b l i c h t m l l e s

W e w i l l d i s c u s s t h e m a i n c o n g u r a t i o n l e s h o r t l y .

1 6


17/147


2 . 3 M a i n c o n g u r a t i o n l e ( s )

T h e m a i n c o n g u r a t i o n l e f o r t h e A p a c h e W e b s e r v e r i s :

/ e t c / h t t p d / c o n f / h t t p d . c o n f

T h i s l e i s w e l l c o m m e n t e d a n d s e l f e x p l a n a t o r y . I t c o n t a i n s q u i t e a l a r g e

n u m b e r o f s e t t i n g s , b u t w e ' l l c o n c e n t r a t e o n j u s t t h e f e w n e c e s s a r y t o s e t u p

t h e s e r v e r .

2 . 4 B a c k u p

T h i s i s o n e o f t h e m o s t i m p o r t a n t t h i n g s t o r e m e m b e r . A l w a y s r e t a i n t h e

c o p y o f t h e o r i g i n a l l e s o y o u c a n e a s i l y r e v e r t t o t h e d e f a u l t . A t t h e v e r y

l e a s t , d o N O T d e l e t e d e f a u l t l i n e s ; i n s t e a d , j u s t c o m m e n t t h e m o u t s o y o u ' l l

b e a b l e t o s e e w h a t t h e o r i g i n a l s e t t i n g s r e a d a n d r e f e r t o t h e m .

c p / e t c / h t t p d / c o n f / h t t p d . c o n f

/ e t c / h t t p d / c o n f / h t t p d . c o n f - d e f a u l t

2 . 5 E d i t t h e h t t p d . c o n f c o n g u r a t i o n l e

L e t ' s o p e n t h i s l e i n v i t e x t e d i t o r a n d r e v i e w t h e m o s t i m p o r t a n t e n t r i e s .

T h e l e h a s m a n y o p t i o n s - b u t w e n e e d o n l y a f e w . I n f a c t , y o u w i l l n e e d t o

c h a n g e j u s t a s i n g l e l i n e t o c r e a t e y o u r s e r v e r a n d g e t i t r u n n i n g . H o w e v e r ,

y o u s h o u l d b e f a m i l i a r w i t h s o m e o t h e r s e t t i n g s b e f o r e l a u n c h i n g t h e s e r v e r .

v i / e t c / h t t p d / c o n f / h t t p d . c o n f

T h i s i s w h a t t h e l e l o o k s l i k e - a t l e a s t t h e b e g i n n i n g o f i t :

1 7


18/147


L e t ' s g o o v e r t h e m o s t i m p o r t a n t e n t r i e s y o u s h o u l d r e m e m b e r f o r n o w .

1 8


19/147


2 . 5 . 1 S e r v e r R o o t

S e r v e r R o o t i s t h e p a t h t o t h e s e r v e r ' s c o n g u r a t i o n , e r r o r a n d l o g l e s .

I t i s p o s s i b l e t o c h a n g e t h i s p a t h , p r o v i d e d a l l t h e n e c e s s a r y l e s a r e c o p i e d

t o t h e n e w l o c a t i o n a c c o r d i n g l y . W e w i l l l a t e r r e v i e w t h i s c o n c e p t a s a p a r t

o f t h e s e c u r i t y m e a s u r e k n o w n a s t h e C h r o o t J a i l , b u t m o r e a b o u t t h a t l a t e r

( ) . T h e d e f a u l t l o c a t i o n i s / e t c / h t t p d .

A s y o u c a n s e e , t h e l e i s r i c h w i t h e a s y - t o - u n d e r s t a n d c o m m e n t s . A p r o -

p o s t h e c o m m e n t s , p l e a s e n o t e t h a t y o u s h o u l d n o t p l a c e a t r a i l i n g s l a s h a t

t h e e n d o f t h e s p e c i e d p a t h .

2 . 5 . 2 P i d F i l e

P i d F i l e i s t h e p r o c e s s i d e n t i c a t i o n n u m b e r f o r t h e h t t p d . T h i s p r o c e s s n u m -

b e r i s i m p o r t a n t , b e c a u s e A p a c h e s p a w n s n u m e r o u s c h i l d p r o c e s s e s w h e n

1 9


20/147


r u n n i n g t o a c c o m m o d a t e t h e w e b t r a c . I t a l l o w s y o u t o m o n i t o r a n d m a -

n i p u l a t e y o u r s e r v e r p r o c e s s e s . S e e i m a g e a b o v e .

2 . 5 . 3 S e r v e r N a m e

T h i s i s t h e o n e s e t t i n g y o u w i l l h a v e t o c h a n g e t o g e t y o u r s e r v e r r u n n i n g .

T h i s i s w h e r e y o u d e c l a r e t h e n a m e o f y o u r w e b s i t e .

I w i l l u s e w w w . n i n j a . c o m - j u s t a r a n d o m n a m e w i t h n o a s s o c i a t i o n w h a t -

s o e v e r t o t h e r e a l s i t e b e a r i n g t h i s n a m e .

T h e g e n e r o u s c o m m e n t s i n t h e l e r e m i n d u s t h a t i f w e d o n o t h a v e a

r e g i s t e r e d D N S n a m e , w e s h o u l d u s e a n I P a d d r e s s . O n e , w e ' l l d i s c u s s r e g i s -

t e r e d D N S n a m e s l a t e r . T w o , w e ' r e g o i n g t o u s e t h e h o s t s l e t o d e m o n s t r a t e

t h e a d d r e s s - t o - n a m e t r a n s l a t i o n .

2 0


21/147


2 . 5 . 4 / e t c / h o s t s l e

A s y o u a l r e a d y k n o w , t h e h o s t s l e a l l o w s e a s y m a t c h i n g o f n a m e s t o I P

a d d r e s s e s , . I n g e n e r a l , u s i n g t h e h o s t s l e i s a g o o d w a y o f t e s t i n g y o u r

I P - t o - n a m e ( o r v i c e v e r s a ) c o n g u r a t i o n s b e f o r e c o m m i t t i n g t h e s e c h a n g e s

i n t o a p r o d u c t i o n e n v i r o n m e n t .

F i r s t , w i t h n o n e w e n t r i e s a d d e d t o t h e h o s t s l e , t y p i n g w w w . n i n j a . c o m

i n t h e a d d r e s s b a r o f a w e b b r o w s e r t a k e s u s t o t h e s i t e i t s e l f ( o n t h e I n t e r n e t ) .

N o w , w e s h a l l e d i t t h e l e a n d a d d a n e n t r y , p o i n t i n g w w w . n i n j a . c o m t o

a l o c a l I P a d d r e s s .

v i / e t c / h o s t s

2 1


22/147


A f t e r s a v i n g t h e h o s t s l e , w e c a n n o l o n g e r s e e t h e I n t e r n e t s i t e . F u r -

t h e r m o r e , w e d o n ' t g e t a n y f a n c y r e s u l t s f r o m o u r o w n W e b s e r v e r , b e c a u s e

i t i s n o t r u n n i n g y e t .

2 2


23/147


2 3


24/147


2 . 5 . 5 D o c u m e n t R o o t

D o c u m e n t R o o t t e l l s y o u w h e r e y o u r w e b d o c u m e n t s ( h t m l l e s , i m a g e s

e t c ) s h o u l d b e l o c a t e d . I t i s p o s s i b l e t o r e f e r e n c e l e s i n o t h e r d i r e c t o r i e s

u s i n g a l i a s e s a n d s y m b o l i c l i n k s . T h e d e f a u l t d i r e c t o r y i s / v a r / w w w / h t m l .

2 4


25/147


2 . 5 . 6 E r r o r L o g

E r r o r L o g t e l l s y o u w h e r e t h e l o g c o n t a i n i n g a l l s e r v e r e r r o r s i s l o c a t e d .

T h i s l e i s c r i t i c a l f o r d e b u g g i n g a n d s o l v i n g s e r v e r m i s c o n g u r a t i o n p r o b l e m s

a n d f o r p r o p e r t r a c s h a p i n g . B y d e f a u l t , a l l m e s s a g e s w i t h t h e v a l u e o f

w a r n i n g ( w a r n ) a n d h i g h e r w i l l b e l o g g e d . T h i s i s d e s c r i b e d i n t h e L o g L e v e l

d i r e c t i v e j u s t b e l o w .

T h e d e f a u l t l o c a t i o n i s l o g s / e r r o r _ l o g . P l e a s e n o t e t h a t t h i s i s r e l a t i v e t o

t h e S e r v e r R o o t . T h e r e f o r e , o u r l o g l e i s / e t c / h t t p d / l o g s / e r r o r _ l o g . H o w e v e r ,

l e t u s n o t f o r g e t t h a t / e t c / h t t p d / l o g s i s a s y m b o l i c l i n k t o / v a r / l o g / h t t p d .

T h u s , n a l l y , t h e a c t u a l e r r o r l o g i s / v a r / l o g / h t t p d / e r r o r _ l o g .

2 5


26/147


2 . 5 . 7 L i s t e n

T h e L i s t e n c o m m a n d t e l l s t h e W e b s e r v e r w h a t p o r t s t o u s e f o r i n c o m i n g

c o n n e c t i o n s . B y d e f a u l t , p o r t 8 0 i s u s e d , a l t h o u g h a n y o n e o r s e v e r a l c a n b e

u s e d . T h e a c c e p t e d c o n v e n t i o n s c a l l s f o r u s i n g p o r t 8 0 f o r n o n - s e c u r e w e b

c o m m u n i c a t i o n s ( w i t h o u t a n y e n c r y p t i o n o f t r a c ) . S e c u r e w e b c o m m u n i -

c a t i o n s a r e n o r m a l l y h a n d l e d o n p o r t 4 4 3 . W e ' l l t a l k a b o u t t h e S e c u r e W e b

s e r v e r l a t e r .

T h a t ' s i t . T h e s e a r e a l l t h e s e t t i n g s y o u n e e d t o k n o w f o r n o w a n d t a m p e r

w i t h i n o r d e r t o s u c c e s s f u l l y l a u n c h t h e W e b s e r v e r . S a v e t h e c o n g u r a t i o n

l e ( E s c t h e n : x i n v i t e x t e d i t o r ) .

2 6


27/147


2 . 6 C r e a t e y o u r H T M L d o c u m e n t s

N o w , j u s t t o m a k e t h i n g s m o r e i n t e r e s t i n g , w e s h a l l c r e a t e a n u m b e r o f l e s

a n d p l a c e t h e m i n t h e D o c u m e n t R o o t d i r e c t o r y ( / v a r / w w w / h t m l ) , i n c l u d i n g

a s i m p l e i n d e x . h t m l l e .

H e r e ' s t h e s o u r c e o f o u r i n d e x . h t m l l e ( t h e t w o e c h o e s a r e u s e d t o m a k e

t h e o u t p u t e a s i e r t o r e a d ) :

A n d h e r e i s t h e p r e v i e w o f l e s w e h a v e i n t h e h t m l d i r e c t o r y :

2 7


28/147


N o w t h a t w e k n o w w h a t w e h a v e , i t ' s t i m e t o p o w e r u p t h e s e r v e r .

2 . 7 S t a r t t h e W e b S e r v e r

S t a r t t h e h t t p d s e r v i c e :

s e r v i c e h t t p d s t a r t

I f e v e r y t h i n g w o r k e d o u t n e , t h e w e b s e r v e r s h o u l d s t a r t w i t h o u t a n y

e r r o r s a n d y o u s h o u l d s e e t h e f o l l o w i n g i m a g e :

2 8


29/147


S t i l l , i t d o e s n o t h u r t t o c h e c k t h e s t a t u s o f t h e s e r v i c e o r v e r i f y i t s p r o c e s s

I D :

2 9


30/147


T h e r e a r e 9 p r o c e s s e s r u n n i n g f o r A p a c h e . T h i s m a y b e c o n f u s i n g , b u t

t h e r e ' s a v e r y s i m p l e e x p l a n a t i o n f o r t h i s . I n t h e h t t p d . c o n f l e , y o u w i l l

n d a d i r e c t i v e c a l l e d S t a r t S e r v e r s . T h i s d i r e c t i v e t e l l s t h e W e b s e r v e r h o w

m a n y s e r v e r p r o c e s s e s t o l a u n c h o n s t a r t u p . T h e d e f a u l t s e t t i n g i s 8 s e r v e r

p r o c e s s e s .

O n c e s t a r t e d , t h e W e b s e r v e r d y n a m i c a l l y k i l l s a n d c r e a t e s p r o c e s s e s

b a s e d o n t h e t r a c l o a d , w i t h t h e n u m b e r o f s e r v e r p r o c e s s e s u c t u a t i n g

b e t w e e n M i n S p a r e S e r v e r s a n d M a x S p a r e S e r v e r s . S o f a r , e v e r y t h i n g g u r e s

o u t j u s t n i c e l y . N o w , l e t ' s m a k e a n o t h e r c h e c k .

T h e A p a c h e W e b s e r v e r , i f c o n g u r e d t o l i s t e n o n p o r t 8 0 ( o r a n y s e c u r e

p o r t b e l o w 1 0 2 4 ) m u s t b e s t a r t e d a s r o o t . O t h e r w i s e , i t c a n a l s o b e s t a r t e d

b y r e g u l a r ( n o n - r o o t ) u s e r s . A s a s e c u r i t y p r e c a u t i o n , t h e s e r v e r p r o c e s s e s

s p a w n e d b y A p a c h e r u n a s u s e r a p a c h e , w h i c h b e l o n g s t o t h e g r o u p a p a c h e .

I n d e e d , w e c a n e a s i l y v e r i f y t h a t :

3 0


31/147


Y o u c a n c h a n g e t h e s e s e t t i n g s i n t h e h t t p d . c o n f l e , a s w e l l .

2 . 8 A c c e s s t h e w e b s i t e

2 . 8 . 1 L o c a l a c c e s s

N o w , l e t ' s a c c e s s o u r h o m e p a g e .

O p e n a w e b b r o w s e r a n d t y p e w w w . n i n j a . c o m i n t h e a d d r e s s b a r . E a r l i e r ,

w e w e r e u n a b l e t o a c c e s s i t , e v e n t h o u g h w e h a v e s p e c i e d t h e e n t r y f o r o u r

w e b s i t e i n t h e h o s t s l e . T h i s w a s b e c a u s e t h e s e r v e r w a s n o t r u n n i n g . B u t

n o w , w w w . n i n j a . c o m r e s o l v e s t o o u r c u s t o m w e b p a g e .

3 1


32/147


O u r s e r v e r w o r k s .

A l t e r n a t i v e l y , w e c o u l d h a v e s i m p l y a c c e s s e d i t b y t y p i n g l o c a l h o s t i n t h e

w e b b r o w s e r a d d r e s s b a r .

3 2


33/147


2 . 8 . 2 E x t e r n a l a c c e s s

A c c e s s i n g t h e w e b s e r v e r l o c a l l y i s n o t t h e m o s t c h a l l e n g i n g t h i n g t o d o . L e t ' s

a c c e s s i t f r o m o t h e r m a c h i n e s .

H e r e ' s o u r w e b p a g e , s e e n i n a n o t h e r C e n t O S m a c h i n e , b e l o n g i n g t o t h e

s a m e s u b n e t :

3 3


34/147


3 4


35/147


H e r e ' s o u r w e b p a g e , s e e n i n t h e O p e r a b r o w s e r r u n n i n g o n a W i n d o w s

m a c h i n e :

A s y o u m i g h t e x p e c t , u s i n g w w w . n i n j a . c o m o n t h e o t h e r m a c h i n e s d o e s

n o t y i e l d t h e d e s i r e d r e s u l t . T h i s i s b e c a u s e t h e r e i s n o t h i n g t e l l i n g t h e s e

m a c h i n e s t o m a t c h t h e n a m e t o t h e I P a d d r e s s o f o u r s e r v e r ( 1 9 2 . 1 6 8 . 1 . 1 2 8 ) .

O n t h e s e r v e r i t s e l f , w e o v e r c a m e t h e p r o b l e m u s i n g t h e h o s t s l e .

T h e o r e t i c a l l y , w e c o u l d d o t h e s a m e t h i n g o n e v e r y h o s t o n o u r n e t w o r k ,

b u t t h i s i s s l i g h t l y i m p r a c t i c a l a n d c u m b e r s o m e . H o w e v e r , t h i s w i l l n o t s o l v e

t h e p r o b l e m o f a c c e s s i b i l i t y f r o m h o s t s t h a t w e h a v e n o c o n t r o l o f , o u t s i d e

o u r l o c a l n e t w o r k . T o o v e r c o m e t h i s m o n u m e n t a l p r o b l e m , w e ' l l u s e n a m e

r e s o l u t i o n b y c o n g u r i n g a n d r u n n i n g a D o m a i n N a m e S y s t e m ( D N S ) s e r v e r .

T h i s m a t e r i a l i s c o v e r e d i n g r e a t d e t a i l i n t h e n e x t P a r t .

3 5


36/147


M e a n w h i l e , e v e r y t h i n g w o r k s a s w e ' v e e x p e c t e d . S o o n , w e w i l l g o o v e r

s o m e a d v a n c e d c o n g u r a t i o n s .

2 . 9 S u m m a r y o f b a s i c s e t u p

T o m a k e t h i n g s s i m p l e a n d c l e a r , h e r e ' s a n o v e r v i e w o f t h e s t e p s y o u w i l l

h a v e t o t a k e t o s e t u p a n d l a u n c h A p a c h e :

V e r i f y i n s t a l l a t i o n o f t h e A p a c h e R P M .

B a c k u p t h e / e t c / h t t p d / c o n f / h t t p d . c o n f m a i n c o n g u r a t i o n l e .

O p e n i t i n t h e v i t e x t e d i t o r a n d r e v i e w t h e o p t i o n s l i s t e d t h e r e i n .

S e t u p t h e D o c u m e n t R o o t d i r e c t i v e ( d e f a u l t / v a r / w w w / h t m l ) .

S e t u p t h e S e r v e r N a m e d i r e c t i v e ( f o r e x a m p l e , w w w . n i n j a . c o m ) .

3 6


37/147


O p t i o n a l l y s e t u p o t h e r d i r e c t i v e s ( l i k e S e r v e r R o o t , E r r o r L o g , L i s t e n

e t c ) .

C o n g u r e t h e / e t c / h o s t s l e s o t h a t y o u c a n a c c e s s t h e w e b s i t e b y

n a m e .

C r e a t e a s a m p l e H T M L l e a n d p l a c e i t i n t h e D o c u m e n t R o o t d i r e c t o r y .

S t a r t t h e h t t p d s e r v e r .

T e s t t h e s e t u p b y a c c e s s i n g t h e w e b s i t e .

3 7


38/147

C h a p t e r 3

A d v a n c e d s e t u p

T h e h t t p d . c o n f l e c a n b e e x t e n s i v e l y c u s t o m i z e d u s i n g a r a n g e o f d i r e c t i v e s .

W e h a v e s t u d i e d a f e w a n d w i l l n o w r e v i e w s e v e r a l m o r e . P l e a s e n o t e t h a t i t

i s i m p o s s i b l e t o l i s t e v e r y s i n g l e d i r e c t i v e h e r e . N e v e r t h e l e s s , w e w i l l g o o v e r

s o m e o f t h e m o r e u s e f u l a n d p r a c t i c a l d i r e c t i v e s , w h i c h w i l l g r e a t l y e n h a n c e

t h e u s a b i l i t y ( a n d a l s o t h e s e c u r i t y ) o f y o u r w e b s e r v e r .

3 8


39/147


3 . 1 D i r e c t o r y t a g s

D i r e c t o r y t a g s a l l o w y o u t o s p e c i f y t h e c o n g u r a t i o n s s e p a r a t e l y f o r e a c h

d i r e c t o r y s e r v i n g t h e w e b p a g e s . I f y o u a r e f a m i l i a r w i t h H T M L a n d C S S ,

t h e n u s i n g < d i v > c o n t a i n e r s m i g h t b e t h e s i m p l e s t a n a l o g y . T h i s a l l o w s y o u

t o s e r v e c o n t e n t t o s p e c i c I P r a n g e s w h i l e d e n y i n g o t h e r r a n g e s , l i m i t a c c e s s

t o c e r t a i n l e s , s e t t h e b e h a v i o r o f p a g e s c o n t a i n e d i n t h e s e d i r e c t o r i e s , a n d

m o r e .

J u s t a b o u t a n y d i r e c t o r y c a n b e l i s t e d , a l t h o u g h i t i s n o t n e c e s s a r y . T h e

m o s t s e n s i b l e s o l u t i o n i s t o s e t u p v e r y r e s t r i c t i v e p a r a m e t e r s t o t h e r o o t ( / )

d i r e c t o r y a n d c u s t o m , d e s i r e d p a r a m e t e r s t o d i r e c t o r i e s i n s i d e D o c u m e n t R o o t .

D i r e c t o r y t a g s t a k e t h e f o l l o w i n g f o r m ( a g a i n t h i s i s v e r y a n a l o g o u s t o

H T M L < d i v > t a g s ) :

3 9


40/147


< D i r e c t o r y d i r e c t o r y _ p a t h > t a g b e g i n s a b l o c k .

N e x t , f o l l o w s a s e r i e s o f o p t i o n s d e n i n g w h a t u s e r s a c c e s s i n g w e b p a g e s

l o c a t e d i n t h i s d i r e c t o r y c a n d o .

< / D i r e c t o r y > t a g c l o s e s t h e b l o c k .

H e r e ' s a s a m p l e b l o c k , s h o w i n g t h e d e f a u l t s e t t i n g s a p p l i e d t o t h e r o o t ( / )

d i r e c t o r y :

< D i r e c t o r y / >

O p t i o n s F o l l o w S y m L i n k s

A l l o w O v e r r i d e n o n e

< / D i r e c t o r y >

L e t ' s t r y t o u n d e r s t a n d w h a t w e h a v e h e r e :

< D i r e c t o r y / >

T h i s d e c l a r e s t h e b l o c k f o r t h e r o o t ( / ) d i r e c t o r y a n d a l l s u b - d i r e c t o r i e s .

O p t i o n s F o l l o w S y m L i n k s

T h e O p t i o n s d i r e c t i v e d e c l a r e s w h i c h s e r v e r f e a t u r e s a r e v a l i d f o r t h e

s p e c i e d d i r e c t o r y ; F o l l o w S y m L i n k s i s o n e o f t h e p o s s i b l e o p t i o n s - i t a l l o w s

w e b p a g e s t o u s e s y m b o l i c l i n k s t o p o i n t t o l e s l o c a t e d a n y w h e r e o n t h e r o o t

( / ) d i r e c t o r y . P l e a s e n o t e t h i s i s n o t t h e b e s t c o n g u r a t i o n f r o m t h e s e c u r i t y

p o i n t o f v i e w ; h o w e v e r , i t d o e s d e m o n s t r a t e t h e f u n c t i o n a l i t y o f t h e D i r e c t o r y

t a g s . W e w i l l d i s c u s s t h e s e r v e r s e c u r i t y m e a s u r e s l a t e r i n t h e P a r t .

A l l o w O v e r r i d e n o n e

T h e A l l o w O v e r r i d e d i r e c t i v e g o v e r n s t h e b e h a v i o r o f . h t a c c e s s l e s ( m o r e

a b o u t t h e m l a t e r ) . I t t e l l s w h e t h e r t h e r e s t r i c t i o n s i m p o s e d b y t h e O p t i o n s

c a n b e o v e r r i d d e n b y s p e c i c s e t t i n g s i n s i d e t h e . h t a c c e s s l e s . T h e d e f a u l t

4 0


41/147


b e h a v i o r i s s e t t o n o n e a n d s h o u l d r e m a i n t h a t w a y . T h i s w i l l p r e v e n t s e c u r i t y

b r e a c h e s o r n u i s a n c e s d u e t o m i s c o n g u r a t i o n .

< / D i r e c t o r y >

T h i s t a g c l o s e s t h e b l o c k .

3 . 1 . 1 O r d e r ( a l l o w , d e n y )

A l l o w a n d D e n y d i r e c t i v e s g o v e r n t h e a c c e s s t o t h e d i r e c t o r y d e c l a r e d ( v i a

t h e D i r e c t o r y t a g s ) . T h e O r d e r d i r e c t i v e s p e c i e s h o w t h e a l l o w a n d d e n y

d i r e c t i v e s a r e t r e a t e d . T h e O r d e r o f a l l o w , d e n y c a n b e l o o k e d u p o n a s

d e f a u l t - a l l o w o r b l a c k l i s t ; o n l y b a d h o s t s o r I P s a r e d i s a l l o w e d . T h e O r d e r

o f d e n y , a l l o w c a n b e l o o k e d u p o n a s d e f a u l t - d e n y o r w h i t e l i s t ; o n l y g o o d

h o s t s o r I P s a r e a l l o w e d .

P o s s i b l e d e c l a r a t i o n o f a l l o w e d o r d e n i e d c l i e n t s c a n b e v i a h o s t n a m e ,

d o m a i n n a m e , I P a d d r e s s , p a r t i a l I P a d d r e s s , a n d m o r e .

H e r e , w e ' l l r e s t r i c t a c c e s s t o t h e d i r e c t o r y ( o r r a t h e r , t h e s e r v e r ) b y d e n y -

i n g a c c e s s f r o m a l l - a n d o n l y p e r m i t t i n g a c c e s s f r o m a s i n g l e I P a d d r e s s ,

t h a t o f a n o t h e r m a c h i n e o n t h e L A N ( i n t h i s c a s e , 1 9 2 . 1 6 8 . 1 . 1 2 9 ) .

4 1


42/147


L e t ' s r e v i e w t h e c h a n g e s t o t h e h t t p d . c o n f l e :

I h a v e c o m m e n t e d o u t t h e o r i g i n a l p a r a m e t e r s , w h i c h a l l o w e d a c c e s s

f r o m a l l h o s t s ( o r I P s ) .

I h a v e c h a n g e d t h e o r d e r o f a l l o w , d e n y d i r e c t i v e s . A g a i n , t h i s i s i m -

p o r t a n t , b e c a u s e t h e o r d e r d e n e s t h e p r e c e d e n c e o f t h e r u l e s . T h u s ,

r s t , w e ' l l d e n y e v e r y o n e ( t h i s c a n b e c a l l e d d e f a u l t d e n y p o l i c y , s o t o

s p e a k ) a n d t h e n p e r m i t o n l y s p e c i c h o s t s ( o r I P s ) . I f t h e O r d e r w e r e

r e v e r s e d ( a l l o w , d e n y r a t h e r t h a n d e n y , a l l o w ) , n o o n e w o u l d b e a b l e

t o a c c e s s t h e s e r v e r . T h i s i s c r i t i c a l l y i m p o r t a n t t o r e m e m b e r w h e n

i m p l e m e n t i n g a l l o w , d e n y p o l i c i e s .

T h e c h a n g e s w i l l o n l y t a k e e e c t a f t e r t h e W e b s e r v e r i s r e s t a r t e d o r t h e

c o n g u r a t i o n l e r e l o a d e d . T h i s c a n b e a c h i e v e d b y r u n n i n g e i t h e r :

s e r v i c e h t t p d r e s t a r t

4 2


43/147


O r :

s e r v i c e h t t p d r e l o a d

A f t e r h t t p d r e a d s t h e n e w c o n g u r a t i o n l e , t h e c h a n g e s w i l l t a k e e e c t .

N o w , l e t ' s t r y t o a c c e s s t h e s e r v e r f r o m t h e W i n d o w s m a c h i n e .

A s y o u c a n s e e , w e a r e d e n i e d a c c e s s . B u t a c c e s s i n g f r o m t h e C e n t O S

c l i e n t w i t h t h e I P o f 1 9 2 . 1 6 8 . 1 . 1 2 9 w o r k s n e .

4 3


44/147


3 . 1 . 2 I n d e x e s

T h e I n d e x e s d i r e c t i v e t e l l s t h e s e r v e r w h e t h e r t o d i s p l a y t h e d i r e c t o r y l i s t i n g

w h e n a s k e d . T h e b e h a v i o r o f t h i s d i r e c t i v e d e p e n d s o n a n o t h e r d i r e c t i v e -

t h e D i r e c t o r y I n d e x . T h e D i r e c t o r y I n d e x d i r e c t i v e t e l l s t h e s e r v e r t h e n a m e

o f t h e d e f a u l t p a g e t h a t i t s h o u l d s e r v e w h e n a u s e r r e q u e s t s t h e l i s t i n g o f a

d i r e c t o r y .

T h i s i s t h e t y p i c a l e v e r y d a y s c e n a r i o . U s e r s a r e t r y i n g t o a c c e s s w e b -

p a g e s b y s i m p l y t y p i n g t h e i r n a m e s , w i t h o u t t y p i n g t h e e x a c t h o m e p a g e

( l i k e i n d e x . h t m l , i n d e x . p h p e t c ) . V a r i o u s l e n a m e s s p e c i e d u n d e r t h e D i -

r e c t o r y I n d e x a r e l o o k e d f o r a n d t h e r s t o n e f o u n d i s p r e s e n t e d t o t h e u s e r .

I f n o l e i s f o u n d , t h e l i s t i n g o f t h e d i r e c t o r y i s t h e n g e n e r a t e d b y t h e s e r v e r .

T h i s i s s o m e t h i n g y o u m a y w a n t t o a v o i d , e s p e c i a l l y i f t h e r e a r e l e s y o u

d o n o t w i s h y o u r u s e r s t o s e e . H o w e v e r , i f t h e O p t i o n s I n d e x e s d i r e c t i v e s a r e

4 4


45/147


u s e d , t h e n d i r e c t o r y l i s t i n g s w i l l b e g e n e r a t e d .

O n e s o l u t i o n i s t o p l a c e a d u m m y i n d e x . h t m l l e i n e v e r y d i r e c t o r y , b u t

t h i s i s c u m b e r s o m e . T h e m o r e e l e g a n t a p p r o a c h i s t o d i s a b l e t h e l i s t i n g

g l o b a l l y ( r e m o v e I n d e x e s f r o m t h e O p t i o n s d i r e c t i v e u n d e r D o c u m e n t R o o t )

a n d t h e n a l l o w p e r - d i r e c t o r y l i s t i n g w h e n y o u s e e t .

T h e d e f a u l t c o n g u r a t i o n i n t h e h t t p d . c o n f l e s p e c i e s O p t i o n s I n d e x e s

f o r t h e D i r e c t o r y t a g s o f t h e d e f a u l t D o c u m e n t R o o t ( / v a r / w w w / h t m l ) . W e

w i l l c h a n g e t h a t .

F i r s t , w e w i l l r e m o v e I n d e x e s f r o m t h e O p t i o n s l i n e f o r o u r D o c u m e n t R o o t .

T h e n , w e w i l l c r e a t e t w o d i r e c t o r i e s , c a l l e d i n d e x _ a l l o w a n d i n d e x _ d e n y ,

w h e r e o n l y t h e r s t w i l l h a v e t h e O p t i o n s I n d e x e s s p e c i e d . B o t h o f t h e s e

d i r e c t o r i e s w i l l c o n t a i n s o m e r a n d o m l e s .

4 5


46/147


T h i s i s t h e n e w c o n g u r a t i o n l e . S a v e i t , t h e n r e s t a r t h t t p d . N o w , i f

w e r e q u e s t t h e d i r e c t o r y l i s t i n g f o r e a c h o n e f r o m o u r c l i e n t s , w e ' l l g e t t h e

f o l l o w i n g r e s u l t s :

i n d e x _ a l l o w

4 6


47/147


i n d e x _ d e n y

3 . 1 . 3 D i r e c t o r y M a t c h

T h e d i r e c t i v e s e n c l o s e d i n t h e D i r e c t o r y t a g s w i l l b e i n d i s c r i m i n a t e l y a p p l i e d

t o a l l s u b - d i r e c t o r i e s . I f y o u r e q u i r e a m o r e n e - t u n e d a p p r o a c h f o r s e v e r a l

s i m i l a r s u b - d i r e c t o r i e s , y o u w i l l h a v e t o u s e t h e D i r e c t o r y M a t c h t a g s . T h e

m a i n d i e r e n c e i s t h a t t h e D i r e c t o r y M a t c h t a g s a l l o w t h e u s e o f r e g u l a r

e x p r e s s i o n s , a l l o w i n g y o u t o m a t c h s e v e r a l s u b - d i r e c t o r i e s i n s i d e a s i n g l e r u l e .

A g a i n , f o r t h o s e f a m i l i a r w i t h H T M L / C S S a n d t h e u s e o f c l a s s e s a n d

i d s , t h e i d e a i s v e r y m u c h s i m i l a r .

3 . 2 F i l e s t a g s

T h e F i l e s t a g s a r e v e r y s i m i l a r t o t h e D i r e c t o r y t a g s . T h e m a j o r d i e r e n c e i s

t h a t w h i l e t h e D i r e c t o r y t a g s g o v e r n t h e s c o p e o f p e r m i s s i o n s ( o r r e s t r i c t i o n s )

4 7


48/147


o f t h e e n c l o s e d d i r e c t i v e s b y d i r e c t o r y n a m e , t h e F i l e s t a g s d o t h e s a m e o n

t h e l e n a m e l e v e l . I n o t h e r w o r d s , t h e F i l e s t a g s c a n b e u s e d t o c o n g u r e

t h e b e h a v i o r o f a s i n g l e l e - o r a s e t o f l e s t h a t m a t c h a r e g u l a r e x p r e s s i o n .

H e r e ' s a n e x a m p l e , s h o w i n g t h e r e s t r i c t i o n s a p p l i e d t o . h t a c c e s s a n d . h t -

p a s s w d l e s , t h e l e s u s u a l l y u s e d i n r e s t r i c t i n g a c c e s s t o c e r t a i n d i r e c t o r i e s

( a n d / o r l e s ) b y r e q u i r i n g u s e r s t o a u t h e n t i c a t e b e f o r e v i e w i n g t h e c o n t e n t :

W e w i l l r e v i e w t h i s p a r t i c u l a r e x a m p l e l a t e r i n t h i s P a r t .

I n t h e a b o v e e x a m p l e , w e ' v e s e e n t h e u s e o f r e g u l a r e x p r e s s i o n s t o a l l o w

m u l t i p l e l e s t o b e c o v e r e d b y a s i n g l e r u l e . H o w e v e r , a c o m p a r a b l e d i r e c t i v e ,

m o r e s u i t a b l e f o r h a n d l i n g m u l t i p l e l e s a n d c o m p l e x r e g u l a r e x p r e s s i o n s i s

t h e F i l e s M a t c h d i r e c t i v e .

4 8


49/147


3 . 3 L o c a t i o n t a g s

A g a i n , t h e L o c a t i o n t a g s a r e q u i t e s i m i l a r t o t h e t w o m e n t i o n e d a b o v e . T h e

m a j o r d i e r e n c e i s t h a t t h e L o c a t i o n t a g s a r e u s e d t o l i m i t t h e s c o p e o f

e n c l o s e d d i r e c t i v e s b y U R L s .

I n o t h e r w o r d s , t h e D i r e c t o r y a n d F i l e s t a g s s h o u l d b e u s e d t o c o n t r o l

c o n t e n t t h a t r e s i d e s o n t h e s y s t e m ( l i k e v a r i o u s l e s a n d i m a g e s , w i t h i n t h e i r

s u b - d i r e c t o r i e s ) , w h i l e t h e L o c a t i o n t a g s s h o u l d b e u s e d t o c o n t r o l c o n t e n t

t h a t i s l o c a t e d o u t s i d e t h e s y s t e m , l i k e d a t a b a s e s , f o r i n s t a n c e .

B e l o w , w e c a n s e e a c o m m e n t e d e x a m p l e i n c l u d e d i n t h e h t t p d . c o n f l e .

I f e n a b l e d , t h i s b l o c k w o u l d a l l o w y o u t o a c c e s s y o u r s e r v e r s t a t i s t i c s , b u t

o n l y i f y o u c o n n e c t e d f r o m t h e s e r v e r i t s e l f .

4 9


50/147


H e r e ' s a n e x a m p l e ( p l e a s e d i s r e g a r d t h e a c t u a l U R L ) :

A g a i n , f o r c o m p l e x r e g u l a r e x p r e s s i o n s , y o u s h o u l d u s e t h e L o c a t i o n M a t c h

d i r e c t i v e .

3 . 4 D i r e c t o r y , F i l e s a n d L o c a t i o n

T h e D i r e c t o r y , F i l e s a n d L o c a t i o n t a g s a l l p e r f o r m a s i m i l a r f u n c t i o n : t h e y

c a t e g o r i z e w h a t r e s t r i c t i o n s a r e p l a c e d o n c o n t e n t e n c l o s e d b y e a c h o n e . A t

r s t g l a n c e , t h e r e s e e m s t o b e v e r y l i t t l e d i e r e n c e b e t w e e n t h e m . H o w e v e r ,

j u s t l i k e t h e o r d e r o f a l l o w a n d d e n y d i r e c t i v e s i s c r i t i c a l , s o i s t h e c o r r e c t

u s e o f t h e s e t a g s .

T h e c o n g u r a t i o n s e c t i o n s m u s t b e p l a c e d i n a v e r y p a r t i c u l a r o r d e r t o

m a k e s u r e t h e y b e h a v e a s i n t e n d e d . T h e o r d e r o f p r e c e d e n c e o f t h e i r e x e -

c u t i o n b y t h e s e r v e r m e a n s t h a t a m i s p l a c e d s e c t i o n c o u l d c o m p r o m i s e t h e

s e c u r i t y o f t h e s e r v e r - o r n o t g e t e x e c u t e d a t a l l .

5 0


51/147


F o r m o r e d e t a i l s , p l e a s e r e f e r t o t h e f o l l o w i n g A p a c h e d o c u m e n t a t i o n

p a g e : C o n g u r a t i o n S e c t i o n s - A p a c h e H T T P S e r v e r .

3 . 5 R e d i r e c t

T h e R e d i r e c t s e t t i n g a l l o w s y o u t o m a p a n o l d w e b p a g e t o a n e w U R L . T h i s

c o u l d b e t h e c a s e i f y o u c h a n g e d d o m a i n , f o r e x a m p l e , o r m o v e d a r o u n d a

l o t o f l e s , r e n a m i n g a n d d e l e t i n g t h e m . T o d e m o n s t r a t e t h e d i r e c t i v e , w e ' l l

m a p o u r s e r v e r t o p o i n t t o m y o w n s i t e .

5 1
http://httpd.apache.org/docs/2.0/sections.html


52/147


S a v e t h e l e , r e s t a r t t h e s e r v e r .

5 2


53/147


3 . 6 V i r t u a l H o s t s

V i r t u a l H o s t s i s a n i m p o r t a n t , p o w e r f u l f e a t u r e t h a t a l l o w s y o u t o r u n s e v e r a l

w e b s i t e s f r o m a s i n g l e c o m p u t e r . V i r t u a l H o s t s c a n b e I P - b a s e d o r n a m e d -

b a s e d , o e r i n g a h i g h l e v e l o f c u s t o m i z a t i o n ( a n d e x i b i l i t y ) .

V i r t u a l H o s t s c a n u s e a l m o s t a n y o p t i o n n o r m a l l y u s e d i n t h e h t t p d . c o n f

l e . T o m a k e y o u b e t t e r u n d e r s t a n d t h i s , y o u c a n t r e a t V i r t u a l H o s t s a s

i n d i v i d u a l c u s t o m i z e d h t t p d . c o n f l e s n e s t e d i n s i d e t h e m a i n h t t p d . c o n f l e .

5 3


54/147


L e t ' s r e v i e w a s a m p l e V i r t u a l H o s t :

< V i r t u a l H o s t * : 8 0 >

D o c u m e n t R o o t / v a r / w w w / h t m l / n i n j a - f a t h e r

S e r v e r N a m e w w w . n i n j a - f a t h e r . c o m

# o t h e r d i r e c t i v e s

< / V i r t u a l H o s t >

W h a t d o w e h a v e h e r e ?

< V i r t u a l H o s t * : 8 0 >

T h i s d e c l a r e s t h e n a m e o r t h e I P a d d r e s s o f t h e s i t e ( s e r v e r ) t h a t s h o u l d

b e s e r v e d u s i n g t h e d i r e c t i v e s i n s i d e t h e V i r t u a l H o s t b l o c k o n p o r t 8 0 . I f

n o p o r t n u m b e r i s u s e d , t h e d e f a u l t o n e s p e c i e d u n d e r t h e L i s t e n o p t i o n

i s u s e d . T h e d e f a u l t p o r t i s 8 0 ( s t a n d a r d c o n v e n t i o n ) . A s t e r i s k ( * ) c a n b e

r e p l a c e d w i t h a n y n a m e ( f o r e x a m p l e , w w w . n i n j a . c o m ) o r I P a d d r e s s ( f o r

e x a m p l e , 1 9 2 . 1 6 8 . 1 . 1 2 8 ) , d e p e n d i n g o n y o u r n e e d s a n d r e q u i r e m e n t s . L e t s e e

s e v e r a l s i m p l e e x a m p l e s :

< V i r t u a l H o s t 1 9 2 . 1 6 8 . 1 . 1 2 8 : 8 0 > w i l l a p p l y t h e d i r e c t i v e s l i s t e d i n t h e

b l o c k b e l o w t o a l l i n c o m i n g c o n n e c t i o n s a i m e d a t 1 9 2 . 1 6 8 . 1 . 1 2 8 o n p o r t

8 0 .

< V i r t u a l H o s t 1 9 2 . 1 6 8 . 1 . 1 2 8 > w i l l a p p l y t h e d i r e c t i v e s l i s t e d i n t h e

b l o c k b e l o w t o a l l i n c o m i n g c o n n e c t i o n s a i m e d a t 1 9 2 . 1 6 8 . 1 . 1 2 8 o n t h e

d e f a u l t p o r t ( a s s p e c i e d i n t h e L i s t e n d i r e c t i v e ) . I f t h i s p o r t i s 8 0 ,

t h e n t h i s o p t i o n i s i d e n t i c a l t o t h e o n e a b o v e .

< V i r t u a l H o s t p l a n c k . m a t t e r . c o m > w i l l a p p l y t h e d i r e c t i v e s l i s t e d i n t h e

b l o c k b e l o w t o a l l i n c o m i n g c o n n e c t i o n s a i m e d a t p l a n c k . m a t t e r . c o m o n

t h e d e f a u l t p o r t ( w h i c h c a n b e 8 0 , 8 0 8 0 o r a n y o t h e r ) .

5 4


55/147


< V i r t u a l H o s t n i n j a . c o m : 8 7 7 7 > w i l l a p p l y t h e d i r e c t i v e s l i s t e d i n t h e

b l o c k b e l o w t o a l l i n c o m i n g c o n n e c t i o n s a i m e d a t o u r s i t e n i n j a . c o m o n

p o r t 8 7 7 7 . T h i s p o r t m u s t b e s p e c i e d u n d e r t h e L i s t e n d i r e c t i v e .

D o c u m e n t R o o t / v a r / w w w / h t m l / n i n j a - f a t h e r

T h i s d e c l a r e s t h e d i r e c t o r y w h e r e y o u s h o u l d p l a c e a l l l e s t h a t y o u w i s h

s e r v e d w h e n t h e V i r t u a l H o s t i s i n v o k e d ( m a t c h i n g n a m e s o r I P s a n d t h e

p o r t ) .

S e r v e r N a m e w w w . n i n j a - f a t h e r . c o m

T h i s i s t h e n a m e o f t h e s e r v e r . I n o t h e r w o r d s , t h i s i s t h e a d d r e s s p e o p l e

w i l l t y p e i n t h e w e b b r o w s e r a d d r e s s n a m e i n o r d e r t o g e t t o y o u r s i t e . I n

o r d e r t o s u c c e s s f u l l y r e s o l v e t h i s n a m e t o t h e I P a d d r e s s o f t h e W e b S e r v e r ,

w e w i l l n e e d t o u s e / e t c / h o s t s l e l i k e b e f o r e o r s e t u p a D N S S e r v e r ( l a t e r ) .

# o t h e r d i r e c t i v e s

T h i s i s j u s t a c o m m e n t s p e c i f y i n g m a n y o t h e r o p t i o n s c a n b e u s e d , i n -

c l u d i n g t h o s e w e h a v e n o t y e t r e v i e w e d h e r e .

O K , n o w t h a t w e k n o w w h a t w e ' r e d e a l i n g w i t h , l e t ' s c r e a t e a n d t e s t

s e v e r a l s c e n a r i o s .

3 . 6 . 1 S i n g l e I P , t w o w e b s i t e s

T h i s i s o n e o f t h e m o s t c o m m o n s e t u p s . W e w i l l c r e a t e t w o w e b s i t e s -

w w w . n i n j a - f a t h e r . c o m a n d w w w . n i n j a - s o n . c o m . B o t h w i l l r e s i d e o n o u r s e r v e r ,

w h i c h h a s t h e I P a d d r e s s 1 9 2 . 1 6 8 . 1 . 1 2 8 . I n o r d e r t o m a k e t h e m b o t h a c c e s -

s i b l e t o t h e w o r l d , w e w i l l c r e a t e t w o V i r t u a l H o s t b l o c k s a n d d e c l a r e t h e i r

D o c u m e n t R o o t a n d S e r v e r N a m e s e p a r a t e l y .

H e r e ' s w h a t w e n e e d t o d o :

5 5


56/147


C r e a t e d i r e c t o r i e s i n s i d e / v a r / w w w / h t m l c a l l e d n i n j a - f a t h e r a n d n i n j a -

s o n .

C r e a t e s i m p l e i n d e x . h t m l l e s f o r e a c h .

E d i t h t t p d . c o n f a n d c r e a t e o u r t w o V i r t u a l H o s t b l o c k s .

H e r e ' s w h a t t h e h t t p d . c o n f l o o k s l i k e :

N o w , f o r t h e s a k e o f c o n v e n i e n c e , w e w i l l a l s o u s e t h e / e t c / h o s t s l e t o

a l l o w n a m e r e s o l u t i o n t o w o r k . I t i s a l s o i m p e r a t i v e i n o u r c a s e , b e c a u s e

u s i n g t h e I P a d d r e s s w o u l d a l w a y s p o i n t t o t h e r s t V i r t u a l H o s t l i s t e d i n t h e

h t t p d . c o n f l e .

5 6


57/147


P l e a s e n o t e t h a t s p e c i f y i n g a n I P a d d r e s s i n t w o d i e r e n t l i n e s i s w r o n g .

T h e h o s t s l e w i l l a l w a y s u s e o n l y t h e r s t e n t r y . Y o u s h o u l d l i s t a l l

n a m e s f o r a s p e c i c I P i n a s i n g l e l i n e .

F o r e x a m p l e , t h i s i s i n c o r r e c t ( a l t h o u g h i t w o u l d w o r k i n o u r c a s e ) :

5 7


58/147


D o n ' t m i n d t h e c o m m e n t e d l i n e s , t h e y a r e u s e d f o r o t h e r c o n g u r a t i o n s :

t h e r s t , o u r s t a n d a r d w e b s i t e ; t h e s e c o n d , f o r y e t a n o t h e r V i r t u a l H o s t s c e -

n a r i o , w h i c h w e w i l l d i s c u s s s o o n .

N o w , w e s h a l l s a v e t h e l e s ( b o t h h t t p d . c o n f a n d / e t c / h o s t s ) a n d r e s t a r t

h t t p d . T h e n , u s i n g F i r e f o x , w e w i l l t r y t o a c c e s s e a c h o n e .

5 8


59/147


w w w . n i n j a - f a t h e r . c o m

5 9


60/147


w w w . n i n j a - s o n . c o m

I t w o r k s l i k e m a g i c . B e s t o f a l l , t h e u s e r h a s n o i d e a t h a t t h e s e t w o s i t e s

r e s i d e o n t h e s a m e m a c h i n e .

3 . 6 . 2 T w o I P s , t w o w e b s i t e s

T h i s i s a n o t h e r c o m m o n s c e n a r i o . Y o u c a n a s s i g n a d i e r e n t I P t o e a c h w e b -

s i t e , a v o i d p o s s i b l e r e s o l u t i o n m i x u p s a n d s i m p l i f y i n g y o u r s e t u p . H o w e v e r ,

t h i s r e q u i r e s t h a t y o u e i t h e r u s e m o r e t h a n a s i n g l e n e t w o r k a d a p t e r o r c r e a t e

v i r t u a l a d a p t e r s . I f y o u h a v e , l e t ' s s a y 1 4 w e b s i t e s , h a v i n g 1 4 p h y s i c a l n e t -

w o r k d e v i c e s p l u g g e d i n t o y o u r m a c h i n e s i s n o t t h e b e s t i d e a . U s i n g v i r t u a l

a d a p t e r s i s t h e m o s t s e n s i b l e c h o i c e h e r e .

W e a l r e a d y h a v e o u r t w o w e b s i t e s r e a d y . W e j u s t n e e d t o c r e a t e a v i r t u a l

n e t w o r k c a r d a n d t h e n c h a n g e t h e h t t p d . c o n f l e t o r e e c t t h e c h a n g e s .

F i r s t , w e w i l l c r e a t e a v i r t u a l a d a p t e r ( e t h 0 : 1 ) w i t h t h e I P a d d r e s s o f

1 9 2 . 1 6 8 . 1 . 2 0 0 .

6 0


61/147


6 1


62/147


T h e n , w e ' l l e d i t t h e h t t p d . c o n f l e .

6 2


63/147


L a s t l y , w e ' l l e d i t t h e / e t c / h o s t s l e .

A f t e r r e s t a r t i n g t h e s e r v e r , w e ' l l b e a b l e t o g e t t o o u r t w o s i t e s e a s i l y .

A g a i n , t h e c h a n g e i s c o m p l e t e l y t r a n s p a r e n t t o t h e u s e r .

w w w . n i n j a - f a t h e r . c o m

6 3


64/147


6 4


65/147


w w w . n i n j a - s o n . c o m

E x c e l l e n t .

P l e a s e n o t e t h a t t h e c o n g u r a t i o n o f t h e v i r t u a l n e t w o r k a d a p t e r i s t e m -

p o r a r y . Y o u w i l l h a v e t o c r e a t e a n e t w o r k s c r i p t t o p r e s e r v e t h e c h a n g e

b e t w e e n r e b o o t s . T h i s s e t u p h a s c o v e r e d e x t e n s i v e l y i n P a r t ? : N e t w o r k i n g

- s u b - p a r t 2 : B a s i c a n d i n t e r m e d i a t e c o n g u r a t i o n s ( ) .

3 . 6 . 3 O t h e r s c e n a r i o s

B a s i c a l l y , t h e a b o v e t w o s c e n a r i o s c o v e r p r e t t y m u c h e v e r y t h i n g . O n c e y o u

g e t t h e h a n g o f V i r t u a l H o s t s e t t i n g , c r e a t i n g a n y w h i c h s e t u p b e c o m e s a

s i m p l e m a t t e r . N e v e r t h e l e s s , f o r t h e s a k e o f c l a r i t y , I w i l l d e m o n s t r a t e s e v e r a l

m o r e t y p i c a l s c e n a r i o s i n t h e e x a m p l e s b e l o w , i n c l u d i n g s o m e f e a t u r e s n o t

m e n t i o n e d y e t i n t h i s P a r t o f t h e B o o k .

6 5


66/147


3 . 6 . 3 . 1 D i e r e n t c o n t e n t f o r i n t r a n e t a n d I n t e r n e t

I n p r a c t i c e , t h i s s c e n a r i o i s v e r y s i m i l a r t o h a v i n g 2 d i e r e n t I P s s e r v i n g t w o

d i e r e n t w e b s i t e s , e x c e p t t h a t y o u w i l l u s e o n e w e b s i t e b u t s e r v e d i e r e n t

p a r t s o f i t t o d i e r e n t c u s t o m e r s .

L e t ' s a s s u m e y o u w i s h t o a c h i e v e t h e f o l l o w i n g :

A l l o w u s e r s o n t h e l o c a l n e t w o r k a c c e s s t o a l l c o n t e n t , b u t d e n y s o m e

t o u s e r s o n t h e I n t e r n e t .

A l l o w u s e r s o n t h e l o c a l n e t w o r k t o l i s t d i r e c t o r y i n d e x , b u t d e n y t h i s

f e a t u r e t o t h e I n t e r n e t u s e r s .

D i s p l a y a d i e r e n t h o m e p a g e t o l o c a l u s e r s a n d e x t e r n a l c u s t o m e r s .

A l l o w c e r t a i n c u s t o m s c r i p t s t o b e a v a i l a b l e o n l y t o e x t e r n a l c u s t o m e r s .

H e r e ' s w h a t a s a m p l e c o n g u r a t i o n i n h t t p d . c o n f l e w o u l d l o o k l i k e :

A d d H a n d l e r c g i - s c r i p t . c g i

N a m e V i r t u a l H o s t 1 7 2 . 1 6 . 1 . 1 : 8 0

< V i r t u a l H o s t 1 7 2 . 1 6 . 1 . 1 : 8 0 >

D o c u m e n t R o o t / w w w / i n t r a n e t

S e r v e r N a m e w w w . o u r - c o m p a n y . c o m

< D i r e c t o r y / w w w / i n t r a n e t >

O p t i o n I n d e x e s F o l l o w S y m L i n k s

< / D i r e c t o r y >


N a m e V i r t u a l H o s t 2 1 1 . 2 1 1 . 2 1 1 . 2 1 1 : 8 0

< V i r t u a l H o s t 2 1 1 . 2 1 1 . 2 1 1 . 2 1 1 : 8 0 >

D o c u m e n t R o o t / w w w / w e b

6 6


67/147


S e r v e r N a m e w w w . o u r - c o m p a n y . c o m

< D i r e c t o r y / w w w / w e b >

O p t i o n s + E x e c C G I F o l l o w S y m L i n k s

< / D i r e c t o r y >


T h i s e x a m p l e s i n t r o d u c e s a n u m b e r o f c o n c e p t s w e h a v e n o t y e t s e e n , s o

l e t ' s b r i e y r e v i e w t h e m :

N a m e V i r t u a l H o s t

T h i s d i r e c t o r y a l l o w s y o u t o m a p n a m e d - b a s e d i n c o m i n g c o n n e c t i o n s t o

s p e c i c I P a d d r e s s e s . Y o u m i g h t a s k y o u r s e l v e s w h y y o u n e e d t h i s , w h e n

w e h a v e s e e n p e r f e c t l y g o o d e x a m p l e s b e f o r e , w i t h o u t t h i s f e a t u r e . W e l l ,

t h e a n s w e r i s : i f s o m e h o w a n a m e d - b a s e d r e q u e s t g e t s l o s t ( d u e t o D N S

c o n g u r a t i o n , r e w a l l r u l e s o r s i m i l a r ) , i t m i g h t n o t m a t c h a n y o f t h e V i r -

t u a l H o s t b l o c k s . I n t h a t c a s e , t h e d e f a u l t s e t t i n g s c o n g u r e d i n h t t p d . c o n f

w i l l b e a p p l i e d t o t h i s r e q u e s t , w h i c h c o u l d b e c o n t r a r y t o y o u r n e e d s . U s i n g

N a m e V i r t u a l H o s t f o r c e s a l l i n c o m i n g c o n n e c t i o n s t o a c e r t a i n I P a d d r e s s t o

p o i n t t o a c e r t a i n V i r t u a l H o s t b l o c k . T h i s r e q u e s t w i l l a l s o n e v e r f a l l b a c k t o

t h e m a i n c o n g u r a t i o n , a l l o w i n g y o u a c o m p l e t e m o d u l a r i t y i n y o u r s e t u p .

T h u s , i n o u r e x a m p l e , a l l r e q u e s t s t o t h e i n t e r n a l I P a d d r e s s w i l l g o t h e

V i r t u a l H o s t w i t h t h i s I P a d d r e s s d e c l a r e d . W e c a n a l s o s e e t h a t t h e u s e r s

w i l l b e a b l e t o v i e w d i r e c t o r y l i s t i n g s a n d f o l l o w s y m b o l i c l i n k s .

+ E x e c C G I

W e s e e t h i s d i r e c t i v e l i s t e d u n d e r O p t i o n s i n t h e s e c o n d b l o c k , w h i c h

r e f e r s t o t h e I n t e r n e t c u s t o m e r s . A l l i n c o m i n g c o n n e c t i o n s o n t h e e x t e r n a l

I P w i l l g o t o t h e V i r t u a l H o s t w i t h t h i s I P d e c l a r e d . W e c a n s e e t h e u s e r s

w o n ' t b e a b l e t o d e m a n d d i r e c t o r y l i s t i n g s , b u t t h e y w i l l b e a b l e t o f o l l o w

s y m b o l i c l i n k s - a n d e x e c u t e . c g i s c r i p t s l o c a t e d i n t h i s d i r e c t o r y .

6 7


68/147


T h e E x e c C G I d i r e c t i v e t e l l s t h e s e r v e r t o a l l o w s e r v e r - s i d e s c r i p t i n g i n t h e

s p e c i e d d i r e c t o r y . T h e p l u s ( + ) s i g n s s i g n i e s t h i s O p t i o n i s u s e d i n a d d i t i o n

t o a l l t h o s e O p t i o n s a l r e a d y s p e c i e d f o r t h e r o o t d i r e c t o r y . S i m i l a r l y , t h e

m i n u s ( - ) s i g n c a n r e m o v e s o m e o f t h e p r i v i l e g e s , c o m p a r e d t o t h e O p t i o n s

a l r e a d y s p e c i e d f o r t h e r o o t d i r e c t o r y .

H o w e v e r , a l o n e , t h i s d i r e c t i v e i s i n s u c i e n t t o a l l o w s c r i p t i n g i n t h i s

d i r e c t o r y .

A d d H a n d l e r c g i - s c r i p t . c g i

I n o r d e r t o e n a b l e . c g i s c r i p t s t o w o r k o u t s i d e t h e d e f a u l t s c r i p t d i r e c t o r y ,

a d i r e c t i v e m u s t b e a d d e d t o t h e h t t p d . c o n f c o n g u r a t i o n l e . I n d e e d , t h i s i s

t h e r s t l i n e o f o u r s a m p l e c o d e - A d d H a n d l e r c g i - s c r i p t . c g i - i t a l l o w s s c r i p t s

i n n o n - d e f a u l t d i r e c t o r i e s t o b e e x e c u t e d , b y u s i n g t h e + E x e c C G I o p t i o n , a s

w e ' v e d o n e b e f o r e .

T h e A p a c h e W e b s e r v e r h a s m a n y o t h e r o p t i o n s a n d f e a t u r e s . Y o u a r e

w e l c o m e t o t r y t h e m a l l , u s i n g t h i s P a r t o f t h e B o o k a s t h e f o u n d a t i o n f o r

e x p a n d i n g y o u r k n o w l e d g e . F o r m o r e i n f o r m a t i o n , p l e a s e r e f e r t o :

A p a c h e H T T P S e r v e r V e r s i o n 2 . o D o c u m e n t a t i o n

R e d H a t E n t e r p r i s e L i n u x 4 : R e f e r e n c e G u i d e , C h a p t e r 1 0 : A p a c h e

H T T P S e r v e r

3 . 6 . 3 . 2 D i e r e n t w e b s i t e s o n d i e r e n t p o r t s

W e ' v e a l r e a d y d i s c u s s e d t h i s b e f o r e . L e t ' s s a y y o u h a v e a s i n g l e I P a d d r e s s

w i t h m u l t i p l e w e b s i t e s s e r v e d . U s i n g t h e h o s t s l e o r D N S r e s o l u t i o n i s a

p o s s i b i l i t y , b u t t h i s m i g h t n o t a l w a y s w o r k . C o n g u r i n g t h e W e b s e r v e r t o

l i s t e n o n s e v e r a l p o r t s f o r i n c o m i n g c o n n e c t i o n s a n d t h e n u s i n g N a m e V i r -

t u a l H o s t f e a t u r e t o f o r c e t h e c o n n e c t i o n s t o s p e c i c V i r t u a

www.dedoimedo.com apache web server cm

Documents