아파치 WebDAV와 LDAP HOWTO

1.1. Copyright and License

이 문서의 저작권은 Saqib Ali에게 있다. 복사하거나, GNU Free Documentation License 하에서 수정하고 배포할 수 있다. 1.1 버전과 그 이후의 버전들은 자유 소프트웨어 재단에 의해 불변적인 섹션이나 표지 같은 것 없이 출판될 것이다. 이 라이센스는 http://www.gnu.org/copyleft/fdl.html에서 얻을 수 있다.

2.1. 먼저 요구되는 것들

LDAP와 함께 WebDAV를 컴파일하기 위해 LDAP 라이브러리 파일들을 먼저 설치해야 한다. LDAP 라이브러리 파일들은 아파치에서 사용되는 LDAP 모듈을 컴파일하는 데 필요하다. LDAP 라이브러리를 얻는 가장 좋은 방법은 http://www.openldap.org OpenLDAP에서 소스 코드를 다운로드 받아 컴파일하여 포함된 라이브러리를 사용하는 것이다. 당신은 다른 IPlenet과 비슷한 다른 어떤 LDAP를 사용해도 좋지만, 나는 오픈 소스 솔루션인 OpenLDAP를 추천하는 바이다.

2.2. 아파치 선 구성하기

mod_dav는 가 설정된 아파치가 필요합니다. 그래서 설치 위치를 알고 있습니다. 소스파일이 있는 곳으로 디렉토리를 옮깁니다:

  # cd /tmp/download 
  # gzip -d apache_1.x.x.tar.gz 
  # tar -xvf apache_1.x.x.tar 
  # cd apache_1.x.x 
  # ./configure --prefix=/usr/local/apache  

2.3. mod_dav의 구성과 설치

위에 설명한 대로 mod_dav는 아파치 설치시에 정적으로 연결될 것입니다. 임시 다운로드 디렉토리로 이동하여 시작합니다:

# cd /tmp/download

gzip과 tar를 이용하여 파일의 압축을 해제합니다.:

# gzip -d mod_dav-1.x.x.tar.gz

# tar -xvf mod_dav-1.x.x.tar

압축을 해제하는 동안 만들어진 새로운 디렉토리로 이동한다:

# cd mod_dav-1.x.x

이제 아파치와 정적으로 링크하기 위해 mod_dav패키지를 구성한다:

# ./configure --with-apache= /tmp/download/apache_1.x.x

파일의 컴파일과 설치:

# make

# make install

mod_dav는 부분적으로 컴파일 되었고 make install단계에서 아파치 소스트리에 적절한 위치에 들어가 있다.

2.4. mod_auth_ldap의 설치와 설정

임시 다운로드 디렉토리로 돌아갑니다:

# cd /tmp/download

mod_auth_ldap 파일의 압축을 해제합니다:

# gzip -d mod _auth_ldap.tar.gz

# tar -xvf mod_auth_ldap.tar

이제 아파치 소스트리로 modauthldap파일들을 설치한다:

cd apache_x.x.x

mv ../modauthldap ./src/modules/ldap

2.5. 아파치의 설정과 설치

마지막으로 목적지에 도달했다. 그러나 아직 시작일뿐이다........

이제 WebDAV와 DAV를 위한 LDAP인증을 포함한 아파치를 컴파일하고 설치할 준비가 되었다.

임시 다운로드 디렉토리로 돌아간다:

# cd /tmp/download

아파치 디렉토리로 이동한다:

# cd apache-x.x.x

그리고 mod_dav와 mod_auth_ldap와 함께 컴파일하기 위해 아파치를 구성한다:

  # ./configure --prefix=/usr/local/apache \
     --activate-module=src/modules/ldap/mod_auth_ldap.c \
     --activate-module=src/modules/dav/libdav.a 
     [...you can add more options here...] 

아파치를 컴파일하고 이를 적절한 위치에 설치한다:

# make

# make install

3.1. /usr/local/apache/conf/httpd.conf의 변경

다음 아파치 지시문이 /usr/local/apache/conf/httpd.conf안에 있는지 검사하라:

  Addmodule mod_dav.c

존재하지 않으면 추가하면 된다. 이 지시문은 아파치에게 DAV 특성을 알려준다. 이 지시문은 모든 컨테이너의 밖에 있어야 한다.

다음단계로 아파치가 DAVLockDB 파일을 저장할 장소를 선택해야 한다. DAVLockDB는 WebDAV를 위한 lock 데이터베이스이다. 이 디렉토리는 아파치 프로세스가 쓸 수 있는 곳이어야 합니다.

/usr/local/apache/var아래에 DAVLock파일을 저장할 것이다. 이 디렉토리를 또한 다른 목적으로도 사용할 것이다. /usr/local/apache/var아래에 DAVLockDB를 저장하도록 지정하기 위해 당신의 /usr/local/apache/conf/httpd.conf에 다음의 라인을 추가하라.:

  DAVLockDB      /usr/local/apache/var/DAVLock 

이 지시문 또한 모든 컨테이너 밖에 위치해야 한다.

3.2. DAVLockDB를 위한 디렉토리 생성하기

위에서 설명한대로 DAVLockDB를 위해서 생성될 디렉토리는 아파치 프로세스가 쓸 수 있어야한다.. 일반적으로 웹서버 프로세스는 사용자 'nobody' 로 동작한다. 'ps -ef | grep httpd' 명령을 이용하여 시스템에서 이를 확인하라 다음의 명령들을 이용하여 /usr/local/apache아래에 디렉토리를 만들고 권한을 설정하라:

  # cd /usr/local/apache
  # mkdir var
  # chmod -R 755 var/
  # chown -R nobody var/
  # chgrp -R nobody var/

3.3. DAV를 가능하게 하기

DAV를 가능하게 하는 것은 쉬운 일이다. 아파치 루트밑에 디렉토리를 위해 DAV를 가능하게 하는 것은 특별한 디렉토리를 위한 컨테이너에 다음의 지시문을 추가하면 된다:

  DAV On

이 지시문은 디렉토리와 그 서브 디렉토리에서 DAV를 가능하게 할 것이다.

아래는 /usr/local/apache/htdocs/DAVtest에 WebDAV와 LDAP인증을 가능하게 하는 샘플 구성이다. /usr/local/apache/conf/httpd.conf파일안에 이를 추가하라.

  <Directory /usr/local/apache/htdocs/DAVtest>
  Dav On
  #Options Indexes FollowSymLinks

  AllowOverride None
  order allow,deny
  allow from all
  AuthName "username_and_passwd_required"
  AuthType Basic
  <Limit PUT POST DELETE PROPFIND PROPPATCH MKCOL COPY MOVE LOCK UNLOCK>
  Require valid-user
  </Limit>
  LDAP_Server your.ldap.server.com
  LDAP_Port 007
  Base_DN "o=ROOT"

  UID_Attr uid
  </Directory>

3.4. DAVtest라 불리는 디렉토리 생성하기

이전 절에서 설명한것처럼 모든 DAV디렉토리는 웹서버 프로세스가 쓰기 가능해야 한다. 이 예제에서 우리는 웹서버가 사용자 'nobody' 로 동작한다고 가정한다. 이는 일반적인 경우이다. httpd가 어느 사용자로 동작중인지를 확인하기 위해 'ps -ef | grep httpd'를 사용하면 된다.

'DAVtest'라 불리는 시험용 디렉토리를 /usr/local/apache/htdocs 아래에 만들기:

# mkdir /usr/local/apache/htdocs/DAVtest

디렉토리의 권한을 httpd 프로세스가 읽고 쓸 수 있도록 조정하라. httpd가 사용자 'nobody' 로 동작중이라고 가정하면 아래의 명령들을 수행하라:

  # cd /usr/local/apache/htdocs
  # chmod -R 755 DAVtest/
  # chown -R nobody DAVtest/
  # chgrp -R nobody DAVtest/

3.5. 아파치를 재시작하기

마지막으로 httpd.conf에 있는 구문들을 검사하기 위해 아파치에 포함되어있는 구성시험루틴을 수행하여야 한다.

# /usr/local/apache/bin/apachectl configtest

만약 이 단계에서 오류를 받았다면 위에 설명한 단계를 올바로 수행하였는지를 검사하라. 오류 메시지를 분석할 수 없다면 주저하지 말고 오류메세지를 포함하여 나에게 보내라 (saqib@seagate.com).

구성시험이 성공적이라면 아파치 웹서버를 시작하라:

# /usr/local/apache/bin/apachectl restart

이제 우리는 LDAP인증을 포함한 WebDAV가 가능한 아파치 서버를 얻었다.

어떠한 질문이나 제안,추천, 칭찬, 의견, 불평이 있다면 그것들을 나(saqib@seagate.com)에게 email로 보내라

Note: 아파치나 모듈을 설치하는 데에서 발생하는 문제점이나 기존의 아파치 서버를 WebDAV를 지원하도록 업그레이드 하려고 한다면 나와 상담을 하라.

WebDAV 지원및 토론 포럼