diff options
| author | Andr챕 Malo <nd@apache.org> | 2004-04-26 00:24:50 +0200 |
|---|---|---|
| committer | Andr챕 Malo <nd@apache.org> | 2004-04-26 00:24:50 +0200 |
| commit | d2244aadacf701a0a2a3c3ae99f80760fbc6a0bb (patch) | |
| tree | 4d1cb1fc5bf482806b6290a7996ebf29b7f23057 /docs/manual/mod | |
| parent | update transformation (diff) | |
| download | apache2-d2244aadacf701a0a2a3c3ae99f80760fbc6a0bb.tar.xz apache2-d2244aadacf701a0a2a3c3ae99f80760fbc6a0bb.zip | |
lot of new Korean translations
Submitted by: "Jeongho Jeon" <maczniak operamail.com>
Reviewed by: Choi Kyusic
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@103523 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod')
27 files changed, 4194 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_alias.xml.ko b/docs/manual/mod/mod_alias.xml.ko new file mode 100644 index 0000000000..a44a221937 --- /dev/null +++ b/docs/manual/mod/mod_alias.xml.ko @@ -0,0 +1,335 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.17 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_alias.xml.meta"> + +<name>mod_alias</name> +<description>파일시스템의 다른 부분들을 문서 계층구조에 포함하고, + URL 리다이렉션을 제공한다</description> +<status>Base</status> +<sourcefile>mod_alias.c</sourcefile> +<identifier>alias_module</identifier> + +<summary> + <p>이 모듈이 제공하는 지시어들을 사용하여 서버가 요청을 + 받을때 URL을 수정하거나 조작할 수 있다. <directive + module="mod_alias">Alias</directive>와 <directive + module="mod_alias">ScriptAlias</directive> 지시어는 URL을 + 파일시스템 경로로 대응한다. 그래서 <directive + module="core">DocumentRoot</directive> 아래에 없는 내용을 + 웹으로 서비스할 수 있다. 또, <directive + module="mod_alias">ScriptAlias</directive> 지시어는 지정한 + 디렉토리에 CGI 스크립트밖에 없다고 알린다.</p> + + <p><directive module="mod_alias">Redirect</directive> 지시어는 + 클라이언트에게 다른 URL로 새로운 요청을 하도록 지시한다. + 자원을 새로운 장소로 옮긴 경우 자주 사용한다.</p> +</summary> + +<seealso><module>mod_rewrite</module></seealso> <seealso><a +href="../urlmapping.html">URL을 파일시스템에 대응</a></seealso> + +<section id="order"><title>처리 순서</title> + +<p>서로 다른 사용장소에서 Alias와 Redirect를 사용하면 다른 지시어와 +같이 표준 <a href="../sections.html#mergin">결합 방법</a>에 +따라 처리한다. 그러나 같은 사용장소에 (예를 들어, 같은 <directive +type="section" module="core">VirtualHost</directive> 섹션에) +Alias와 Redirect를 사용하면 아래 순서대로 처리한다.</p> + +<p>먼저 모든 Redirect를 처리한 후 Alias를 처리한다. 그래서 +<directive module="mod_alias">Redirect</directive>나 <directive +module="mod_alias">RedirectMatch</directive>에 해당하는 요청은 +절대로 Alias하지 않는다. 그리고 Alias와 Redirect는 설정파일에서 +첫번째로 나오는 것을 사용한다.</p> + +<p>그래서 여러 지시어가 동일한 하위경로에 해당하는 경우 모든 +지시어를 적용하기위해서는 가장 상세한 경로를 먼저 사용해야 한다. +예를 들어, 다음 설정은 의도한대로 동작한다:</p> + +<example> +Alias /foo/bar /baz<br /> +Alias /foo /gaq +</example> + +<p>그러나 위의 두 지시어 순서를 바꾸면 <code>/foo/bar</code> +<directive module="mod_alias">Alias</directive> 이전에 +<code>/foo</code> <directive module="mod_alias">Alias</directive>를 +적용하므로 항상 두번째 지시어를 무시한다.</p> + +</section> + +<directivesynopsis> +<name>Alias</name> +<description>URL을 특정 파일시스템 장소로 대응한다</description> +<syntax>Alias <var>URL-path</var> +<var>file-path</var>|<var>directory-path</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + + <p><directive>Alias</directive> 지시어를 사용하면 파일시스템에서 + <directive module="core">DocumentRoot</directive> 밖에 있는 + 문서도 서비스할 수 있다. <var>url-path</var>로 시작하는 + (%로 인코딩된) URL을 <var>directory-path</var>로 시작하는 + 파일에 대응한다.</p> + + <example><title>예제:</title> + Alias /image /ftp/pub/image + </example> + + <p>http://myserver/image/foo.gif를 요청하면 서버는 + /ftp/pub/image/foo.gif 파일을 넘겨준다.</p> + + <p><var>url-path</var> 끝에 /를 포함하면, URL 끝에 /를 + 사용해야만 영향이 있음을 주의하라. 즉, <code>Alias /icons/ + /usr/local/apache/icons/</code> 설정은 url <code>/icons</code>와 + 관계가 없다.</p> + + <p>대응의 <em>대상</em>을 포함하는 여러 <directive + type="section" module="core">Directory</directive> 섹션이 + 필요할지도 모른다. 이 지시어는 <directive type="section" + module="core">Directory</directive> 섹션을 검사하기 전에 + 처리하므로, 대응의 대상만 섹션의 영향을 받는다. (그러나 + <directive type="section" module="core">Location</directive> + 섹션은 이 지시어를 처리하기 전에 한번만 검사하므로 지정한 + URL 이하 전체에 영향을 준다.)</p> + + <p>특히 <directive module="core">DocumentRoot</directive> + 밖에 있는 디렉토리로 <code>Alias</code>를 만들었다면, 직접 + 대상 디렉토리의 접근을 허용해줘야 한다.</p> + + <example><title>예제:</title> + Alias /image /ftp/pub/image<br /> + <Directory /ftp/pub/image><br /> + <indent> + Order allow,deny<br /> + Allow from all<br /> + </indent> + </Directory> + </example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AliasMatch</name> +<description>정규표현식을 사용하여 URL을 파일시스템 장소로 +대응한다</description> +<syntax>AliasMatch <var>regex</var> +<var>file-path</var>|<var>directory-path</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>이 지시어는 <directive module="mod_alias">Alias</directive>와 + 같지만, 간단히 URL의 앞부분만 비교하는 대신 표준 정규표현식을 + 사용한다. 지정한 정규표현식을 URL 경로와 비교하여 맞다면, + 서버는 괄호로 묶은 부분을 대체하여 파일명으로 사용한다. + 예를 들어, 다음과 같이 <code>/icons</code> 디렉토리를 사용할 + 수 있다:</p> + + <example> + AliasMatch ^/icons(.*) /usr/local/apache/icons$1 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Redirect</name> +<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부 +리다이렉션을 보낸다</description> +<syntax>Redirect [<var>status</var>] <var>URL-path</var> +<var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Redirect 지시어는 이전 URL을 새로운 URL로 대응한다. + 클라이언트에게 새로운 URL을 보내고, 클라이언트는 새로운 + 주소로 다시 한번 접속한다. (%로 인코딩된) <var>URL-path</var>로 + 시작하는 요청을 받으면 (%로 인코딩된) <var>URL</var>로 시작하는 + 새로운 URL로 리다이렉션 오류를 보낸다.</p> + + <example><title>예제:</title> + Redirect /service http://foo2.bar.com/service + </example> + + <p>클라이언트가 http://myserver/service/foo.txt를 요청하면 + 대신 http://foo2.bar.com/service/foo.txt에 접근하라는 응답을 + 받는다.</p> + +<note><title>주의</title> <p>Redirect 지시어는 설정파일에서 +나오는 순서와 관계없이 Alias와 ScriptAlias 지시어보다 우선순위가 +높다. 또, .htaccess 파일이나 <directive type="section" +module="core">Directory</directive> 섹션에서 사용하더라도 +<var>URL-path</var>에는 상대경로가 아니라 반드시 완전한 URL을 +사용해야 한다.</p></note> + + <p><var>status</var> 아규먼트를 지정하지않으면, "임시 + (temporary)" (HTTP 상태 302) 리다이렉션을 보낸다. 즉, + 클라이언트에게 자원을 임시로 옮겼다고 알린다. <var>status</var> + 아규먼트를 사용하여 다른 HTTP 상태코드를 반환할 수 있다:</p> + + <dl> + <dt>permanent</dt> + + <dd>자원을 완전히 옮겼음을 뜻하는 영구 리다이렉션 상태를 + (301) 반환한다.</dd> + + <dt>temp</dt> + + <dd>임시 리다이렉션 상태를 (302) 반환한다. 기본값이다.</dd> + + <dt>seeother</dt> + + <dd>자원이 교체되었음을 뜻하는 "참조 (See Other)" 상태를 + (303) 반환한다.</dd> + + <dt>gone</dt> + + <dd>자원이 영구히 삭제되었음을 뜻하는 "소멸 (Gone)" 상태를 + (410) 반환한다. 이 상태를 사용하면 <var>URL</var> 아규먼트를 + 사용할 수 없다.</dd> + </dl> + + <p><var>status</var>에 숫자 상태코드를 사용하여 다른 상태코드도 + 반환할 수 있다. 상태가 300과 399 사이라면 <var>URL</var> + 아규먼트를 사용해야 하고, 아니라면 생략해야 한다. 단, 아파치 + 코드에 상태가 정의되있어야 한다 (http_protocol.c의 + <code>send_error_response</code> 함수 참고).</p> + + <example><title>예제:</title> + Redirect permanent /one http://example.com/two<br /> + Redirect 303 /three http://example.com/other + </example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectMatch</name> +<description>현재 URL이 정규표현식에 해당하면 외부 리다이렉션을 +보낸다</description> +<syntax>RedirectMatch [<var>status</var>] <var>regex</var> +<var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>이 지시어는 <directive + module="mod_alias">Redirect</directive>와 같지만, 간단히 + URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다. + 지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로 + 묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음은 + 모든 GIF 파일 요청에 대해 다른 서버의 비슷한 이름을 가진 + JPEG 파일로 리다이렉션을 보낸다:</p> + + <example> + RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectTemp</name> +<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부 +임시 리다이렉션을 보낸다</description> +<syntax>RedirectTemp <var>URL-path</var> <var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>이 지시어는 클라이언트에게 리다이렉션이 임시적임을 (상태 + 302) 알린다. <code>Redirect temp</code>와 정확히 같다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectPermanent</name> +<description>클라이언트가 다른 URL에 접속하도록 요청하는 외부 +영구 리다이렉션을 보낸다</description> +<syntax>RedirectPermanent <var>URL-path</var> <var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>이 지시어는 클라이언트에게 리다이렉션이 영구적임을 (상태 + 301) 알린다. <code>Redirect permanent</code>와 정확히 같다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptAlias</name> +<description>URL을 특정 파일시스템 장소로 대응하고 대상이 CGI +스크립트라고 알린다</description> +<syntax>ScriptAlias <var>URL-path</var> +<var>file-path</var>|<var>directory-path</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p><directive>ScriptAlias</directive> 지시어는 <directive + module="mod_alias">Alias</directive> 지시어와 비슷하지만, + 추가로 대상 디렉토리에 <module >mod_cgi</module>의 cgi-script + 핸들러가 처리할 CGI 스크립트가 있다고 알린다. + <var>URL-path</var>로 시작하는 (%로 인코딩된) URL을 파일시스템의 + 절대경로인 두번째 아규먼트로 시작하는 스크립트에 대응한다.</p> + + <example><title>예제:</title> + ScriptAlias /cgi-bin/ /web/cgi-bin/ + </example> + + <p><code>http://myserver/cgi-bin/foo</code>를 요청하면 서버는 + <code>/web/cgi-bin/foo</code> 스크립트를 실행한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptAliasMatch</name> +<description>정규표현식을 사용하여 URL을 특정 파일시스템 장소로 +대응하고 대상이 CGI 스크립트라고 알린다</description> +<syntax>ScriptAliasMatch <var>regex</var> +<var>file-path</var>|<var>directory-path</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>이 지시어는 <directive + module="mod_alias">ScriptAlias</directive>와 같지만, 간단히 + URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다. + 지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로 + 묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음과 + 같이 표준적인 <code>/cgi-bin</code>을 사용할 수 있다:</p> + + <example> + ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_auth_basic.xml.ko b/docs/manual/mod/mod_auth_basic.xml.ko new file mode 100644 index 0000000000..c34be7bc82 --- /dev/null +++ b/docs/manual/mod/mod_auth_basic.xml.ko @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.10 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_auth_basic.xml.meta"> + +<name>mod_auth_basic</name> +<description>Basic authentication</description> +<status>Base</status> +<sourcefile>mod_auth_basic.c</sourcefile> +<identifier>auth_basic_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 해당 제공자(provider)를 사용하여 사용자별로 + 접근을 제한하는 HTTP Basic Authentication을 제공한다. + HTTP Digest Authentication은 <module>mod_auth_digest</module>가 + 제공한다.</p> +</summary> +<seealso><directive module="core">AuthName</directive></seealso> +<seealso><directive module="core">AuthType</directive></seealso> + +<directivesynopsis> +<name>AuthBasicProvider</name> +<description>이 위치에 대한 인증제공자를 지정한다</description> +<syntax>AuthBasicProvider On|Off|<var>provider-name</var> +[<var>provider-name</var>] ...</syntax> +<default>AuthBasicProvider On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthBasicProvider</directive> 지시어는 이 + 위치에서 사용자를 인증할 제공자를 지정한다. 값이 + <code>On</code>이면 기본제공자(<code>file</code>)를 선택한다. + <module>mod_authn_file</module> 모듈이 <code>file</code> + 제공자를 구현하기때문에 서버에 이 모듈이 있는지 확인해야 + 한다.</p> + + <example><title>예제</title> + <Location /secure><br /> + <indent> + AuthBasicProvider dbm<br /> + AuthDBMType SDBM<br /> + AuthDBMUserFile /www/etc/dbmpasswd<br /> + Require valid-user<br /> + </indent> + </Location> + </example> + + <p>제공자는 <module>mod_authn_dbm</module>과 + <module>mod_authn_file</module>을 참고하라.</p> + + <p>값이 <code>Off</code>이면 제공자 목록을 지우고 기본상태로 + 돌아간다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthBasicAuthoritative</name> +<description>인증과 권한부여를 저수준 모듈에 넘겨줄지 결정한다</description> +<syntax>AuthBasicAuthoritative On|Off</syntax> +<default>AuthBasicAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthBasicAuthoritative</directive> 지시어를 + <code>Off</code>로 설정하면 주어진 사용자 아이디에 해당하는 + <strong>사용자 아이디</strong>나 <strong>규칙</strong>을 + 찾을 수 없는 경우 인증과 권한부여 모두를 (<code>modules.c</code> + 파일에서 정의한) 저수준 모듈로 넘겨준다. 주어진 사용자 + 아이디나 규칙을 찾았다면 보통때와 같이 암호와 접근허용여부를 + 검사하고, 실패하면 "Authentication Required (인증 필요)" + 응답을 한다.</p> + + <p>그래서 여러 모듈의 데이터베이스에 사용자 아이디가 있거나 + 유효한 <directive module="core">Require</directive> 지시어를 + 여러 모듈에 적용하면, 첫번째 모듈이 사용자를 검사하고, + <directive>AuthBasicAuthoritative</directive> 설정과 관계없이 + 접근을 넘기지않는다.</p> + + <p>기본적으로 제어를 넘기지않고, 모르는 사용자 아이디와 + 규칙인 경우 "Authentication Required (인증 필요)" 응답을 + 한다. 이 지시어를 설정하지않으면 시스템이 안전하게 유지되며, + NCSA 웹서버와 같이 동작한다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_auth_digest.xml.ko b/docs/manual/mod/mod_auth_digest.xml.ko new file mode 100644 index 0000000000..6f0dfa4637 --- /dev/null +++ b/docs/manual/mod/mod_auth_digest.xml.ko @@ -0,0 +1,295 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.15 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_auth_digest.xml.meta"> + +<name>mod_auth_digest</name> +<description>MD5 Digest Authentication을 사용한 사용자인증.</description> +<status>Experimental</status> +<sourcefile>mod_auth_digest.c</sourcefile> +<identifier>auth_digest_module</identifier> + +<summary> + <p>이 모듈은 HTTP Digest Authentication을 구현한다. + 그러나 많은 테스트를 거치지 않은 실험적인 모듈이다.</p> +</summary> + +<seealso><directive module="core">AuthName</directive></seealso> +<seealso><directive module="core">AuthType</directive></seealso> +<seealso><directive module="core">Require</directive></seealso> +<seealso><directive module="core">Satisfy</directive></seealso> + +<section id="using"><title>Digest Authentication 사용하기</title> + + <p>MD5 Digest authentication은 매우 쉽게 사용할 수 있다. + <code>AuthType Basic</code>과 <directive + module="mod_auth_basic">AuthBasicProvider</directive> 대신 + <code>AuthType Digest</code>와 <directive + module="mod_auth_digest">AuthDigestProvider</directive>를 + 사용하여 간단히 인증을 설정할 수 있다. 그리고 최소한 보호하려는 + 영역의 기본 URI을 <directive module="mod_auth_digest" + >AuthDigestDomain</directive> 지시어에 사용한다.</p> + + <p><a href="../programs/htdigest.html">htdigest</a> 도구를 + 사용하여 사용자 (문자)파일을 만들 수 있다.</p> + + <example><title>예제:</title> + <Location /private/><br /> + <indent> + AuthType Digest<br /> + AuthName "private area"<br /> + AuthDigestDomain /private/ http://mirror.my.dom/private2/<br /> + <br /> + AuthDigestProvider file<br /> + AuthUserFile /web/auth/.digest_pw<br /> + Require valid-user<br /> + </indent> + </Location> + </example> + + <note><title>주의</title> + <p>Digest authentication은 Basic authentication보다 더 + 안전한 암호시스템을 제공하지만, 브라우저가 지원해야 한다. + 2002년 11월 현재 digest authentication을 지원하는 브라우저에는 + <a href="http://www.opera.com/">Opera</a>, (질의문자열과 + 함께 사용할 수 없지만) <a + href="http://www.microsoft.com/windows/ie/">MS Internet + Explorer</a>, <a + href="http://www.w3.org/Amaya/">Amaya</a>, <a + href="http://www.mozilla.org">Mozilla</a>, 버전 7 이후의 + <a href="http://channels.netscape.com/ns/browsers/download.jsp" + >Netscape</a> 등이 있다. digest authentication이 basic + authentication 만큼 널리 구현되지 않았기때문에 주의해서 + 사용해야 한다.</p> + </note> +</section> + +<directivesynopsis> +<name>AuthDigestProvider</name> +<description>이 위치에 대한 인증제공자를 지정한다</description> +<syntax>AuthDigestProvider On|Off|<var>provider-name</var> +[<var>provider-name</var>] ...</syntax> +<default>AuthDigestProvider On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDigestProvider</directive> 지시어는 이 + 위치에서 사용자를 인증할 제공자를 지정한다. 값이 + <code>On</code>이면 기본제공자(<code>file</code>)를 사용한다. + <module>mod_authn_file</module> 모듈이 <code>file</code> + 제공자를 구현하기때문에 서버에 이 모듈이 있는지 확인해야 + 한다.</p> + + <p>제공자는 <module>mod_authn_dbm</module>과 + <module>mod_authn_file</module>을 참고하라.</p> + + <p>값이 <code>Off</code>이면 제공자 목록을 지우고 기본상태로 + 돌아간다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestQop</name> +<description>digest authentication가 사용할 +보호수준(quality-of-protection)을 지정한다.</description> +<syntax>AuthDigestQop none|auth|auth-int [auth|auth-int]</syntax> +<default>AuthDigestQop auth</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDigestQop</directive> 지시어는 + <dfn>보호수준(quality-of-protection)</dfn>을 지정한다. + <code>auth</code>는 (사용자명/암호) 인증만 하고, + <code>auth-int</code>는 인증과 완결성 검사를 (MD5 해쉬도 + 계산하여 검사한다) 한다. <code>none</code>은 (완결성 검사를 + 하지않는) 오래된 RFC-2069 digest 알고리즘을 사용한다. + <code>auth</code>와 <code>auth-int</code>를 모두 지정할 + 수 있다. 이 경우 브라우저는 어떤 것을 사용할지 선택한다. + 브라우저가 어던 이유에서건 challenge를 좋아하지 않는다면 + <code>none</code>을 사용해야 한다.</p> + + <note> + <code>auth-int</code>는 아직 구현되지 않았다. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNonceLifetime</name> +<description>서버 nonce가 유효한 기간</description> +<syntax>AuthDigestNonceLifetime <var>seconds</var></syntax> +<default>AuthDigestNonceLifetime 300</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDigestNonceLifetime</directive> 지시어는 + 서버 nonce가 유효한 기간을 조절한다. 클라이언트가 만기된 + nonce를 가지고 서버에 접근하면 서버는 <code>stale=true</code>와 + 함께 401을 반환한다. <var>seconds</var>가 0보다 크면 nonce가 + 유효한 기간을 지정한다. 아마도 10 초보다 작게 설정하면 안된다. + <var>seconds</var>가 0보다 작으면 nonce는 영원히 만기되지 + 않는다. <!-- 아직 구현되지 않았음: <var>seconds</var>가 + 0이면 클라이언트는 정확히 한번만 nonce를 사용할 수 있다. + 한번만 사용할 수 있는 nonce는 재생공격(replay attack)에 + 대해 더 안전한 보안을 제공하지만, 브라우저가 요청들을 연속해서 + 보내거나 여러 연결을 동시에 할 수가 없어서 성능이 상당히 + 떨어질 수 있음을 주의하라. 브라우저는 nonce를 이미 사용하였는지 + 쉽게 알아낼 수 없기때문에 요청을 연속해서 보낸후, 첫번째 + 요청을 제외하고 401 응답을 받은 다음 요청을 다시 보내게 + 된다. 또 재생공격에 대한 보호는 POST 요청과 같이 동적으로 + 내용을 생성하는 경우에만 의미가 있음을 주의하라. 정적인 + 내용의 경우 공격자는 이미 완전한 내용을 가지고 있으므로, + 한번만 사용할 수 있는 nonce는 의미가 없다. --> + </p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNonceFormat</name> +<description>nonce를 만드는 방법을 결정한다</description> +<syntax>AuthDigestNonceFormat <var>format</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <note>아직 구현되지 않았다.</note> + <!-- AuthDigestNonceFormat 지시어는 nonce를 만드는 방법을 + 결정한다. --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestNcCheck</name> +<description>서버가 보내는 nonce-count를 검사할지 여부</description> +<syntax>AuthDigestNcCheck On|Off</syntax> +<default>AuthDigestNcCheck Off</default> +<contextlist><context>server config</context></contextlist> + +<usage> + <note> + 아직 구현되지 않았다. + </note> + <!-- + <p>AuthDigestNcCheck 지시어는 서버가 보내는 nonce-count를 + 검사할지 결정한다.</p> + + <p>보안상 권장하지만 이 지시어를 On으로 설정하면 성능이 + 크게 떨어진다. nonce-count를 검사하려면 (digest authentication + 여부와 관계없이 Authorization 헤더를 보내는) *모든* 요청을 + 임계영역(critical section)을 통해 처리해야 한다. 서버가 + Authorization 헤더를 포함한 매우 많은 요청을 처리한다면 + 성능이 현저히 떨어질 수 있다.</p> + --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestAlgorithm</name> +<description>digest authentication에서 challenge와 response +hash를 계산하는 알고리즘을 선택한다</description> +<syntax>AuthDigestAlgorithm MD5|MD5-sess</syntax> +<default>AuthDigestAlgorithm MD5</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDigestAlgorithm</directive> 지시어는 + challenge와 response hash를 계산하는 알고리즘을 선택한다.</p> + + <note> + <code>MD5-sess</code>는 아직 완전히 구현되지 않았다. + </note> + <!-- + <p><code>MD5-sess</code>를 사용하려면 + <code>mod_auth_digest.c</code>의 <code>get_userpw_hash()</code> + 함수를 먼저 작성해야 한다.</p> + --> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestDomain</name> +<description>digest authentication에서 같은 보호영역에 속하는 +URI들</description> +<syntax>AuthDigestDomain <var>URI</var> [<var>URI</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDigestDomain</directive> 지시어는 같은 + 보호영역에 있는 (<em>예를 들어</em> 같은 영역과 사용자명/암호 + 정보를 사용하는) URI들을 지정한다. 지정한 URI는 접두사로 + 사용한다. 클라이언트는 URI "아래" 모두를 + 같은 사용자명/암호로 보호한다고 가정한다. URI는 + (<em>즉</em>, 스킴(scheme), 호스트, 포트 등을 포함하는) + 절대 URL이거나 상대 URI이다.</p> + + <p>이 지시어는 항상 <em>지정해야</em> 하며, 최소한 영역들의 + 기본 URI(들)를 포함<em>해야</em> 한다. 생략하면 클라이언트는 + 이 서버로 보내는 <em>모든 요청</em>에 Authorization 헤더를 + 포함한다. 그러면 요청의 크기가 커지며, <directive + module="mod_auth_digest">AuthDigestNcCheck</directive>를 + 사용한다면 성능에 나쁜 영향을 줄 수 있다.</p> + + <p>다른 서버의 URI를 지정하면, (이를 이해하는) 클라이언트는 + 여러 서버마다 매번 사용자에게 묻지않고 같은 사용자명/암호를 + 사용할 수 있다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDigestShmemSize</name> +<description>클라이언트를 추적하기위해 할당하는 공유메모리량</description> +<syntax>AuthDigestShmemSize <var>size</var></syntax> +<default>AuthDigestShmemSize 1000</default> +<contextlist><context>server config</context></contextlist> + +<usage> + <p><directive>AuthDigestShmemSize</directive> 지시어는 + 클라이언트를 추적하기위해 서버가 시작할때 할당하는 + 공유메모리량을 정의한다. 공유메모리는 최소한 <em>하나의</em> + 클라이언트를 추적하기위해 필요한 공간보다 작을 수 없음을 + 주의하라. 이 값은 시스템에 따라 다르다. 정확한 값을 알려면 + <directive>AuthDigestShmemSize</directive>를 <code>0</code>으로 + 설정하고 서버를 시작한후 오류문을 참고하라.</p> + + <p><var>size</var>는 보통 바이트 단위이지만, 뒤에 + <code>K</code>나 <code>M</code>을 사용하여 KBytes나 MBytes를 + 나타낼 수 있다. 예를 들어, 다음 지시어들은 모두 같다:</p> + + <example> + AuthDigestShmemSize 1048576<br /> + AuthDigestShmemSize 1024K<br /> + AuthDigestShmemSize 1M + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_anon.xml.ko b/docs/manual/mod/mod_authn_anon.xml.ko new file mode 100644 index 0000000000..2123fe82ec --- /dev/null +++ b/docs/manual/mod/mod_authn_anon.xml.ko @@ -0,0 +1,195 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.10 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authn_anon.xml.meta"> + +<name>mod_authn_anon</name> +<description>인증영역에 "익명(anonymous)" 사용자의 접근을 +허용한다</description> +<status>Extension</status> +<sourcefile>mod_authn_anon.c</sourcefile> +<identifier>authn_anon_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 <module>mod_auth_basic</module> 등 인증앞단모듈을 + 위해 (<em>예를 들어</em> '특별한' 사용자 아이디 'anonymous'와 + 전자우편 주소를 암호로 사용하는) 익명-ftp 사이트와 유사한 + 사용자 인증을 한다. 전자우편 주소를 로그에 기록할 수 있다.</p> + + <p>다른 (데이터베이스) 접근제어 방식과 함께 사용하여 + '등록하지않은' 사용자에게 사이트를 열어두면서 효율적인 사용자 + 추적과 사용자정의가 가능하다. 인증기반 사용자 추적은 쿠키나 + 괴상한 URL 접두사/접미사와 달리 완전히 브라우저 독립적이고 + 사용자가 URL을 공유할 수 있다는 장점이 있다.</p> + + <p><module>mod_auth_basic</module>을 사용할때 <directive + module="mod_auth_basic">AuthBasicProvider</directive>의 + 값으로 <code>anon</code>을 설정하면 이 모듈을 사용한다.</p> +</summary> + +<section id="example"><title>예제</title> + <p>다음 예는 "일반적인" htpasswd-파일기반 인증에 추가로 + 사용자가 다음 조건을 만족한다면 '손님(guest)'으로 접근할 + 수 있도록 한다:</p> + + <ul> + <li>사용자는 사용자 아이디를 입력해야 한다. (<directive + module="mod_authn_anon">Anonymous_NoUserID</directive>)</li> + + <li>사용자는 암호를 입력해야 한다. (<directive + module="mod_authn_anon">Anonymous_MustGiveEmail</directive>)</li> + + <li>암호로 유효한 전자우편 주소를 입력해야 한다. <em>예를 + 들어</em> 최소한 '@'와 '.' 한개를 포함해야 한다. (<directive + module="mod_authn_anon">Anonymous_VerifyEmail</directive>)</li> + + <li>사용자 아이디는 <code>anonymous guest www test + welcome</code> 중 하나이며, 대소문자를 구별하지 + <strong>않는다</strong>. (<directive module="mod_authn_anon" + >Anonymous</directive>)</li> + + <li>그리고 암호로 입력한 전자우편 주소를 오류로그파일에 + 기록한다. (<directive + module="mod_authn_anon">Anonymous_LogEmail</directive>)</li> + </ul> + + <example><title>예제</title> + <Directory /foo> + <indent> + AuthName "손님으로 방문하려면 'anonymous'와 전자우편 주소를 사용하라"<br /> + AuthType Basic<br /> + AuthBasicProvider file anon<br /> + AuthUserFile /path/to/your/.htpasswd<br /> + <br /> + Anonymous_NoUserID off<br /> + Anonymous_MustGiveEmail on<br /> + Anonymous_VerifyEmail on<br /> + Anonymous_LogEmail on<br /> + Anonymous anonymous guest www test welcome<br /> + <br /> + Order Deny,Allow<br /> + Allow from all<br /> + <br /> + Require valid-user<br /> + </indent> + </Directory> + </example> +</section> + +<directivesynopsis> +<name>Anonymous</name> +<description>암호검사없이 접근을 허용할 사용자 아이디들을 +지정한다</description> +<syntax>Anonymous <var>user</var> [<var>user</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>암호검사없이 접근을 허용할 '특별한' 사용자 아이디 목록. + 사용자 아이디들을 공백으로 구분한다. 따옴표 '와 "나 탈출문자 + \를 사용하여 사용자 아이디 안에 공백을 포함할 수 있다.</p> + + <p>아이디는 <strong>대소문자를 구별하지않음</strong>을 + 주의하라.<br /> + 허용할 사용자 아이디에 특별한 사용자명인 + '<code>anonymous</code>'를 항상 포함하길 강력히 권한다.</p> + + <example><title>예제:</title> + Anonymous anonymous "Not Registered" "I don't know" + </example> + + <p>"anonymous", "AnonyMous", "Not Registered", "I Don't Know" + 등 사용자 아이디를 사용하면 암호검사없이 사용자를 허용한다.</p> + + <p>아파치 2.1에서는 사용자 아이디로 "<code>*</code>"를 + 사용할 수 있다. 그러면 <em>어떤</em> 사용자 아이디라도 + 받아들인다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Anonymous_LogEmail</name> +<description>입력한 암호를 오류로그에 기록할지 여부</description> +<syntax>Anonymous_LogEmail On|Off</syntax> +<default>Anonymous_LogEmail On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>기본값인 <code>On</code>으로 설정하면 (아마도 전자우편 + 주소일) 입력한 '암호'를 오류로그에 기록한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Anonymous_MustGiveEmail</name> +<description>암호가 없어도 가능한지 여부</description> +<syntax>Anonymous_MustGiveEmail On|Off</syntax> +<default>Anonymous_MustGiveEmail On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>사용자가 암호로 전자우편 주소를 입력해야 하는지 여부를 + 결정한다. 암호가 없으면 거부한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Anonymous_NoUserID</name> +<description>사용자 아이디가 없어도 가능하지 여부</description> +<syntax>Anonymous_NoUserID On|Off</syntax> +<default>Anonymous_NoUserID Off</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><code>On</code>으로 설정하면 사용자는 사용자 아이디를 + (아마 암호도) 입력하지 않아도 된다. 이는 자연스럽게 그냥 + return을 치거나 OK 버튼을 클릭하는 MS-Explorer 사용자에게 + 매우 편리하다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Anonymous_VerifyEmail</name> +<description>암호가 올바른 형식의 전자우편 주소인지 검사 +여부</description> +<syntax>Anonymous_VerifyEmail On|Off</syntax> +<default>Anonymous_VerifyEmail Off</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><code>On</code>으로 설정하면 사용자가 올바른 전자우편 + 주소를 입력하도록 입력한 '암호'가 최소한 '@'와 '.'를 한개씩 + 포함하는지 검사한다 (위의 <directive + module="mod_authn_anon">Anonymous_LogEmail</directive> 참고).</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_dbm.xml.ko b/docs/manual/mod/mod_authn_dbm.xml.ko new file mode 100644 index 0000000000..8960795a91 --- /dev/null +++ b/docs/manual/mod/mod_authn_dbm.xml.ko @@ -0,0 +1,112 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.9 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authn_dbm.xml.meta"> + +<name>mod_authn_dbm</name> +<description>DBM 파일을 사용한 사용자 인증</description> +<status>Extension</status> +<sourcefile>mod_authn_dbm.c</sourcefile> +<identifier>authn_dbm_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 <module>mod_auth_digest</module>나 + <module>mod_auth_basic</module> 인증앞단모듈을 위해 + <dfn>dbm</dfn> 암호파일에서 사용자를 찾아서 인증한다. + <module>mod_authn_file</module>과 기능이 비슷한다.</p> + + <p><module>mod_auth_basic</module>이나 + <module>mod_auth_digest</module>를 사용할때 <directive + module="mod_auth_basic">AuthBasicProvider</directive>나 + <directive module="mod_auth_digest">AuthDigestProvider</directive>의 + 값으로 <code>dbm</code>을 설정하면 이 모듈을 사용한다.</p> +</summary> + +<seealso><directive module="core">AuthName</directive></seealso> +<seealso><directive module="core">AuthType</directive></seealso> +<seealso> + <directive module="mod_auth_basic">AuthBasicProvider</directive> +</seealso> +<seealso> + <directive module="mod_auth_digest">AuthDigestProvider</directive> +</seealso> + +<directivesynopsis> +<name>AuthDBMUserFile</name> +<description>인증할 사용자와 암호 목록을 저장하는 데이터베이스 +파일명을 지정한다</description> +<syntax>AuthDBMUserFile <var>file-path</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDBMUserFile</directive> 지시어는 사용자 + 인증에 사용할 사용자와 암호 목록을 저장하는 DBM 파일명을 + 지정한다. <var>File-path</var>는 파일의 절대경로이다.</p> + + <p>파일은 사용자명을 키로 사용한다. 사용자에 대한 값은 + 인코딩된 암호이다. 암호 뒤에 콜론과 임의의 정보가 나올 수 + 있다. 서버는 콜론과 뒤에 나오는 정보를 무시한다.</p> + + <note type="warning"><title>보안:</title> + <p><directive>AuthDBMUserFile</directive>이 웹서버의 문서들 + 밖에 있음을 확인하라. 이 파일을 보호할 디렉토리 안에 같이 + 두지 <em>마라</em>. 그렇지 않으면, 클라이언트가 + <directive>AuthDBMUserFile</directive>을 다운로드할 수 + 있다.</p> + </note> + + <p>중요한 호환성 주의: 아파치 모듈의 <code>dbmopen</code> + 구현은 문자열 끝의 NULL에 의존하지않고 DBM 자료구조에서 + 해싱값의 문자열 길이를 읽는다. Netscape 웹서버 등 어떤 + 프로그램은 문자열이 NULL로 끝난다고 가정하기때문에 여러 + 프로그램이 DBM 파일을 사용하면 문제가 될 수 있다.</p> + + <p>아파치는 <a href="../programs/dbmmanage.html">dbmmanage</a>라는 + Perl 스크립트를 포함한다. 이 프로그램은 이 모듈이 사용할 + DBM형식 암호파일을 만들고 수정한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthDBMType</name> +<description>암호를 저장하는 데이터베이스 파일 종류를 +지정한다</description> +<syntax>AuthDBMType default|SDBM|GDBM|NDBM|DB</syntax> +<default>AuthDBMType default</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>암호를 저장하는 데이터베이스 파일 종류를 지정한다. 기본 + 데이터베이스 종류는 컴파일때 판단한다. 사용할 수 있는 다른 + 데이터베이스 파일 종류도 <a href="../install.html#dbm">컴파일 + 설정</a>에 달렸다.</p> + + <p>암호파일을 만드는 프로그램이 같은 종류의 데이터베이스를 + 사용하도록 설정해야 한다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_default.xml.ko b/docs/manual/mod/mod_authn_default.xml.ko new file mode 100644 index 0000000000..aacb430181 --- /dev/null +++ b/docs/manual/mod/mod_authn_default.xml.ko @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.4 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authn_default.xml.meta"> + +<name>mod_authn_default</name> +<description>최후 인증모듈</description> +<status>Base</status> +<sourcefile>mod_authn_default.c</sourcefile> +<identifier>authn_default_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 <module>mod_auth_basic</module>과 같은 인증모듈을 + 설정하지않은 최후의 경우 대신 사용한다. 이 모듈은 사용자가 + 제공한 어떠한 정보도 거부한다.</p> +</summary> + +<directivesynopsis> +<name>AuthDefaultAuthoritative</name> +<description>인증을 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthDefaultAuthoritative On|Off</syntax> +<default>AuthDefaultAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDefaultAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 (<code>modules.c</code> + 파일에서 정의한) 저수준 모듈로 인증을 넘겨준다.</p> + + <note><title>주의</title> + <p><module>mod_authn_default</module>가 이미 <em>매우 + 저수준</em>으로 정의되있기 때문에 보통 더 낮은 모듈이 없다. + 그러므로 <directive>AuthDefaultAuthoritative</directive>를 + 기본값(<code>On</code>)으로 남겨둬야 한다.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_file.xml.ko b/docs/manual/mod/mod_authn_file.xml.ko new file mode 100644 index 0000000000..b85fdaedd3 --- /dev/null +++ b/docs/manual/mod/mod_authn_file.xml.ko @@ -0,0 +1,114 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.8 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authn_file.xml.meta"> + +<name>mod_authn_file</name> +<description>문자파일을 이용한 사용자 인증</description> +<status>Base</status> +<sourcefile>mod_authn_file.c</sourcefile> +<identifier>authn_file_module</identifier> +<compatibility>아파치 2.1 이후</compatibility> + +<summary> + <p>이 모듈은 <module>mod_auth_digest</module>와 + <module>mod_auth_basic</module> 같은 인증앞단모듈을 위해 + 일반 문자 암호파일에서 사용자를 찾아서 인증한다. + <module>mod_authn_dbm</module>과 기능이 비슷하다.</p> + + <p><module>mod_auth_basic</module>이나 + <module>mod_auth_digest</module>를 사용할때 <directive + module="mod_auth_basic">AuthBasicProvider</directive>나 + <directive + module="mod_auth_digest">AuthDigestProvider</directive>의 + 값을 <code>file</code>로 설정하면 이 모듈을 사용한다.</p> +</summary> +<seealso> + <directive module="mod_auth_basic">AuthBasicProvider</directive> +</seealso> +<seealso> + <directive module="mod_auth_digest">AuthDigestProvider</directive> +</seealso> +<seealso><a href="../programs/htpasswd.html">htpasswd</a></seealso> +<seealso><a href="../programs/htdigest.html">htdigest</a></seealso> + +<directivesynopsis> +<name>AuthUserFile</name> +<description>인증할 사용자명와 암호 목록을 저장하는 문자파일명을 +지정한다</description> +<syntax>AuthUserFile <var>file-path</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthUserFile</directive> 지시어는 사용자 인증에 + 사용할 사용자명와 암호 목록을 저장하는 문자파일명을 지정한다. + <var>File-path</var>는 파일경로이다. 절대경로를 사용하지 + 않으면 <directive module="core">ServerRoot</directive>의 + 상대경로로 처리한다.</p> + + <p>파일의 각 줄에는 사용자명, 콜론, 인코딩된 암호가 순서대로 + 나온다. 여러 줄에서 동일한 사용자 아이디를 정의하면, + <module>mod_authn_file</module>는 첫번째로 나오는 암호를 + 사용한다.</p> + + <p>컴파일된 배포본이나 <code>src/support</code>에 있는 <a + href="../programs/htpasswd.html">htpasswd</a> 도구는 <em>HTTP + Basic Authentication</em>에 사용할 암호파일을 관리한다. + 자세한 내용은 <a href="../programs/htpasswd.html">manpage</a>를 + 참고하라. 요약하면:</p> + + <p>초기 아이디 <code>username</code>을 가진 암호파일 + <code>Filename</code>을 만든다. 암호를 물어본다:</p> + + <example> + htpasswd -c Filename username + </example> + + <p>암호파일 <code>Filename</code>에 <code>username2</code>를 + 추가하거나 수정한다:</p> + + <example> + htpasswd Filename username2 + </example> + + <p>큰 문자파일을 검색하는 것은 <em>매우</em> 비효율적임을 + 주의하라. 사용자가 많다면 대신 <directive + module="mod_authn_dbm">AuthDBMUserFile</directive>을 사용해야 + 한다.</p> + + <p><em>HTTP Digest Authentication</em>을 사용한다면 <a + href="../programs/htpasswd.html">htpasswd</a> 도구로 안된다. + 대신 <a href="../programs/htdigest.html">htdigest</a>를 + 사용해야 한다. Digest Authentication과 Basic Authentication을 + 위한 자료를 같은 파일에 섞어서 사용할 수 없음을 주의하라.</p> + + <note type="warning"><title>보안</title> + <p><directive>AuthUserFile</directive>이 웹서버의 문서들 + 밖에 위치함을 확인하라. 이 파일을 보호할 디렉토리 안에 + 같이 두지 <em>마라</em>. 그렇지 않으면, 클라이언트가 + <directive>AuthUserFile</directive>을 다운로드할 수 있다.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_dbm.xml.ko b/docs/manual/mod/mod_authz_dbm.xml.ko new file mode 100644 index 0000000000..5b19a9b5df --- /dev/null +++ b/docs/manual/mod/mod_authz_dbm.xml.ko @@ -0,0 +1,152 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.7 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_dbm.xml.meta"> + +<name>mod_authz_dbm</name> +<description>DBM 파일을 사용한 그룹 인증</description> +<status>Extension</status> +<sourcefile>mod_authz_dbm.c</sourcefile> +<identifier>authz_dbm_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 인증한 사용자의 그룹권한으로 웹의 일부를 접근할 + 수 있는지 결정하여 권한부여를 한다. + <module>mod_authz_groupfile</module>과 기능이 비슷하다.</p> +</summary> + +<seealso><directive module="core">Require</directive></seealso> +<seealso><directive module="core">Satisfy</directive></seealso> + +<directivesynopsis> +<name>AuthDBMGroupFile</name> +<description>인증에 사용할 사용자 그룹 목록을 저장하는 데이터베이스 +파일명을 지정한다</description> +<syntax>AuthDBMGroupFile <var>file-path</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthDBMGroupFile</directive> 지시어는 인증에 + 사용할 사용자 그룹 목록을 저장하는 DBM 파일명을 지정한다. + <var>File-path</var>는 파일의 절대경로이다.</p> + + <p>파일은 사용자명을 키로 사용한다. 사용자에 대한 값은 쉼표로 + 구분한 사용자가 속한 그룹 목록이다. 값에 공백이나 콜론을 + 사용할 수 없다.</p> + + <note type="warning"><title>보안</title> + <p><directive>AuthDBMGroupFile</directive>이 웹서버의 + 문서들 밖에 위치함을 확인하라. 이 파일을 보호할 디렉토리 + 안에 같이 두지 <em>마라</em>. 그렇지 않으면, 클라이언트가 + <directive>AuthDBMGroupFile</directive>를 다운로드할 수 + 있다.</p> + </note> + + <p>그룹 DBM 파일과 암호 DBM 파일을 같이 사용하기: 사용자에 + 대한 암호와 그룹 정보 모두를 한 데이터베이스에서 관리하는 + 것이 쉬울때가 있다. 이 경우 작성할 지원 프로그램이 간단해진다. + 프로그램은 한 DBM 파일만을 잠그고 쓰면 된다. 그룹파일과 + 암호파일을 같은 DBM파일로 설정하면 가능하다:</p> + + <example> + AuthDBMGroupFile /www/userbase<br /> + AuthDBMUserFile /www/userbase + </example> + + <p>이 통합 DBM의 키는 사용자명이다. 값은 다음과 같다</p> + + <example> + 인코딩된 암호 : 그룹 목록 [ : (무시) ] + </example> + + <p>암호 부분은 전과 같이 인코딩된 암호이다. 콜론 뒤에 쉼표로 + 구분한 그룹 목록이 나온다. 또 다시 콜론 다음에 다른 정보를 + 기록할 수 있다. 이 부분은 인증모듈이 무시한다. + www.telescope.org는 이렇게 암호 데이터베이스와 그룹 + 데이터베이스를 같이 사용한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthzDBMType</name> +<description>암호를 저장하는 데이터베이스 파일 종류를 지정한다</description> +<syntax>AuthzDBMType default|SDBM|GDBM|NDBM|DB</syntax> +<default>AuthzDBMType default</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>암호를 저장하는 데이터베이스 파일 종류를 지정한다. + 데이터베이스 종류 기본값은 컴파일때 정해진다. 사용할 수 + 있는 다른 데이터베이스 파일 종류도 <a + href="../install.html#dbm">컴파일 설정</a>에 달렸다.</p> + + <p>암호파일을 만든 프로그램이 같은 종류의 데이터베이스를 + 사용하도록 설정해야 한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthzDBMAuthoritative</name> +<description>권한부여를 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthzDBMAuthoritative On|Off</syntax> +<default>AuthzDBMAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthzDBMAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 해당 사용자 아이디에 대한 + 그룹이 없는 경우 그룹 권한부여를 (<code>modules.c</code> + 파일에서 정의한) 저수준 모듈로 넘겨준다. 지정한 그룹이 있다면 + 보통때와 같이 검사하고, 실패하면 인증 필요 응답을 한다.</p> + + <p>그래서 여러 모듈의 데이터베이스에 사용자 아이디가 있거나 + 유효한 <directive module="core">Require</directive> 지시어를 + 여러 모듈에 적용하면, 첫번째 모듈이 사용자를 검사하고, + <directive>AuthAuthoritative</directive> 설정과 관계없이 + 접근을 넘기지않는다.</p> + + <p>일반적으로 <module>mod_authn_dbm</module>이나 + <module>mod_authn_file</module>과 같은 인증제공자와 같이 + 사용한다. 대량의 사용자 검사에 대한 검사는 DBM 모듈을 + 사용하지만, 소수(관리자)에 대한 검사는 잘 보호된 + <code>.htpasswd</code> 파일로 넘긴다.</p> + + <p>기본적으로 제어를 넘기지않고, 모르는 그룹의 경우 인증 + 필요 응답을 한다. 이 지시어를 설정하지않으면 시스템이 안전하게 + 유지되며, NCSA 웹서버와 같이 동작한다.</p> + + <note type="warning"><title>보안</title> + <p>사용자가 자신의 .htaccess 파일을 사용하게 되는지 살펴보고, + 이런 행동을 허용할지 결정하라. 일반적으로 여러가지 방법으로 + 접근할 수 있는 데이터베이스를 보호하는 것보다 하나의 + <code>.htpasswd</code> 파일을 보호하는 것이 더 쉽다.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_default.xml.ko b/docs/manual/mod/mod_authz_default.xml.ko new file mode 100644 index 0000000000..a0cd38adba --- /dev/null +++ b/docs/manual/mod/mod_authz_default.xml.ko @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.4 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_default.xml.meta"> + +<name>mod_authz_default</name> +<description>최후 권한부여모듈</description> +<status>Base</status> +<sourcefile>mod_authz_default.c</sourcefile> +<identifier>authz_default_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 <module>mod_authz_user</module>나 + <module>mod_authz_groupfile</module>와 같은 권한부여모듈을 + 설정하지않은 최후의 경우 대신 사용한다. 이 모듈은 모든 권한부여 + 요청을 거부한다.</p> +</summary> + +<directivesynopsis> +<name>AuthzDefaultAuthoritative</name> +<description>권한부여를 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthzDefaultAuthoritative On|Off</syntax> +<default>AuthzDefaultAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthzDefaultAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 (<code>modules.c</code> + 파일에서 정의한) 저수준 모듈로 권한부여를 넘겨준다.</p> + + <note><title>주의</title> + <p><module>mod_authz_default</module>가 이미 <em>매우 + 저수준</em>으로 정의되있기 때문에 보통 더 낮은 모듈이 + 없다. 그러므로 + <directive>AuthzDefaultAuthoritative</directive>를 + 기본값(<code>On</code>)으로 남겨둬야 한다.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_groupfile.xml.ko b/docs/manual/mod/mod_authz_groupfile.xml.ko new file mode 100644 index 0000000000..6b7774ff49 --- /dev/null +++ b/docs/manual/mod/mod_authz_groupfile.xml.ko @@ -0,0 +1,105 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.7 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_groupfile.xml.meta"> + +<name>mod_authz_groupfile</name> +<description>일반 문자파일을 이용한 그룹 권한부여</description> +<status>Base</status> +<sourcefile>mod_authz_groupfile.c</sourcefile> +<identifier>authz_groupfile_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 인증한 사용자의 그룹권한으로 웹사이트의 일부를 + 접근할 수 있는지 결정하여 권한부여를 한다. + <module>mod_authz_dbm</module>과 기능이 비슷하다.</p> +</summary> + +<seealso><directive module="core">Require</directive></seealso> +<seealso><directive module="core">Satisfy</directive></seealso> + +<directivesynopsis> +<name>AuthGroupFile</name> +<description>인증에 사용할 사용자 그룹 목록을 저장하는 문자파일명을 +지정한다</description> +<syntax>AuthGroupFile <var>file-path</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthGroupFile</directive> 지시어는 사용자 + 인증에 사용할 사용자 그룹 목록을 저장하는 문자파일명을 + 지정한다. <var>File-path</var>는 그룹파일 경로이다. 절대경로를 + 사용하지 않으면 <directive + module="core">ServerRoot</directive>의 상대경로로 받아들인다.</p> + + <p>그룹파일의 각 줄에는 그룹명, 콜론, 공백으로 구분한 + 사용자명들이 순서대로 나온다.</p> + + <example><title>예제:</title> + mygroup: bob joe anne + </example> + + <p>많은 그룹을 저장한 큰 문자파일을 검색하는 것은 <em>매우</em> + 비효율적임을 주의하라. <directive module="mod_authz_dbm" + >AuthDBMGroupFile</directive>이 더 성능이 좋다.</p> + + <note type="warning"><title>보안</title> + <p><directive>AuthGroupFile</directive>이 웹서버의 문서들 + 밖에 위치함을 확인하라. 이 파일을 보호할 디렉토리 안에 + 같이 두지 <em>마라</em>. 그렇지 않으면, 클라이언트가 + <directive>AuthGroupFile</directive>을 다운로드할 수 있다.</p> + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthzGroupFileAuthoritative</name> +<description>권한부여를 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthzGroupFileAuthoritative On|Off</syntax> +<default>AuthzGroupFileAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthzGroupFileAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 해당 사용자 아이디에 대한 + <strong>그룹이 없는</strong> 경우 그룹 권한부여를 + (<code>modules.c</code> 파일에서 정의한) 저수준 모듈로 + 넘겨준다.</p> + + <p>기본적으로 제어를 넘기지않고, 모르는 그룹의 경우 인증 + 필요 응답을 한다. 이 지시어를 설정하지않으면 시스템이 안전하게 + 유지되며, NCSA 웹서버와 같이 동작한다.</p> + + <note type="warning"><title>보안</title> + <p>사용자가 자신의 .htaccess 파일을 사용하게 되는지 살펴보고, + 이런 행동을 허용할지 결정하라. 일반적으로 여러가지 방법으로 + 접근할 수 있는 데이터베이스를 보호하는 것보다 하나의 + <code>.htpasswd</code> 파일을 보호하는 것이 더 쉽다.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_host.xml.ko b/docs/manual/mod/mod_authz_host.xml.ko new file mode 100644 index 0000000000..4924034342 --- /dev/null +++ b/docs/manual/mod/mod_authz_host.xml.ko @@ -0,0 +1,312 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.9 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_host.xml.meta"> + +<name>mod_authz_host</name> +<description>호스트 (이름이나 IP 주소)를 사용한 그룹 권한부여</description> +<status>Base</status> +<sourcefile>mod_authz_host.c</sourcefile> +<identifier>authz_host_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p><directive module="core" type="section">Directory</directive>, + <directive module="core" type="section">Files</directive>, + <directive module="core" type="section">Location</directive> + 섹션과 <code><a href="core.html#accessfilename">.htaccess</a></code> + 파일에서 서버의 특정 부분의 접근을 제어하기위해 + <module>mod_authz_host</module>가 제공하는 지시어를 사용한다. + 클라이언트의 호스트명, IP 주소, <a + href="../env.html">환경변수</a>에 기록된 요청의 특성에 따라 + 접근을 제어한다. <directive + module="mod_authz_host">Allow</directive>와 <directive + module="mod_authz_host">Deny</directive> 지시어는 어떤 + 클라이언트가 서버에 접근할 수 있는지를 지시하고, <directive + module="mod_authz_host">Order</directive> 지시어는 기본적으로 + 접근을 허용할지 거부할지 여부와 어떻게 <directive + module="mod_authz_host">Allow</directive> 지시어와 <directive + module="mod_authz_host">Deny</directive> 지시어가 서로 영향을 + 미치는지 결정한다.</p> + + <p>호스트기반 접근제한과 암호기반 인증을 동시에 사용할 수도 + 있다. 이 경우 <directive module="core">Satisfy</directive> + 지시어를 사용하여 어떻게 두 제한이 서로 영향을 미치는지 + 결정한다.</p> + + <p>일반적으로 접근제한 지시어는 (<code>GET</code>, + <code>PUT</code>, <code>POST</code> 등) 모든 메서드에 적용되며, + 이 행동은 대부분의 경우 바람직하다. 그러나 <directive + module="core" type="section">Limit</directive> 섹션안에 + 지시어를 사용하여 특정 메서드에만 제한할 수 있다.</p> +</summary> + +<seealso><directive module="core">Satisfy</directive></seealso> +<seealso><directive module="core">Require</directive></seealso> + +<directivesynopsis> +<name>Allow</name> +<description>서버의 일부에 접근할 수 있는 호스트를 지정한다</description> +<syntax> Allow from all|<var>host</var>|env=<var>env-variable</var> +[<var>host</var>|env=<var>env-variable</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + <p><directive>Allow</directive> 지시어는 어떤 호스트가 서버의 + 일부에 접근할 수 있는지 지시한다. 호스트명, IP 주소, IP + 주소영역, 환경변수에 기록된 다른 특성에 따라 접근을 조절할 + 수 있다.</p> + + <p>이 지시어의 첫번째 아규먼트는 항상 <code>from</code>이다. + 다음 아규먼트에는 세가지 형식이 있다. <code>Allow from all</code>을 + 사용하면, 아래에서 설명할 <directive + module="mod_authz_host">Deny</directive>와 <directive + module="mod_authz_host">Order</directive> 지시어 설정에 + 따라 모든 호스트의 접근을 허가한다. 특정 호스트만 서버로 + 접근을 허용하려면 다음과 같은 형식으로 <em>host</em>를 지시할 + 수 있다:</p> + + <dl> + <dt>호스트명 (일부)</dt> + + <dd> + <example><title>예제:</title> + Allow from apache.org + </example> + <p>호스트명이 이 문자열과 같거나 이 문자열로 끝나면 접근을 + 허용한다. 그래서 이 경우 <code>foo.apache.org</code>는 + 해당되고, <code>fooapache.org</code>는 해당되지 않는다. + 이 설정을 사용하면 아파치는 <directive + module="core">HostnameLookups</directive> 지시어 설정과 + 관계없이 클라이언트 IP 주소를 가지고 중복-역 DNS 검색을 + 한다. 즉, 호스트명을 찾기위해 IP 주소를 역DNS 검색을 한 + 후, 다시 호스트명으로 검색하여 원래 IP 주소와 일치하는지 + 확인한다. 결과가 같고 호스트명이 설정값에 해당하면, 접근을 + 허용한다.</p></dd> + + <dt>IP 주소 전체</dt> + + <dd> + <example><title>예제:</title> + Allow from 10.1.2.3 + </example> + <p>접근을 허가하는 호스트의 IP 주소</p></dd> + + <dt>IP 주소 일부</dt> + + <dd> + <example><title>예제:</title> + Allow from 10.1 + </example> + <p>서브네트워크로 제한하기위해 IP 주소 앞의 1에서 3 + 바이트.</p></dd> + + <dt>네트워크/넷매스크 쌍</dt> + + <dd> + <example><title>예제:</title> + Allow from 10.1.0.0/255.255.0.0 + </example> + <p>네트워크 a.b.c.d와 넷매스크 w.x.y.z. 더 세밀하게 + 서브네트워크로 제한할때 사용한다.</p></dd> + + <dt>네트워크/nnn CIDR 규약</dt> + + <dd> + <example><title>예제:</title> + Allow from 10.1.0.0/16 + </example> + <p>앞의 경우와 같지만, 상위 nnn개 비트 값이 1인 넷매스크를 + 사용한다.</p></dd> + </dl> + + <p>마지막 세가지 예는 정확히 동일한 호스트들을 지칭한다.</p> + + <p>다음과 같이 IPv6 주소와 IPv6 서브네트워크를 지정할 수도 + 있다:</p> + + <example> + Allow from fe80::a00:20ff:fea7:ccea<br /> + Allow from fe80::a00:20ff:fea7:ccea/10 + </example> + + <p><directive>Allow</directive> 지시어 아규먼트의 세번째 + 형식은 <a href="../env.html">환경변수</a> 유무에 따라 접근을 + 제어한다. <code>Allow from env=<var>env-variable</var></code>을 + 사용하면, <var>env-variable</var> 환경변수가 정의된 경우 + 접근을 허가한다. <module>mod_setenvif</module>가 제공하는 + 지시어를 사용하여 클라이언트 요청의 특성에 따라 자유롭게 + 환경변수를 설정할 수 있다. 그러므로 이 지시어를 사용하여 + 클라이언트 <code>User-Agent</code> (브라우저 종류), + <code>Referer</code>, 다른 HTTP 요청 헤더에 따라 접근을 + 허가할 수 있다.</p> + + <example><title>예제:</title> + SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in<br /> + <Directory /docroot><br /> + <indent> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from env=let_me_in<br /> + </indent> + </Directory> + </example> + + <p>이 경우 user-agent 문자열이 <code>KnockKnock/2.0</code>으로 + 시작하는 브라우저의 접근은 허용하고, 나머지는 모두 거부한다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Deny</name> +<description>서버 접근을 거부할 호스트를 지정한다</description> +<syntax> Deny from all|<var>host</var>|env=<var>env-variable</var> +[<var>host</var>|env=<var>env-variable</var>] ...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + <p>이 지시어를 사용하여 호스트명, IP 주소, 환경변수에 따라 + 서버 접근을 제한할 수 있다. <directive>Deny</directive> + 지시어의 아규먼트는 <directive + module="mod_authz_host">Allow</directive> 지시어와 동일하다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Order</name> +<description>기본적으로 접근을 허용할지 거부할지 여부와 +<directive>Allow</directive>와 <directive>Deny</directive> +처리순서를 정한다.</description> +<syntax> Order <var>ordering</var></syntax> +<default>Order Deny,Allow</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>Limit</override> + +<usage> + <p><directive>Order</directive> 지시어는 기본적으로 접근을 + 허용할지 거부할지 여부와 <directive + module="mod_authz_host">Allow</directive>와 <directive + module="mod_authz_host">Deny</directive> 지시어 처리순서를 + 정한다. <var>ordering</var>은 다음 중 하나이다</p> + + <dl> + <dt><code>Deny,Allow</code></dt> + + <dd><directive module="mod_authz_host">Deny</directive> + 지시어를 <directive module="mod_authz_host">Allow</directive> + 지시어 보다 먼저 살펴본다. 그리고 기본적으로 접근을 허용한다. + <directive module="mod_authz_host">Deny</directive>나 + <directive module="mod_authz_host">Allow</directive> 지시어에 + 해당되지 않는 클라이언트의 접근을 허용한다.</dd> + + <dt><code>Allow,Deny</code></dt> + + <dd><directive module="mod_authz_host">Allow</directive> + 지시어를 <directive + module="mod_authz_host">Deny</directive> 지시어 보다 먼저 + 살펴본다. 그리고 기본적으로 접근을 허용하지 않는다. + <directive module="mod_authz_host">Deny</directive>나 + <directive module="mod_authz_host">Allow</directive> 지시어에 + 해당되지 않는 클라이언트의 접근을 거부한다.</dd> + + <dt><code>Mutual-failure</code></dt> + + <dd><directive module="mod_authz_host">Deny</directive> + 목록에는 안나오고 <directive + module="mod_authz_host">Allow</directive> 목록에만 나오는 + 호스트만 접근을 허용한다. <code>Order Allow,Deny</code>와 + 같은 일을 하기때문에 사용하지 않는다.</dd> + </dl> + + <p>키워드는 쉼표로만 구분한다; 사이에 <em>공백이 있으면 + 안된다.</em> 모든 경우 <directive + module="mod_authz_host">Allow</directive>와 <directive + module="mod_authz_host">Deny</directive> 모두 살펴봄을 + 명심하라.</p> + + <p>아래 예에서 apache.org 도메인의 모든 호스트의 접근은 + 허용하지만, 다른 호스트는 모두 거부한다.</p> + + <example> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from apache.org + </example> + + <p>아래 예에서 foo.apache.org 하위도메인에 있는 호스트만 + 거부하고, apache.org 도메인에 있는 호스트는 모두 접근을 + 허용한다. 기본적으로 접근을 거부하기때문에 apache.org 도메인에 + 속하지 않는 호스트는 접근을 거부한다.</p> + + <example> + Order Allow,Deny<br /> + Allow from apache.org<br /> + Deny from foo.apache.org + </example> + + <p>반대로 위의 <directive>Order</directive>를 + <code>Deny,Allow</code>로 변경하면, 모든 호스트의 접근을 + 허용한다. 설정파일에서 지시어가 나오는 순서와 관계없이 + <code>Allow from apache.org</code>를 제일 마지막에 처리하여 + <code>Deny from foo.apache.org</code>의 효과를 무시하기 + 때문이다. 또, 기본적으로 접근을 <em>허가</em>하므로 + <code>apache.org</code> 도메인에 속하지 않는 호스트도 모두 + 접근을 허가한다.</p> + + <p><directive>Order</directive> 지시어는 기본적으로 접근을 + 허용할지 거부할지를 정하기때문에 <directive + module="mod_authz_host">Allow</directive>나 <directive + module="mod_authz_host">Deny</directive> 지시어를 사용하지 + 않아도 접근가능 여부에 영향을 준다. 예를 들어,</p> + + <example> + <Directory /www><br /> + <indent> + Order Allow,Deny<br /> + </indent> + </Directory> + </example> + + <p>는 기본적으로 접근을 <em>거부</em>하기때문에 + <code>/www</code> 디렉토리에 대한 모든 접근을 거부한다.</p> + + <p><directive>Order</directive> 지시어가 정하는 접근 지시어 + 처리순서는 해당 서버설정 처리단계에만 영향을 준다. 즉, + <directive>Order</directive> 지시어 설정과 관계없이 <directive + module="core" type="section">Location</directive> 섹션 안에 + 있는 <directive module="mod_authz_host">Allow</directive>나 + <directive module="mod_authz_host">Deny</directive> 지시어는 + <directive module="core" type="section">Directory</directive> + 섹션이나 <code>.htaccess</code> 파일에 있는 <directive + module="mod_authz_host">Allow</directive>와 <directive + module="mod_authz_host">Deny</directive> 지시어를 모두 처리한 + 후에 처리한다. 설정 섹션들이 결합하는 방법에 대해서는 <a + href="../sections.html">어떻게 Directory, Location, Files + 섹션이 동작하나</a> 문서를 참고하라.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_owner.xml.ko b/docs/manual/mod/mod_authz_owner.xml.ko new file mode 100644 index 0000000000..d2850c0daf --- /dev/null +++ b/docs/manual/mod/mod_authz_owner.xml.ko @@ -0,0 +1,165 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.5 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_owner.xml.meta"> + +<name>mod_authz_owner</name> +<description>파일 소유자를 이용한 권한부여</description> +<status>Extension</status> +<sourcefile>mod_authz_owner.c</sourcefile> +<identifier>authz_owner_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 HTTP 인증에 사용한 사용자 아이디(웹 사용자 + 아이디)를 요청한 파일의 파일시스템 소유자/그룹과 비교하여 + 파일의 접근권한을 부여한다. 여기서 사용자명과 암호는 이미 + <module>mod_auth_basic</module>이나 + <module>mod_auth_digest</module> 같은 인증모듈의 확인을 + 거쳤다. <module>mod_authz_owner</module>는 <directive + module="core">Require</directive> 지시어의 다음 두 아규먼트, + <code>file-owner</code>와 <code>file-group</code>을 처리한다:</p> + + <dl> + <dt><code>file-owner</code></dt> + <dd>웹 사용자명이 요청한 파일 소유자의 시스템 이름과 같아야 + 한다. 즉, 운영체제가 요청한 파일의 소유자가 + <code>jones</code>라면, 웹을 통해 파일에 접근하는 사용자도 + 마찬가지로 <code>jones</code>이어야 한다.</dd> + + <dt><code>file-group</code></dt> + <dd>파일을 소유한 시스템 그룹명이 + <module>mod_authz_groupfile</module>이나 + <module>mod_authz_dbm</module>과 같은 그룹 데이터베이스에 + 있고, 웹 사용자명이 해당 그룹에 속해야 한다. 예를 들어, + 운영체제가 요청한 파일을 <code>accounts</code> (시스템) + 그룹이 소유하고 있다면, 그룹 데이터베이스에 + <code>accounts</code>라는 그룹이 있고 요청에 사용한 웹 + 사용자명이 그 그룹에 속해야 한다.</dd> + </dl> + + <note><title>주의</title> + <p><module>mod_authz_owner</module>가 실제로 파일시스템에 + 있지 않는 자원을 (<em>즉,</em> 가상 자원) 권한부여한다면, + 접근을 거부한다.</p> + + <p>특히 <a + href="../content-negotiation.html#multiviews">내용협상한 + "MultiViews"</a> 자원을 권한부여하지 않는다.</p> + </note> +</summary> +<seealso><directive module="core">Require</directive></seealso> +<seealso><directive module="core">Satisfy</directive></seealso> + +<section id="examples"><title>설정 예제</title> + + <section id="examples.file-owner"><title>Require file-owner</title> + <p>아파치 웹서버를 운영하는 다중사용자 시스템에서 각 사용자가 + <code>~/public_html/private</code>에 자신의 파일을 저장한다고 + 가정하자. 모든 웹 사용자명을 저장하는 <directive + module="mod_authn_dbm">AuthDBMUserFile</directive> + 데이터베이스가 있고, 여기에 저장된 사용자명은 서버에서 + 실제 파일을 소유하는 시스템 사용자명과 동일하다. 이 경우 + 아래 설정은 파일 소유자에게만 접근을 허용한다. 사용자 + <code>jones</code>는 파일을 <code>jones</code>가 아닌 + <code>smith</code>가 소유하고 있는 한 + <code>/home/smith/public_html/private</code>에 있는 파일에 + 접근할 수 없다.</p> + + <example> + <Directory /home/*/public_html/private><br /> + <indent> + AuthType Basic<br /> + AuthName MyPrivateFiles<br /> + AuthBasicProvider dbm<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + Satisfy All<br /> + Require file-owner<br /> + </indent> + </Directory> + </example> + </section> + + <section id="examples.file-group"><title>Require file-group</title> + <p>위와 상황이 비슷하지만 여러명이 + <code>~/public_html/project-foo</code>에 프로젝트 파일을 + 공유한다고 가정하자. 파일들은 시스템 그룹 <code>foo</code>가 + 소유하며, 모든 웹 사용자명과 사용자 그룹을 기록하는 <directive + module="mod_authz_dbm">AuthDBMGroupFile</directive> + 데이터베이스가 있다. <em>즉,</em> 최소한 <code>foo</code>라는 + 그룹에 구성원이 있다. <code>jones</code>와 + <code>smith</code>가 모두 그룹 <code>foo</code>의 + 구성원이라면, 둘 모두 <code>project-foo</code> 디렉토리에 + 접근할 수 있다.</p> + + <example> + <Directory /home/*/public_html/project-foo><br /> + <indent> + AuthType Basic<br /> + AuthName "Project Foo Files"<br /> + AuthBasicProvider dbm<br /> + <br /> + # combined user/group database<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all<br /> + <br /> + Satisfy All<br /> + Require file-group<br /> + </indent> + </Directory> + </example> + </section> +</section> + +<directivesynopsis> +<name>AuthzOwnerAuthoritative</name> +<description>권한부여를 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthzOwnerAuthoritative On|Off</syntax> +<default>AuthzOwnerAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthzOwnerAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 다음과 같은 경우 사용자 + 권한부여를 (<code>modules.c</code> 파일에서 정의한) 저수준 + 모듈로 넘겨준다.</p> + + <ul> + <li><code>file-owner</code>를 사용하면 파일시스템 소유자를 + 알 수 없거나 주어진 웹 사용자명과 다른 경우</li> + + <li><code>file-group</code>을 사용하면 파일시스템 그룹을 + 알 수 없거나 주어진 웹 사용자명이 구성원이 아닌 경우.</li> + </ul> + + <p>또, 값을 <code>Off</code>로 설정하면 + <code>file-owner</code>와 <code>file-group</code>을 결합하여, + 둘 중 하나만 만족해도 접근을 허가한다.</p> + + <p>기본적으로 제어를 넘기지않고, 모르는 그룹의 경우 인증 + 필요 응답을 한다. 이 지시어를 <code>Off</code>로 설정하지않으면 + 시스템이 안전하게 유지되며, NCSA 웹서버와 같이 동작한다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_user.xml.ko b/docs/manual/mod/mod_authz_user.xml.ko new file mode 100644 index 0000000000..3f703b1fbb --- /dev/null +++ b/docs/manual/mod/mod_authz_user.xml.ko @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.4 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_authz_user.xml.meta"> + +<name>mod_authz_user</name> +<description>사용자 권한부여</description> +<status>Base</status> +<sourcefile>mod_authz_user.c</sourcefile> +<identifier>authz_user_module</identifier> +<compatibility>아파치 2.1 이후부터</compatibility> + +<summary> + <p>이 모듈은 권한을 부여하여, 인증한 사용자가 웹사이트의 + 일부에 접근할 수 있는지 결정한다. + <module>mod_authz_user</module>는 <code>Require user</code> + 지시어 목록에 인증한 사용자가 들어있으면 접근을 허용한다. + 또, <code>require valid-user</code>는 성공적으로 인증한 + 사용자 모두에게 접근을 허용한다.</p> +</summary> +<seealso><directive module="core">Require</directive></seealso> +<seealso><directive module="core">Satisfy</directive></seealso> + +<directivesynopsis> +<name>AuthzUserAuthoritative</name> +<description>권한부여를 저수준 모듈로 넘겨줄지 여부</description> +<syntax>AuthzUserAuthoritative On|Off</syntax> +<default>AuthzUserAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p><directive>AuthzUserAuthoritative</directive> 지시어를 + 직접 <code>Off</code>로 설정하면 해당 <strong>사용자가 + 없는</strong> 경우 사용자 권한부여를 (<code>modules.c</code> + 파일에서 정의한) 저수준 모듈로 넘겨준다.</p> + + <p>기본적으로 제어를 넘기지않고, 모르는 사용자의 경우 인증 + 필요 응답을 한다. 이 지시어를 <code>Off</code>로 설정하지않으면 + 시스템이 안전하게 유지되며, NCSA 웹서버와 같이 동작한다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_example.xml.ko b/docs/manual/mod/mod_example.xml.ko new file mode 100644 index 0000000000..0ab612d43f --- /dev/null +++ b/docs/manual/mod/mod_example.xml.ko @@ -0,0 +1,137 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.7 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_example.xml.meta"> + +<name>mod_example</name> +<description>아파치 모듈 API를 설명한다</description> +<status>Experimental</status> +<sourcefile>mod_example.c</sourcefile> +<identifier>example_module</identifier> + +<summary> + <p>아파치 배포본 <code>modules/experimental</code> 디렉토리에 + 있는 파일들은 아파치 API를 사용하여 모듈을 작성하려는 사람들을 + 돕기위한 예제다.</p> + + <p><code>mod_example.c</code>는 모든 콜백(callback) 구조와 + 호출 문법을 설명하는 파일이다. 당신은 모듈에 이 모든 콜백을 + 구현할 필요가 없다. 사실 정반대다!</p> + + <p>example 모듈은 실제로 동작하는 모듈이다. 이 모듈을 서버에 + 연결하고 특정 위치에 "example-handler" 핸들러를 할당하여 + 그곳을 브라우징하면 example 모듈의 여러 콜백을 확인할 수 + 있다.</p> +</summary> + +<section id="compiling"><title>example 모듈 컴파일하기</title> + + <p>서버에 example 모듈을 포함하려면 다음 과정을 거친다:</p> + + <ol> + <li> + <code>--enable-example</code> 옵션과 함께 + <code>configure</code>를 실행한다.</li> + + <li>서버를 컴파일한다 ("<code>make</code>"를 실행한다).</li> + </ol> + + <p>자신이 만든 모듈을 추가하려면:</p> + + <ol type="A"> + <li><code>cp modules/experimental/mod_example.c + modules/new_module/<em>mod_myexample.c</em></code></li> + + <li>파일을 수정한다.</li> + + <li><code>modules/new_module/config.m4</code> 파일을 만든다. + <ol> + <li><code>APACHE_MODPATH_INIT(new_module)</code>을 + 추가한다.</li> + <li><code>modules/experimental/config.m4</code> 파일에서 + "example"이 있는 APACHE_MODULE 줄을 복사해온다.</li> + <li>첫번째 아규먼트 "example"을 <em>myexample</em>로 + 변경한다.</li> + <li>두번째 아규먼트 자리에 자신이 만든 모듈에 대한 + 간단한 설명을 적는다. <code>configure --help</code>를 + 실행하면 여기에 기록한 설명을 보여준다.</li> + <li>모듈을 컴파일할때 특별한 C 컴파일러 옵션, 링커 + 옵션, 라이브러리가 필요하면 각각 CFLAGS, LDFLAGS, + LIBS에 추가한다. modules 디렉토리에 있는 다른 + <code>config.m4</code> 파일들을 참고하라.</li> + <li><code>APACHE_MODPATH_FINISH</code>를 추가한다.</li> + </ol> + </li> + + <li><code>module/new_module/Makefile.in</code> 파일을 + 만든다. 모듈을 컴파일하는데 특별한 명령어가 필요없다면, + 파일에 <code>include $(top_srcdir)/build/special.mk</code>만 + 있어도 된다.</li> + + <li>최상위 디렉토리에서 ./buildconf 를 실행한다.</li> + + <li>--enable-myexample 옵션을 사용하여 서버를 컴파일한다</li> + + </ol> +</section> + +<section id="using"><title><code>mod_example</code> 모듈 사용하기</title> + + <p>example 모듈을 사용하려면 <code>httpd.conf</code> 파일에 + 다음과 같은 설정을 추가하라:</p> +<example> + <Location /example-info><br /> + SetHandler example-handler<br /> + </Location> +</example> + + <p>아니면 <a + href="core.html#accessfilename"><code>.htaccess</code></a> + 파일에 다음과 같은 내용을 추가하고, 그 위치에서 "test.example" + 같은 파일을 요청하라:</p> +<example> + AddHandler example-handler .example +</example> + + <p>서버를 재시작한 후 이 위치를 브라우징하면 앞에서 말한 + 내용을 보게될 것이다.</p> +</section> + +<directivesynopsis> +<name>Example</name> +<description>아파치 모듈 API를 설명하기위한 예제 지시어</description> +<syntax>Example</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> + +<usage> + <p><directive>Example</directive> 지시어는 example 모듈의 + 내용핸들러가 간단한 문구를 보일지 여부를 설정한다. 이 지시어는 + 아규먼트를 받지않는다. example 내용핸들러를 적용한 URL에 + 접속하면 문서 요청을 서비스하기위해 모듈안에 함수들이 어떻게 + 그리고 어떤 순서로 불리는지 알 수 있다. 이 지시어의 효과는 + "<code>Example directive declared here: YES/NO</code>"로 + 확인할 수 있다.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_expires.xml.ko b/docs/manual/mod/mod_expires.xml.ko new file mode 100644 index 0000000000..61913ee08c --- /dev/null +++ b/docs/manual/mod/mod_expires.xml.ko @@ -0,0 +1,199 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.6 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_expires.xml.meta"> + +<name>mod_expires</name> +<description>사용자가 지정한 기준에 따라 <code>Expires</code> +HTTP 헤더를 생성한다</description> +<status>Extension</status> +<sourcefile>mod_expires.c</sourcefile> +<identifier>expires_module</identifier> + +<summary> + <p>이 모듈은 서버 응답의 <code>Expires</code> HTTP 헤더 + 설정을 조절한다. 만기일을 소스파일이 마직막 수정될 시간 + 혹은 클라이언트가 접속한 시간에 상대적으로 설정할 수 있다.</p> + + <p><code>Expires</code> HTTP 헤더는 클라이언트에게 문서의 + 유효성과 지속성을 알려준다. 이 시간이 아직 지나지않았다면, + 문서를 캐쉬에서 가져와도 된다. 만기일이 지났다면 캐쉬된 + 것을 "만료되고" 유효하지 않다고 간주하여, 소스에서 문서를 + 새로 얻어와야 한다.</p> +</summary> + +<section id="AltSyn"><title>다른 내부 문법</title> + <p><directive module="mod_expires">ExpiresDefault</directive>와 + <directive module="mod_expires">ExpiresByType</directive> + 지시어를 더 읽기 좋은 형식으로 기술할 수 있다:</p> + + <example> + ExpiresDefault "<base> [plus] {<num> + <type>}*"<br /> + ExpiresByType type/encoding "<base> [plus] + {<num> <type>}*" + </example> + + <p><base>는 다음중 하나이다:</p> + + <ul> + <li><code>access</code></li> + + <li><code>now</code> ('<code>access</code>'와 같음)</li> + + <li><code>modification</code></li> + </ul> + + <p><code>plus</code> 키워드는 없어도 된다. <num>은 + [<code>atoi()</code>에 사용할 수 있는] 정수값이다. + <type>은 다음중 하나이다:</p> + + <ul> + <li><code>years</code></li> + <li><code>months</code></li> + <li><code>weeks</code></li> + <li><code>days</code></li> + <li><code>hours</code></li> + <li><code>minutes</code></li> + <li><code>seconds</code></li> + </ul> + + <p>예를 들어, 다음 모두는 문서가 기본적으로 접속된지 1달후에 + 만기된다고 설정한다:</p> + + <example> + ExpiresDefault "access plus 1 month"<br /> + ExpiresDefault "access plus 4 weeks"<br /> + ExpiresDefault "access plus 30 days" + </example> + + <p>'<num> <type>' 구문을 반복해서 사용하여 + 만기시간을 자세히 설정할 수 있다:</p> + + <example> + ExpiresByType text/html "access plus 1 month 15 + days 2 hours"<br /> + ExpiresByType image/gif "modification plus 5 hours 3 + minutes" + </example> + + <p>만약 수정시간(modification)을 기준으로 만기시간을 설정하는 + 경우 내용을 디스크에 있는 파일에서 가져오지 않는다면 Expires + 헤더를 붙이지 <strong>않는다</strong>. 이 경우 내용에 수정시간이 + 없기 때문이다.</p> +</section> + +<directivesynopsis> +<name>ExpiresActive</name> +<description><code>Expires</code> 헤더를 생성한다</description> +<syntax>ExpiresActive On|Off</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>이 지시어는 해당 영역에 대해 (즉, <code>.htaccess</code> + 파일에서 사용한다면 그 디렉토리 아래에 있는 문서들만 해당된다.) + <code>Expires</code> 헤더를 생성할지 유무를 결정한다. + (<code>.htaccess</code> 파일 등으로 더 하위 단계에서 서버설정을 + 변경하지않는 한) <code>Off</code>이면 해당 영역에 있는 + 문서에 <code>Expires</code> 헤더를 생성하지 않는다. + <code>On</code>이면 <directive + module="mod_expires">ExpiresByType</directive>과 <directive + module="mod_expires">ExpiresDefault</directive> 지시어로 + (<em>해당 항목을 참고하라</em>) 지정한 규칙에 따라 서비스하려는 + 문서에 헤더를 생성한다.</p> + + <p>이 지시어는 <code>Expires</code> 헤더를 보장하지 않는다. + 규칙에 해당하지 않다면 마치 이 지시어가 없는 것처럼 헤더를 + 만들지 않는다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ExpiresByType</name> +<description>MIME type으로 <code>Expires</code> 헤더값을 설정한다</description> +<syntax>ExpiresByType <var>MIME-type</var> +<var><code>seconds</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>이 지시어는 특정 종류의 (<em>에를 들어</em>, + <code>text/html</code>) 문서에 대한 <code>Expires</code> + 헤더값을 정의한다. 두번째 아규먼트는 만기시간을 결정할때 + 기준 시간에 더할 초단위 값을 지정한다.</p> + + <p>기준 시간은 파일의 최근 수정시간 혹은 클라이언트가 문서에 + 접근한 시간이다. 이떤 것을 사용할지는 + <code><var><code></var></code> 필드로 결정해야 한다. + <code>M</code>은 기준 시간으로 파일의 최근 수정시간을 + 사용하고, <code>A</code>는 클라이언트의 접근 시간을 사용한다.</p> + + <p>차이는 미묘하다. <code>M</code>을 사용하면 캐쉬에 있는 + 모든 복사본이 같은 시간에 만료된다. 그래서 항상 같은 URL로 + 찾아볼 수 있는 주간일정 같은 용도에 좋다. <code>A</code>를 + 사용하면 복사본의 만기시간이 각각 다르다. 이는 자주 수정되지않는 + 그림파일에, 특히 여러 문서에서 같은 그림을 참조할때 (<em>예를 + 들어</em>, 이미지는 상대적으로 짧은 기간동안 반복해서 접근된다), + 유용하다.</p> + + <example><title>예제:</title> + # 만기헤더를 사용한다<br /> + ExpiresActive On<br /> + # 클라이언트 캐쉬의 GIF 그림은 한 달후에 만기한다<br /> + ExpiresByType image/gif A2592000<br /> + # HTML 문서는 변경후 일주일간 유효하다 + ExpiresByType text/html M604800 + </example> + + <p>이 지시어는 <code>ExpiresActive On</code>을 사용할때만 + 유효함을 주의하라. <directive + module="mod_expires">ExpiresDefault</directive> 지시어를 + 사용하여 특정 MIME type에 대해서<em>만</em> 만기시간을 + 설정할 수 있다.</p> + + <p>앞에서 설명한 <a href="#AltSyn">다른 문법</a>을 사용하여 + 만기시간을 계산할 수도 있다.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ExpiresDefault</name> +<description>만기시간을 계산하는 기본 알고리즘</description> +<syntax>ExpiresDefault <var><code>seconds</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>이 지시어는 해당 영역에 있는 모든 문서의 만기시간을 + 계산하는 기본 알고리즘을 지정한다. <directive + module="mod_expires">ExpiresByType</directive> 지시어를 + 사용하여 종류별로 설정할 수 있다. 아규먼트 문법에 대한 + 자세한 설명은 그 지시어와 <a href="#AltSyn">다른 문법</a>을 + 참고하라.</p> +</usage> +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_ext_filter.xml.ko b/docs/manual/mod/mod_ext_filter.xml.ko new file mode 100644 index 0000000000..60bf1ed90e --- /dev/null +++ b/docs/manual/mod/mod_ext_filter.xml.ko @@ -0,0 +1,329 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.15 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_ext_filter.xml.meta"> + +<name>mod_ext_filter</name> +<description>응답 내용을 외부 프로그램으로 처리한 후 클라이언트로 +보낸다</description> +<status>Extension</status> +<sourcefile>mod_ext_filter.c</sourcefile> +<identifier>ext_filter_module</identifier> + +<summary> + <p><module>mod_ext_filter</module>를 사용하면 간단하고 익숙한 + 방법으로 <a href="../filter.html">필터</a>를 만들 수 있다. + 표준입력에서 읽고 표준출력에 쓰는 프로그램(즉, 유닉스식 + 필터 명령어)을 아파치 필터로 사용할 수 있다. 이런 필터는 + 아파치 API로 쓰여지고 아파치 서버 프로세스 안에서 실행되는 + 필터에 비해 매우 느리지만, 다음과 같은 장점이 있다:</p> + + <ul> + <li>프로그래밍 모델이 매우 간단하다</li> + + <li>프로그램이 표준입력에서 읽고 표준출력에 쓸 수만 있다면 + 어떤 프로그래밍/스크립트 언어라도 사용할 수 있다</li> + + <li>이미 있는 프로그램을 수정없이 아파치 필터로 사용할 + 수 있다</li> + </ul> + + <p>실제 사용하기에는 성능이 떨어지지만, + <module>mod_ext_filter</module>를 사용하여 필터를 빨리 만들어볼 + 수 있다.</p> + +</summary> +<seealso><a href="../filter.html">필터</a></seealso> + +<section id="examples"><title>예제</title> + + <section><title>다른 type의 응답을 HTML로 만든다</title> + <example> + # mod_ext_filter 지시어를 가지고<br /> + # 외부 프로그램 /usr/bin/enscript를 사용하여<br /> + # 문서파일과 text/c 파일을 HTML로 만들고 결과의<br /> + # type을 text/html로 변경하는 필터를 정의한다<br /> + ExtFilterDefine c-to-html mode=output \<br /> + <indent> + intype=text/c outtype=text/html \<br /> + cmd="/usr/bin/enscript --color -W html -Ec -o - -"<br /> + </indent> + <br /> + <Directory "/export/home/trawick/apacheinst/htdocs/c"><br /> + <indent> + # 출력에 새로운 필터를 실행하는 core 지시어<br /> + SetOutputFilter c-to-html<br /> + <br /> + # .c 파일의 type을 text/c로 만드는 mod_mime<br /> + # 지시어<br /> + AddType text/c .c<br /> + <br /> + # 디버그 수준을 높여서 요청마다 현재 설정을<br /> + # 알려주는 로그문을 기록하는 mod_ext_filter<br /> + # 지시어<br /> + ExtFilterOptions DebugLevel=1<br /> + </indent> + </Directory> + </example> + </section> + + <section><title>content 인코딩 필터 구현하기</title> + <p>Note: 아래 gzip 예제는 단지 설명을 예로 든 것이다. + 실제 서비스에 사용하려면 <module>mod_deflate</module>를 + 참고하길 바란다.</p> + + <example> + # 외부 필터를 정의하는 mod_ext_filter 지시어<br /> + ExtFilterDefine gzip mode=output cmd=/bin/gzip<br /> + <br /> + <Location /gzipped><br /> + <indent> + # 출력할때 gzip 필터를 실행하는 core 지시어<br /> + SetOutputFilter gzip<br /> + <br /> + # "Content-Encoding: gzip" 헤더를 추가하는<br /> + # mod_header 지시어<br /> + Header set Content-Encoding gzip<br /> + </indent> + </Location> + </example> + </section> + + <section><title>서버를 느리게 하기</title> + <example> + # cat으로 모든 내용을 통과하는 필터를 정의하는<br /> + # mod_ext_filter 지시어; cat은 아무것도 수정하지<br /> + # 않는다; 단지 처리경로를 길게 하여 자원을 더 소모한다<br /> + ExtFilterDefine slowdown mode=output cmd=/bin/cat \<br /> + <indent> + preservescontentlength<br /> + </indent> + <br /> + <Location /><br /> + <indent> + # 출력할때 slowdown 필터를 여러번 실행하는 core 지시어<br /> + #<br /> + SetOutputFilter slowdown;slowdown;slowdown<br /> + </indent> + </Location> + </example> + </section> + + <section><title>sed를 사용하여 응답에서 글을 대체하기</title> + <example> + # 응답에서 글을 대체하는 필터를 정의하는<br /> + # mod_ext_filter 지시어<br /> + #<br /> + ExtFilterDefine fixtext mode=output intype=text/html \<br /> + <indent> + cmd="/bin/sed s/verdana/arial/g"<br /> + </indent> + <br /> + <Location /><br /> + <indent> + # 출력할때 fixtext 필터를 실행하는 core 지시어<br /> + SetOutputFilter fixtext<br /> + </indent> + </Location> + </example> + </section> + + <section><title>다른 필터를 추적하기</title> + <example> + # 압축 문제가 있는 특정 클라이언트(IP 192.168.1.31)에<br /> + # 대해 mod_deflate가 읽고 쓰는 자료를 추적한다.<br /> + # 이 필터는 mod_deflate로 보내기 전 자료를 추적한다.<br /> + ExtFilterDefine tracebefore \<br /> + <indent> + cmd="/bin/tracefilter.pl /tmp/tracebefore" \<br /> + EnableEnv=trace_this_client<br /> + </indent> + <br /> + # 이 필터는 mod_deflate에서 나오는 자료를 추적한다.<br /> + # ftype 파라미터를 사용하지않는 경우, 기본 필터형<br /> + # AP_FTYPE_RESOURCE는 필터 순서를 mod_deflate *이전에*<br /> + # 둔다. AP_FTYPE_CONTENT_SET 보다 조금 높은 숫자값을<br /> + # 지정하면 mod_deflate 이후에 실행한다.<br /> + ExtFilterDefine traceafter \<br /> + <indent> + cmd="/bin/tracefilter.pl /tmp/traceafter" \<br /> + EnableEnv=trace_this_client ftype=21<br /> + </indent> + <br /> + <Directory /usr/local/docs><br /> + <indent> + SetEnvIf Remote_Addr 192.168.1.31 trace_this_client<br /> + SetOutputFilter tracebefore;deflate;traceafter<br /> + </indent> + </Directory> + </example> + + <example><title>다음은 자료를 추적하는 필터이다:</title> + #!/usr/local/bin/perl -w<br /> + use strict;<br /> + <br /> + open(SAVE, ">$ARGV[0]")<br /> + <indent> + or die "can't open $ARGV[0]: $?";<br /> + </indent> + <br /> + while (<STDIN>) {<br /> + <indent> + print SAVE $_;<br /> + print $_;<br /> + </indent> + }<br /> + <br /> + close(SAVE); + </example> + </section> +</section> <!-- /Examples --> + +<directivesynopsis> +<name>ExtFilterDefine</name> +<description>외부 필터를 정의한다</description> +<syntax>ExtFilterDefine <var>filtername</var> <var>parameters</var></syntax> +<contextlist><context>server config</context></contextlist> + +<usage> + <p><directive>ExtFilterDefine</directive> 지시어는 외부 + 필터의 성질과 실행할 프로그램, 아규먼트를 정의한다.</p> + + <p><var>filtername</var>은 정의할 필터 이름을 지정한다. + 이 이름을 SetOutputFilter 지시어에서 사용한다. 등록한 모든 + 필터들간에 이름이 겹치면 안된다. <em>현재 필터등록 API는 + 오류를 보고하지 않는다. 그래서 사용자는 이름이 겹치는 문제를 + 알지 못한다.</em></p> + + <p>실행할 외부 명령어와 다른 성질을 정의하는 나머지 아규먼트는 + 어떤 순서로 나와도 가능하다. 단, <code>cmd=</code> 파라미터는 + 반드시 필요하다. 사용할 수 있는 파라미터는 다음과 같다:</p> + + <dl> + <dt><code>cmd=<var>cmdline</var></code></dt> + + <dd><code>cmd=</code> 키워드는 실행할 외부 명령어를 지정한다. + 프로그램명 뒤에 아규먼트가 있다면 명령행을 쌍따옴표로 + 묶어야 한다 (<em>예를 들어</em>, + <code>cmd="<var>/bin/mypgm</var> <var>arg1</var> + <var>arg2</var>"</code>). 쉘을 거치지않고 직접 프로그램을 + 실행하기때문에 일반적인 쉘 따옴표는 필요없다. 프로그램 + 아규먼트들은 공백으로 구분한다. 프로그램 아규먼트에 공백이 + 있다면 공백 앞에 백슬래쉬로 사용해야 한다. 백슬래쉬가 + 아규먼트의 일부라면 백슬래쉬를 두번 사용해야 한다. 프로그램을 + 실행할때 표준 CGI 환경변수와 추가로 DOCUMENT_URI, + DOCUMENT_PATH_INFO, QUERY_STRING_UNESCAPED 변수를 설정한다.</dd> + + <dt><code>mode=<var>mode</var></code></dt> + + <dd>응답을 처리하는 필터는 (기본값인) <code>mode=output</code>을 + 사용한다. 요청을 처리하는 필터는 <code>mode=input</code>을 + 사용한다. <code>mode=input</code>은 아파치 2.1에 추가되었다.</dd> + + <dt><code>intype=<var>imt</var></code></dt> + + <dd>이 파라미터는 필터로 처리할 문서의 인터넷 media + type(<em>즉</em>, MIME type)을 지정한다. 기본적으로 모든 + 문서를 필터로 처리한다. <code>intype=</code>을 지정하면 + 다른 type의 문서는 필터로 처리하지 않는다.</dd> + + <dt><code>outtype=<var>imt</var></code></dt> + + <dd>이 파라미터는 필터로 처리한 문서의 인터넷 media + type(<em>즉</em>, MIME type)을 지정한다. 필터처리 작업중에 + 인터넷 media type을 변경할때 유용하다. 기본적으로, 인터넷 + media type은 변하지 않는다.</dd> + + <dt><code>PreservesContentLength</code></dt> + + <dd><code>PreservesContentLength</code> 키워드는 필터가 + content length를 유지하도록 한다. 대부분의 필터가 content + length를 변경하므로 이 키워드는 기본값이 아니다. 필터가 + 길이를 유지할때만 이 키워드를 사용해야 한다.</dd> + + <dt><code>ftype=<var>filtertype</var></code></dt> + + <dd>이 파라미터는 필터 종류에 대한 숫자값을 지정한다. + 대부분의 경우 기본값인 AP_FTYPE_RESOURCE가 적당하다. + 필터를 실행하는 순서가 자원필터와 달라야하는 경우 이 + 파라미터가 필요하다. 적당한 값을 알려면 util_filter.h에 + 있는 AP_FTYPE_* 정의를 참고하라.</dd> + + <dt><code>disableenv=<var>env</var></code></dt> + + <dd>이 파라미터로 설정한 환경변수가 정의되었다면 필터를 + 사용하지 않는다.</dd> + + <dt><code>enableenv=<var>env</var></code></dt> + + <dd>이 파라미터로 설정한 환경변수가 정의된 경우 필터를 + 사용한다.</dd> + </dl> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ExtFilterOptions</name> +<description><module>mod_ext_filter</module> 옵션을 설정한다</description> +<syntax>ExtFilterOptions <var>option</var> [<var>option</var>] ...</syntax> +<default>ExtFilterOptions DebugLevel=0 NoLogStderr</default> +<contextlist><context>directory</context></contextlist> + +<usage> + <p><directive>ExtFilterOptions</directive> 지시어는 + <module>mod_ext_filter</module>의 특별한 처리옵션을 지정한다. + <var>Option</var>은 다음중 하나다.</p> + + <dl> + <dt><code>DebugLevel=<var>n</var></code></dt> + + <dd> + <code>DebugLevel</code> 키워드는 + <module>mod_ext_filter</module>가 기록하는 디버그 문구 + 수준을 정한다. 기본값은 디버그문을 기록하지 않는다. + 이는 <code>DebugLevel=0</code>과 같다. 높은 숫자를 + 사용할수록, 더 많은 디버그문이 기록되고 서버 성능이 + 떨어진다. 숫자값의 실제 의미는 <code>mod_ext_filter.c</code> + 앞부분에 있는 DBGLVL_ 상수 정의에 설명되있다. + + <p>주의: 필터 로그를 기록하려면 core 지시어 <directive + module="core">LogLevel</directive>을 사용하여 디버그문을 + 아파치 오류로그에 기록해야 한다.</p> + </dd> + + <dt><code>LogStderr | NoLogStderr</code></dt> + + <dd><code>LogStderr</code> 키워드는 외부 필터 프로그램이 + 표준오류로 출력하는 문구를 아파치 오류로그에 기록한다. + <code>NoLogStderr</code>는 이 기능을 하지 않는다.</dd> + </dl> + + <example><title>예제</title> + ExtFilterOptions LogStderr DebugLevel=0 + </example> + + <p>위의 설정을 사용하면 필터가 표준오류로 출력하는 문구를 + 아파치 오류로그에 기록하고, <module>mod_ext_filter</module>는 + 자체 디버그문을 기록하지 않는다. </p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_file_cache.xml.ko b/docs/manual/mod/mod_file_cache.xml.ko new file mode 100644 index 0000000000..0bbcc2a346 --- /dev/null +++ b/docs/manual/mod/mod_file_cache.xml.ko @@ -0,0 +1,193 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.6 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_file_cache.xml.meta"> + +<name>mod_file_cache</name> +<description>메모리에 정적 파일들을 캐쉬</description> +<status>Experimental</status> +<sourcefile>mod_file_cache.c</sourcefile> +<identifier>file_cache_module</identifier> + +<summary> + + <note type="warning"> + 이 모듈은 조심해서 사용해야 한다. <module>mod_file_cache</module>를 +사용하여 사이트를 망치기 쉬우므로 이 문제를 꼼꼼히 읽어라. + </note> + + <p>거의 변하지 않고 자주 요청되는 파일을 <em>캐쉬</em>에 저장하여 +서버 부하를 줄일 수 있다. <module>mod_file_cache</module>는 +두가지 방식으로 자주 요청되는 <em>정적</em> 파일을 캐쉬에 저장한다. +설정 지시어를 통해 <module>mod_file_cache</module>가 파일을 +열고(open) <code>mmap()</code>할지 파일을 미리 열고 +<em>파일 핸들러</em>를 저장할지 결정한다. 두 방식 모두 +파일을 서비스하기위한 작업의 일부를 ((특히 파일 입출력) 파일 요청때마다 +하는 대신 서버가 시작할때 하여 서버 부하를 감소한다.</p> + + <p>주의: 이 방법은 CGI 프로그램이나 특별한 내용핸들러를 통해 서비스하는 +파일의 속도를 향상할 수 없다. 이 방법은 보통 아파치 core 내용핸들러가 +서비스하는 일반파일에만 적용된다.</p> + + <p>이 모듈은 아파치 1.3의 <code>mod_mmap_static</code> 모듈의 +영향을 많이 받은 확장이다.</p> +</summary> + +<section id="using"><title>mod_file_cache 사용하기</title> + + <p><module>mod_file_cache</module>는 주서버 설정에서 +<directive module="mod_file_cache" + >MMapFile</directive>과 <directive module="mod_file_cache" + >CacheFile</directive> 지시어를 통해 설정한 정적 파일들을 +캐쉬에 저장한다.</p> + + <p>모든 플래폼이 두 지시어를 모두 지원하는 것은 아니다. +예를 들어, 윈도우즈용 아파치는 현재 <directive + module="mod_file_cache">MMapStatic</directive> 지시어를 +지원하지 않지만, AIX 같은 다른 플래폼은 둘 모두 지원한다. +지원하지않는 지시어를 사용할 경우 서버 오류 로그에 오류문을 +남긴다. 지원하지않는 지시어를 사용해도 서버는 시작하지만 +파일을 캐쉬에 저장하지 않는다. 두 지시어를 모두 지원하는 플래폼을 +사용한다면 어떤 방식이 더 좋은지 실험해볼 수 있다.</p> + + <section><title>MMapFile 지시어</title> + + <p><module>mod_file_cache</module>의 +<directive module="mod_file_cache">MMapFile</directive> 지시어는 +설정한 정적인 파일들을 <code>mmap()</code> 시스템호출을 사용하여 +메모리에 대응한다. 많은 최근 유닉스류 운영체제에 이 시스템호출이 +있지만, 없는 운영체제도 있다. 또, <code>mmap()</code>할 수 있는 +파일 크기와 개수를 시스템이 제한할 수 있으므로 실험해보는 것이 +좋다.</p> + + <p>서버가 시작할때와 재시작할때만 <code>mmap()</code>을 +한다. 그래서 파일시스템에서 해당 파일중 하나라도 변경된 경우 +서버를 재시작<em>해야</em> 한다 (<a + href="../stopping.html">Stopping and Restarting</a> 문서 참고). +다시 강조하면: 서버를 재시작하지않고 파일을 수정하면 +요청 서비스가 완전히 이상할 수 있다. 이전 파일을 지우고(unlink) +새로 파일을 만들어서 파일을 수정해야 한다. <code>rdist</code>나 +<code>mv</code>와 같이 많은 도구가 이런 식으로 동작한다. +매번 추가로 불필요한 <code>stat()</code> 검사가 필요하고 +입출력 감소의 의도에 반하므로 이 모듈은 파일 변화를 신경쓰지않는다.</p> + </section> + + <section><title>CacheFile 지시어</title> + + <p><module>mod_file_cache</module>의 +<directive module="mod_file_cache">CacheFile</directive> 지시어는 +설정 지시어에 열거한 +파일(과 파일들)의 <em>핸들(handle)</em> 혹은 +<em>파일 기술자(file descriptor)</em>를 열고(open) 캐쉬에 저장한다. +파일을 요청하면 서버는 캐쉬에서 핸들을 찾아서 소켓 API +<code>sendfile()</code>에 (윈도우즈에서는 <code>TransmitFile()</code>) +넘긴다.</p> + + <!-- XXX + <p>Insert more details about sendfile API...</p> + --> + + <p>서버가 시작할때와 재시작할때만 이런 파일핸들 캐쉬를 +만든다. ... +This file handle caching is done once at server start or + restart, only. So whenever one of the cached files changes on + the filesystem you <em>have</em> to restart the server (see the + <a href="../stopping.html">Stopping and Restarting</a> + documentation). To reiterate that point: if the files are + modified <em>in place</em> without restarting the server you + may end up serving requests that are completely bogus. You + should update files by unlinking the old copy and putting a new + copy in place. Most tools such as <code>rdist</code> and + <code>mv</code> do this.</p> + </section> + + <note><title>주의</title> + <p>디렉토리의 모든 파일을 재귀적으로 캐쉬에 저장하는 +지시어를 요구하지 마라. 대신 이렇게 해봐라... +<directive module="core">Include</directive> 지시어를 참고하고 +다음과 같은 명령을 실행하라:</p> + + <example> + find /www/htdocs -type f -print \<br /> + | sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf + </example> + </note> +</section> + +<directivesynopsis> +<name>MMapFile</name> +<description>Map a list of files into memory at startup time</description> +<syntax>MMapFile <var>file-path</var> [<var>file-path</var>] ...</syntax> +<contextlist><context>server config</context></contextlist> + +<usage> + <p>The <directive>MMapFile</directive> directive maps one or more files + (given as whitespace separated arguments) into memory at server + startup time. They are automatically unmapped on a server + shutdown. When the files have changed on the filesystem at + least a <code>HUP</code> or <code>USR1</code> signal should be send to + the server to re-<code>mmap()</code> them.</p> + + <p>Be careful with the <var>file-path</var> arguments: They have + to literally match the filesystem path Apache's URL-to-filename + translation handlers create. We cannot compare inodes or other + stuff to match paths through symbolic links <em>etc.</em> + because that again would cost extra <code>stat()</code> system + calls which is not acceptable. This module may or may not work + with filenames rewritten by <module>mod_alias</module> or + <module>mod_rewrite</module>.</p> + + <example><title>Example</title> + MMapFile /usr/local/apache/htdocs/index.html + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheFile</name> +<description>Cache a list of file handles at startup time</description> +<syntax>CacheFile <var>file-path</var> [<var>file-path</var>] ...</syntax> +<contextlist><context>server config</context></contextlist> + +<usage> + <p>The <directive>CacheFile</directive> directive opens handles to + one or more files (given as whitespace separated arguments) and + places these handles into the cache at server startup + time. Handles to cached files are automatically closed on a server + shutdown. When the files have changed on the filesystem, the + server should be restarted to to re-cache them.</p> + + <p>Be careful with the <var>file-path</var> arguments: They have + to literally match the filesystem path Apache's URL-to-filename + translation handlers create. We cannot compare inodes or other + stuff to match paths through symbolic links <em>etc.</em> + because that again would cost extra <code>stat()</code> system + calls which is not acceptable. This module may or may not work + with filenames rewritten by <module>mod_alias</module> or + <module>mod_rewrite</module>.</p> + + <example><title>Example</title> + CacheFile /usr/local/apache/htdocs/index.html + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_logio.xml.ko b/docs/manual/mod/mod_logio.xml.ko new file mode 100644 index 0000000000..f1dd8d24c7 --- /dev/null +++ b/docs/manual/mod/mod_logio.xml.ko @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding='EUC-KR' ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.6 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_logio.xml.meta"> + +<name>mod_logio</name> +<description>요청당 입출력 바이트수를 기록</description> +<status>Extension</status> +<sourcefile>mod_logio.c</sourcefile> +<identifier>logio_module</identifier> + +<summary> + + <p>이 모듈은 요청당 입출력 바이트수를 기록한다. 숫자는 + 네트웍에서 실제로 주고받은 바이트수를 나타내며, 요청과 응답의 + 헤더와 내용을 포함한다. 개수는 입력의 경우 SSL/TLS 이전에, + 출력의 경우 SSL/TLS 이후에 세기때문에 암호화의 결과도 + 올바로 반영된다.</p> + + <p>이 모듈을 사용하려면 <module>mod_log_config</module>이 + 필요하다.</p> + +</summary> + +<seealso><module>mod_log_config</module></seealso> +<seealso><a href="../logs.html">아파치 로그파일</a></seealso> + +<section id="formats"> +<title>사용자정의 로그 형식</title> + + <p>이 모듈은 두가지 새로운 로그지시어를 추가한다. 요청자체의 + 특성은 형식문자열에 "<code>%</code>" 지시어를 사용하여 기록한다. + 지시어는 로그파일에 다음과 같은 값을 기록한다:</p> + + <table border="1" style="zebra"> + <tr><th>형식문자열</th> + <th>설명</th></tr> + + <tr><td><code>%...I</code></td> + <td>요청과 헤더를 포함하여 받은 바이트수. 0일 수 없다.</td></tr> + + <tr><td><code>%...O</code></td> + <td>헤더를 포함하여 보낸 바이트수. 0일 수 없다.</td></tr> + </table> + + <p>보통 다음과 같이 사용한다:</p> + + <dl> + + <dt>결합된 입출력 로그 형식:</dt> + + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\" %I %O"</code></dd> + + </dl> + +</section> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_setenvif.xml.ko b/docs/manual/mod/mod_setenvif.xml.ko new file mode 100644 index 0000000000..a16f6c475a --- /dev/null +++ b/docs/manual/mod/mod_setenvif.xml.ko @@ -0,0 +1,244 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.12 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_setenvif.xml.meta"> + +<name>mod_setenvif</name> +<description>요청의 성격에 따라 환경변수 설정을 변경한다</description> +<status>Base</status> +<sourcefile>mod_setenvif.c</sourcefile> +<identifier>setenvif_module</identifier> + + +<summary> + + <p><module>mod_setenvif</module> 모듈은 요청의 성격이 + 정규표현식에 해당하는지 여부로 환경변수를 설정한다. 서버의 + 다른 부분이 행동을 결정할때 이 환경변수를 사용할 수 있다.</p> + + <p>설정파일에 나오는 순서대로 지시어를 처리한다. 그래서 + 브라우저가 MSIE가 아니라 mozilla인 경우 <code>netscape</code>를 + 설정하는 아래 예와 같이 여러 지시어를 함께 사용할 수 있다.</p> + +<example> + BrowserMatch ^Mozilla netscape<br /> + BrowserMatch MSIE !netscape<br /> +</example> +</summary> + +<seealso><a href="../env.html">아파치의 환경변수</a></seealso> + +<directivesynopsis> +<name>BrowserMatch</name> +<description>HTTP User-Agent에 따라 환경변수를 설정한다</description> +<syntax>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>] +[[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p><directive>BrowserMatch</directive>는 <directive + module="mod_setenvif">SetEnvIf</directive> 지시어의 특별한 + 경우로, HTTP 요청 헤더 <code>User-Agent</code>에 따라 환경변수를 + 설정한다. 다음 두 줄은 같다:</p> +<example> + BrowserMatchNoCase Robot is_a_robot<br /> + SetEnvIfNoCase User-Agent Robot is_a_robot<br /> +</example> + + <p>추가 예제:</p> +<example> + BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br /> + BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br /> + BrowserMatch MSIE !javascript<br /> +</example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>BrowserMatchNoCase</name> +<description>대소문자를 구별하지않고 User-Agent에 따라 환경변수를 +설정한다</description> +<syntax>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>value</em>] + [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>FileInfo</override> +<compatibility>아파치 1.2 이상 (아파치 1.2에서 이 지시어는 현재 + 없어진 mod_browser 모듈에 있었다)</compatibility> + +<usage> + + <p><directive>BrowserMatchNoCase</directive> 지시어는 <directive + module="mod_setenvif">BrowserMatch</directive> 지시어와 + 의미상 같다. 그러나 이 지시어는 대소문자를 구별하지않는다. + 예를 들어:</p> +<example> + BrowserMatchNoCase mac platform=macintosh<br /> + BrowserMatchNoCase win platform=windows<br /> +</example> + + <p><directive>BrowserMatch</directive>와 + <directive>BrowserMatchNoCase</directive> 지시어는 + <directive module="mod_setenvif">SetEnvIf</directive>와 + <directive module="mod_setenvif">SetEnvIfNoCase</directive> + 지시어의 특별한 경우다. 다음 주 줄은 같다:</p> +<example> + BrowserMatchNoCase Robot is_a_robot<br /> + SetEnvIfNoCase User-Agent Robot is_a_robot<br /> +</example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>SetEnvIf</name> +<description>요청의 성질에 따라 환경변수를 설정한다</description> +<syntax>SetEnvIf <em>attribute + regex [!]env-variable</em>[=<em>value</em>] + [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p><directive>SetEnvIf</directive> 지시어는 요청의 성질에 + 따라 환경변수를 정의한다. 첫번째 아규먼트 <em>attribute</em>는 + 다음 세가지중 하나다:</p> + +<ol> +<li>HTTP 요청 헤더 (더 자세한 정보는 <a + href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a> + 참고); 예를 들어: <code>Host</code>, <code>User-Agent</code>, + <code>Referer</code>, <code>Accept-Language</code>. 정규표현식을 + 사용하여 여러 요청 헤더를 지칭할 수 있다.</li> + +<li>요청의 다음 성질중 하나: + <ul> + <li><code>Remote_Host</code> - (있다면) 요청하는 클라이언트의 + 호스트명</li> + + <li><code>Remote_Addr</code> - 요청하는 클라이언트의 IP 주소</li> + + <li><code>Server_Addr</code> - 요청을 받는 서버의 IP 주소 + (2.0.43 버전 이후에만)</li> + + <li><code>Request_Method</code> - 사용한 메써드 이름 + (<code>GET</code>, <code>POST</code>, <em>등등</em>)</li> + + <li><code>Request_Protocol</code> - 요청의 프로토콜 이름과 + 버전 (<em>예를 들어</em>, "HTTP/0.9", "HTTP/1.1", <em>등.</em>)</li> + + <li><code>Request_URI</code> - HTTP 요청에서 요청한 자원 + -- 일반적으로 URL에서 질의문자열을 제외한 스킴(scheme)과 + 호스트 이후 부분</li> + </ul> +</li> + +<li>요청과 연관된 환경변수 이름. 그래서 <directive>SetEnvIf</directive> +지시어는 이전 지시어의 결과를 검사할 수 있다. 이전에 +<code>SetEnvIf[NoCase]</code> 지시어로 정의한 환경변수만을 +검사할 수 있다. '이전'이란 (서버전역과 같이) 더 넓은 영역 혹은 +지시어의 현재 영역 이전을 뜻한다. 요청 성질이 아니고 정규표현식이 +아닌 <em>attribute</em>는 환경변수로 취급한다.</li> +</ol> + +<p>두번째 아규먼트는 (<em>regex</em>) <a +href="http://www.pcre.org/">Perl 호환 정규표현식</a>이다. +이는 POSIX.2 egrep의 정규표현식과 비슷하다. <em>regex</em>가 +<em>attribute</em>에 대응하면 나머지 아규먼트를 처리한다.</p> + +<p>나머지 아규먼트는 설정할 변수명과 (선택적인) 설정값들이다. +다음과 같은 형식이다</p> + + <ol> + <li><code><em>varname</em></code>, 혹은</li> + + <li><code>!<em>varname</em></code>, 혹은</li> + + <li><code><em>varname</em>=<em>value</em></code></li> + </ol> + + <p>첫번째 형태는 값으로 "1"을 사용한다. 두번째 형태는 변수가 + 이미 정의된 경우 변수를 제거하고, 세번째는 변수의 값으로 + <code><em>value</em></code>를 설정한다. 아파치 2.1부터 + <var>value</var>에 있는 <code>$1</code>..<code>$9</code>를 + <var>regex</var>의 괄호친 하위표현식으로 대체한다.</p> + +<example> +<title>예제:</title> + SetEnvIf Request_URI "\.gif$" object_is_image=gif<br /> + SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br /> + SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br /> + :<br /> + SetEnvIf Referer www\.mydomain\.com intra_site_referral<br /> + :<br /> + SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br /> + :<br /> + SetEnvIf ^TS* ^[a-z].* HAVE_TS<br /> +</example> + + <p>처음 세 줄은 이미지 파일을 요청한 경우 환경변수 + <code>object_is_image</code>를 설정한다. 네번째 줄은 페이지를 + <code>www.mydomain.com</code> 웹사이트에서 참조한 경우 + <code>intra_site_referral</code>을 설정한다.</p> + + <p>마지막 예는 요청에 이름에 "TS"로 시작하고 값이 [a-z] + 중 하나로 시작하는 헤더가 있는 경우 환경변수 + <code>HAVE_TS</code>를 설정한다.</p> +</usage> + +<seealso><a href="../env.html">아파치의 환경변수</a>에 더 많은 +예제가 있다. +</seealso> +</directivesynopsis> + +<directivesynopsis> +<name>SetEnvIfNoCase</name> +<description>대소문자를 구별하지않고 요청의 성질에 따라 환경변수를 +설정한다</description> +<syntax>SetEnvIfNoCase <em>attribute regex + [!]env-variable</em>[=<em>value</em>] + [[!]<em>env-variable</em>[=<em>value</em>]] ...</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>FileInfo</override> +<compatibility>아파치 1.3 이후</compatibility> + +<usage> + + <p><directive>SetEnvIfNoCase</directive>는 의미상 <directive + module="mod_setenvif">SetEnvIf</directive> 지시어와 같지만, + 대소문자를 구별하지않고 정규표현식을 찾는다. 예를 들어:</p> +<example> + SetEnvIfNoCase Host Apache\.Org site=apache +</example> + + <p>이 경우 HTTP 요청 헤더 <code>Host:</code>가 + <code>Apache.Org</code>, <code>apache.org</code> 등을 포함하면 + <code>site</code> 환경변수를 "<code>apache</code>"로 설정한다.</p> +</usage> +</directivesynopsis> +</modulesynopsis> diff --git a/docs/manual/mod/mod_so.xml.ko b/docs/manual/mod/mod_so.xml.ko new file mode 100644 index 0000000000..ed47c2c1ad --- /dev/null +++ b/docs/manual/mod/mod_so.xml.ko @@ -0,0 +1,159 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.11 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_so.xml.meta"> + +<name>mod_so</name> +<description>시작할때 혹은 재시작할때 실행가능한 코드와 모듈을 +서버로 읽어들인다</description> +<status>Extension</status> +<sourcefile>mod_so.c</sourcefile> +<identifier>so_module</identifier> +<compatibility>윈도우즈에서 (항상 포함하는) Base 모듈이다.</compatibility> + +<summary> + + <p>몇몇 운영체제에서 아파치는 <a href="../dso.html">동적공유객체</a> + (DSO) 기술을 사용하여 서버를 다시 컴파일하지 않고도 실행중에 + 모듈을 읽어들일 수 있다.</p> + + <p>읽어들일 코드는, 유닉스에서는 (<code>.so</code> 확장자를 + 가진) 일반적인 공유객체파일이고, 윈도우즈에서는 <code>.so</code> + 혹은 <code>.dll</code> 확장자를 가진다.</p> + + <note type="warning"><title>경고</title> + <p>아파치 1.3 모듈을 아파치 2.0에서 사용할 수 없다. + 아파치 2.0이 동적으로 읽어들이거나 아파치와 같이 컴파일하려면 + 모듈을 수정해야 한다.</p> + </note> +</summary> + +<section id="windows"><title>윈도우즈에서 읽어들일 모듈 만들기</title> + + <note><title>주의</title> + <p>윈도우즈의 모듈명 형식은 아파치 1.3.15와 2.0에서 변경되었다. + 모듈명은 이제 mod_foo.so식이다.</p> + + <p>mod_so는 아직도 ApacheModuleFoo.dll 식의 모듈을 읽어들일 + 수 있지만, 새로운 이름 규칙을 선호한다. 모듈을 2.0에 맞게 + 수정한다면 이름을 2.0 규칙에 알맞게 고치길 바란다.</p></note> + + <p>아파치 모듈 API는 유닉스 버전이거나 윈도우즈 버전이거나 + 같다. 몇몇 API는 윈도우즈에 없는 유닉스 구조에 의존하기때문에 + 사용할 수 없지만, 유닉스에서 실행되는 많은 모듈을 수정없이 + 혹은 조금 수정하여 윈도우즈에서 사용할 수 있다.</p> + + <p>모듈은 두가지 방법으로 서버에 추가할 수 있다. 유닉스에서는 + 모듈을 서버와 같이 컴파일할 수 있다. 윈도우즈용 아파치는 + 유닉스와 달리 <code>Configure</code> 프로그램이 없기때문에 + 모듈의 소스파일을 ApacheCore 프로젝트 파일에 추가하고, 심볼을 + <code>os\win32\modules.c</code> 파일에 추가해야 한다.</p> + + <p>두번째 방법은 모듈을 서버가 + <code><directive>LoadModule</directive></code> 지시어를 + 사용하여 시작할때 읽어들일 수 있는 공유라이브러리 DLL로 + 만드는 것이다. 이 모듈 DLL을 배포하면 서버를 재컴파일하지 + 않고 어떤 윈도우즈용 아파치에서도 모듈을 사용할 수 있다.</p> + + <p>모듈 DLL을 만들기위해서는 모듈의 소스파일을 조금 수정해야 + 한다. DLL은 module record를 export해야 한다. (아래 참고) + 이를 위해 모듈의 module record 정의에 (아파치 헤더파일에 + 정의된) <code>AP_MODULE_DECLARE_DATA</code>를 추가한다. + 예를 들어, 다음과 같은 모듈이 있다면:</p> + +<example> + module foo_module; +</example> + + <p>다음과 같이 수정한다:</p> +<example> + module AP_MODULE_DECLARE_DATA foo_module; +</example> + + <p>이 부분은 윈도우즈에서만 사용하기때문에 변경하여도 유닉스에서 + 소스를 그대로 사용할 수 있다. 또, <code>.DEF</code> 파일에 + 익숙하다면 대신 이 파일을 사용하여 module record를 export할 + 수도 있다.</p> + + <p>이제 모듈을 포함한 DLL을 만든다. 이를 공유라이브러리 + libhttpd.dll을 컴파일할때 만든 libhttpd.lib export 라이브러리와 + 링크한다. 아파치 헤더파일을 올바로 찾도록 컴파일러 설정을 + 수정해야 할지도 모른다. 서버의 modules 디렉토리에서 이 + 라이브러리를 찾을 수 있다. 컴파일환경을 올바로 설정하기위해 + 기존 모듈의 .dsp 파일을 가져다 쓰거나 직접 만든 .dsp와 + 컴파일러/링커 옵션을 비교하는 것이 좋다.</p> + + <p>이제 모듈을 DLL로 만든다. 이것을 서버의 + <code>modules</code> 디렉토리에 두고, + <directive>LoadModule</directive> 지시어를 사용하여 읽어들인다.</p> + +</section> + +<directivesynopsis> +<name>LoadFile</name> +<description>지정한 목적파일이나 라이브러리를 읽어들인다</description> +<syntax>LoadFile <em>filename</em> [<em>filename</em>] ...</syntax> +<contextlist> +<context>server config</context> +</contextlist> + +<usage> + + <p>LoadFile 지시어는 서버가 시작하거나 재시작할때 지정한 + 목적파일이나 라이브러리를 읽어들인다(link in). 이 지시어는 + 어떤 모듈이 동작하기위해 필요한 코드를 추가로 읽어들일때 + 사용한다. <em>Filename</em>은 절대경로이거나 <a + href="core.html#serverroot">ServerRoot</a>에 대한 상대경로이다.</p> + + <p>예를 들어:</p> + + <example>LoadFile libexec/libxmlparse.so</example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>LoadModule</name> +<description>목적파일이나 라이브러리를 읽어들이고, 사용가능한 +모듈 목록에 추가한다</description> +<syntax>LoadModule <em>module filename</em></syntax> +<contextlist> +<context>server config</context> +</contextlist> + +<usage> + <p>LoadModule 지시어는 목적파일 혹은 라이브러리 <em>filename</em>을 + 읽어들이고, 사용가능한 모듈 목록에 <em>module</em>이라는 + 모듈 구조체를 추가한다. <em>Module</em>은 파일의 + <code>module</code> 자료형 외부변수명이며, 모듈 문서의 <a + href="module-dict.html#ModuleIdentifier">모듈명</a>에 + 나온다. 예를 들면:</p> + + <example> + LoadModule status_module modules/mod_status.so + </example> + + <p>ServerRoot의 modules 하위디렉토리에서 지정한 모듈을 읽어들인다.</p> +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_speling.xml.ko b/docs/manual/mod/mod_speling.xml.ko new file mode 100644 index 0000000000..07893cef0a --- /dev/null +++ b/docs/manual/mod/mod_speling.xml.ko @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.8 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_speling.xml.meta"> + +<name>mod_speling</name> +<description>사용자가 대소문자를 잘못 사용하거나 맞춤법이 틀리는 +것을 한번까지 허용하여 잘못된 URL을 고치려고 시도한다</description> +<status>Extension</status> +<sourcefile>mod_speling.c</sourcefile> +<identifier>speling_module</identifier> + + + +<summary> + + <p>종종 맞춤법이 틀리거나 대소문자를 잘못 사용하여 아파치가 + 문서 요청을 서비스할 수 없는 경우가 있다. 이 모듈은 다른 + 모든 모듈들이 포기한 요청에 해당하는 문서를 찾는다. 모듈은 + 요청한 디렉토리 안에 있는 모든 문서를 요청한 문서이름과 + <strong>대소문자 구별없이</strong> (문자 첨가 / 생략 / 교체 + 혹은 잘못된 문자 ) <strong>맞춤법이 한번까지 틀려도 + 봐주며</strong> 비교한다. 이런 방법으로 문서목록을 만든다.</p> + + <p>디렉토리를 살펴본 후에,</p> + + <ul> + <li>문서를 찾지못하면, 아파치는 일반적인 "document not + found (문서를 찾을 수 없음)" 오류를 반환한다.</li> + + <li>요청에 "거의" 일치하는 문서를 하나만 찾은 경우, 그 + 문서로 리다이렉션 응답을 한다.</li> + + <li>근접한 문서를 여러개 찾은 경우, 클라이언트가 올바른 + 문서를 선택할 수 있도록 문서목록을 보낸다.</li> + </ul> + +</summary> + + +<directivesynopsis> +<name>CheckSpelling</name> +<description>맞춤법 모듈을 사용한다</description> +<syntax>CheckSpelling on|off</syntax> +<default>CheckSpelling Off</default> +<contextlist> +<context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>Options</override> +<compatibility>아파치 1.1은 CheckSpelling을 별도로 제공하였지만, +대소문자가 다른 경우만을 처리할 수 있었다. 아파치 1.3에서 아파치 +배포본의 일부가 되었다. 아파치 1.3.2 이전에는 +<code>CheckSpelling</code> 지시어를 "주서버"와 "가상호스트" +사용장소에서만 사용할 수 있었다.</compatibility> + +<usage> + <p>이 지시어는 맞춤법 모듈의 사용여부를 결정한다. 사용한다면 + 다음을 주의하라</p> + + <ul> + <li>맞춤법 교정을 위해 디렉토리를 살펴보는 작업을 동시에 + 여러번 할 경우 서버 성능에 영향을 준다.</li> + + <li>문서중에 맞춤법 "교정"으로 우연히 보여질 수 있는 + 기밀문서가 없어야 한다.</li> + + <li>모듈은 파일명과 디렉토리명만을 교정할 수 있으며, + (<code>http://my.host/~apahce/</code>와 같이) 맞춤법이 + 틀린 사용자명을 교정하지 못한다.</li> + + <li>맞춤법 교정은 존재하는 파일에만 적용된다. 그래서 + <code><Location /status></code>에 대한 요청을 + 내용협상을 거친 "<code>/stats.html</code>" 파일로 오인할 + 수 있다.</li> + </ul> + + <!-- XXX: is that really true?! -nd --> + <p><a href="mod_dav.html">DAV</a>를 사용하는 디렉토리에 + mod_speling을 사용하면 안된다. 이유는 새로 업로드하려는 + <code>doc43.html</code> 문서를 엉뚱하게 기존의 + <code>doc34.html</code> 파일로 리다이렉트하는 등, DAV가 + 새로 만드는 리소스명을 기존의 파일명으로 "맞춤법 교정"을 + 시도하기 때문이다. + </p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_status.xml.ko b/docs/manual/mod/mod_status.xml.ko new file mode 100644 index 0000000000..2307cc0641 --- /dev/null +++ b/docs/manual/mod/mod_status.xml.ko @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.9 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_status.xml.meta"> + +<name>mod_status</name> +<description>서버 활동과 성능에 대한 정보를 제공한다</description> +<status>Base</status> +<sourcefile>mod_status.c</sourcefile> +<identifier>status_module</identifier> + + +<summary> + <p>Status 모듈은 서버 관리자에게 서버의 상태를 보여준다. + 쉽게 읽을 수 있는 HTML 페이지로 현재 서버통계를 보여준다. + 필요하다면 (표준을 따르는 브라우저에서) 페이지를 자동으로 + 갱신할 수 있다. 현재 서버 상태를 컴퓨터가 읽을 수 있는 + 간단한 목록으로 보여줄 수도 있다.</p> + + <p>알려주는 정보는:</p> + + <ul> + <li>################################ 요청을 서비스하는 worker의 개수</li> + + <li>쉬고 있는(idle) ####################### worker의 개수</li> + + <li>각 ## worker들의 상태, ## worker이 처리한 요청의 개수와 ## worker이 + 서비스한 전체 바이트수 (*)</li> + + <li>총 접근 횟수와 서비스한 바이트수 (*)</li> + + <li>서버가 시작혹은 재시작한 시간과 동작한 시간</li> + + <li>초당 요청수 평균, 초당 서비스한 바이트수와 요청당 + 바이트수 평균 (*)</li> + + <li>현재 아파치 전체와 각 ### worker들의 CPU 비율 (*)</li> + + <li>현재 처리하고 있는 호스트와 요청 (*)</li> + </ul> + + <p>표준 아파치에는 "(*)"로 표시한 통계를 얻을 수 없다. + 이 정보를 보려면 컴파일시 옵션을 사용해야 한다.</p> +</summary> + +<section id="enable"> + <title>Status 사용하기</title> + + <p>foo.com 도메인에서 접근한 브라우저에게만 상태를 보여주려면 + <code>httpd.conf</code> 설정파일에 다음과 같이 추가한다</p> +<example> + <Location /server-status><br /> + SetHandler server-status<br /> +<br /> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from .foo.com<br /> + </Location> +</example> + + <p>이제 웹브라우저로 + <code>http://your.server.name/server-status</code> 페이지에 + 접근하면 서버 통계를 볼 수 있다.</p> +</section> + +<section id="autoupdate"> + + <title>자동 갱신</title> + <p>브라우저가 "재갱신"을 지원한다면 status 페이지를 자동으로 + 갱신할 수 있다. N 초마다 갱신하려면 + <code>http://your.server.name/server-status?refresh=N</code> + 페이지를 사용하라.</p> + +</section> + +<section id="machinereadable"> + + <title>컴퓨터가 읽을 수 있는 Status 파일</title> + <p><code>http://your.server.name/server-status?auto</code>에서 + 컴퓨터가 쉽게 읽을 수 있는 status 파일을 얻을 수 있다. 이 + 형식은 아파치 <code>/support</code> 디렉토리에 있는 + <code>log_server_status</code> Perl 프로그램과 같이 자동으로 + 실행하는 프로그램에 유용하다.</p> + + <note> + <strong><module>mod_status</module>를 서버와 같이 + 컴파일하였다면 디렉토리<em>별</em> 설정파일을 (<em>예를 + 들어</em>, <code>.htaccess</code>) 포함하여 <em>모든</em> + 설정파일에서 핸들러를 사용할 수 있다. 그래서 사이트에 + 보안 문제가 발생할 수 있다.</strong> + </note> + +</section> + +<directivesynopsis> + +<name>ExtendedStatus</name> +<description>각 요청에 대한 자세한 상태 정보를 기록한다</description> +<syntax>ExtendedStatus On|Off</syntax> +<default>ExtendedStatus Off</default> +<contextlist><context>server config</context></contextlist> +<compatibility>ExtendedStatus는 아파치 1.3.2 이후에만 있다.</compatibility> + +<usage> + <p>이 설정은 서버 전체에 적용되며, 가상호스트별로 키고 끌 + 수 없다. 자세한 상태 정보를 모으면 서버가 느려질 수 있다.</p> +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_suexec.xml.ko b/docs/manual/mod/mod_suexec.xml.ko new file mode 100644 index 0000000000..1baf452226 --- /dev/null +++ b/docs/manual/mod/mod_suexec.xml.ko @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.9 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_suexec.xml.meta"> + +<name>mod_suexec</name> +<description>CGI 스크립트를 특정 사용자와 그룹 권한으로 실행한다</description> +<status>Extension</status> +<sourcefile>mod_suexec.c</sourcefile> +<identifier>suexec_module</identifier> +<compatibility>Available in Apache 2.0 and later</compatibility> + + +<summary> + <p>이 모듈은 <a href="../programs/suexec.html">suexec 지원 + 프로그램</a>을 사용하여 CGI 스크립트를 특정 사용자와 그룹 + 권한으로 실행한다.</p> +</summary> + +<seealso><a href="../suexec.html">SuEXEC 지원</a></seealso> + +<directivesynopsis> + +<name>SuexecUserGroup</name> +<description>CGI 프로그램이 사용할 사용자와 그룹 권한</description> +<syntax>SuexecUserGroup <em>User Group</em></syntax> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<compatibility>SuexecUserGroup은 2.0 이후에만 있다.</compatibility> + +<usage> + <p><directive>SuexecUserGroup</directive> 지시어는 CGI 프로그램이 + 사용할 사용자와 그룹을 설정한다. CGI가 아닌 요청은 계속 + User 지시어로 지정한 사용자가 처리한다. 이 지시어는 아파치 + 1.3에서 VirtualHost 안에 사용한 User와 Group 지시어를 + 대체한다.</p> + + <example> + <title>예제</title> + SuexecUserGroup nobody nogroup + </example> + +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_unique_id.xml.ko b/docs/manual/mod/mod_unique_id.xml.ko new file mode 100644 index 0000000000..d5fc6868b2 --- /dev/null +++ b/docs/manual/mod/mod_unique_id.xml.ko @@ -0,0 +1,173 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.7 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_unique_id.xml.meta"> + +<name>mod_unique_id</name> +<description>각 요청마다 유일한 식별자를 가지는 환경변수를 +제공한다</description> +<status>Extension</status> +<sourcefile>mod_unique_id.c</sourcefile> +<identifier>unique_id_module</identifier> + +<summary> + + <p>이 모듈은 어떤 특별한 상황에서도 "모든" 요청중에서 + 유일하도록 보장된 식별자(identifier)를 모든 요청에 제공한다. + 심지어 이 식별자는 특별하게 구성한 클러스터의 여러 컴퓨터들 + 중에서도 유일하다. 각 요청마다 환경변수 + <code>UNIQUE_ID</code>를 설정한다. 유일한 식별자는 여러가지 + 용도로 사용할 수 있지만, 설명은 이 문서의 범위를 넘어선다.</p> +</summary> + +<section id="theory"> + <title>이론</title> + + <p>먼저 유닉스 시스템에서 아파치 서버가 어떻게 동작하는지 + 간략히 살펴보자. Windows NT는 현재 이 기능을 지원하지 않는다. + 유닉스에서 아파치는 여러 자식을 만들고, 자식 프로세스는 + 한번에 한 요청씩 처리한다. 자식은 실행중에 여러 요청을 + 처리한다. 여기서 중요한 것은 자식들이 서로 자료를 + 공유하지 않는다는 점이다. 앞으로 자식을 httpd 프로세스라고 + 한다.</p> + + <p>여러 컴퓨터로 웹사이트를 서비스한다면 클러스터(cluster)라고 + 부른다. 각 컴퓨터는 여러 아파치를 실행할 수 있다. 이들 모두를 + "우주"로 보면, 클러스터에 있는 컴퓨터들간에 많은 통신없이 + 각 요청마다 우주에서 유일한 식별자를 만들 수 있다.</p> + + <p>클러스터에 있는 컴퓨터는 다음 요구사항을 만족해야 한다. + (컴퓨터를 한대만 사용하더라도 컴퓨터 시간을 NTP와 동기해야 + 한다.)</p> + + <ul> + <li>컴퓨터 시간은 NTP나 다른 네트웍 시간 프로토콜과 + 동기화된다.</li> + + <li>컴퓨터의 호스트명이 모두 다르다. 그래서 모듈이 + 호스트명으로 찾으면 클러스터에 있는 각 컴퓨터마다 다른 + IP 주소를 얻는다.</li> + </ul> + + <p>운영체제에서 pid (프로세스 id)가 32비트에 들어간다고 + 가정한다. 운영체제가 pid로 32비트 이상을 사용한다면 간단하지만 + 코드를 수정해야 한다.</p> + + <p>이런 가정하에 우리는 어떤 시점에서 클러스터의 어떤 컴퓨터에 + 있는 어떤 httpd 프로세스를 다른 모든 httpd 프로세스들과 + 구별할 수 있다. 컴퓨터의 IP 주소와 httpd 프로세스의 pid만으로도 + 충분히 구별할 수 있다. 그래서 요청에 대해 유일한 구별자를 + 만드려면 시간차를 구별할 수만 있으면 된다.</p> + + <p>시간을 구별하기위해 유닉스 시간(timestamp, 세계 표준시로 + 1970년 1월 1일 이후 지난 초)과 16비트 카운터를 사용한다. + 유닉스 시간은 초단위이고, 카운터는 일 초동안 65536까지 + 증가한다. <em>( ip_addr, pid, time_stamp, counter )</em> + 묶음은 어떤 httpd 프로세스에서 일 초동안 65536 요청을 구별할 + 수 있다. 그러나 카운터는 pid를 재사용하는 문제를 해결해야 + 한다.</p> + + <p>httpd 자식을 만들면 카운터는 ( 현재 밀리초 나누기 10 )을 + 65536으로 나눈 나머지가 된다. (몇몇 시스템의 밀리초 시간에서 + 하위 비트가 일치하지않는 문제때문에 이 공식을 만들었다.) + 유일한 식별자를 만들때 사용하는 시간은 웹서버가 요청을 받은 + 시간이다. 카운터는 식별자를 만들때마다 증가한다 (그리고 + 다시 시작한다).</p> + + <p>커널은 프로세스를 포크할때(fork) 각 프로세스에 pid를 + 할당하고, pid는 다시 시작할 수 있다. (pid는 많은 유닉스에서 + 16비트이지만, 최근 시스템은 32비트로 확장했다.) 그래서 시간이 + 지나면 같은 pid를 재사용할 수 있다. 그러나 같은 시간에 pid를 + 재사용하지 않는다면 위의 묶음은 유일하다. 즉, 우리는 시스템이 + 일초동안 프로세스를 65536개 이상 만들지 않는다고 가정한다. + (어떤 유닉스에서는 32768개 이상 프로세스를 만들면 pid 재사용 + 문제가 발생할 수 있지만, 이것조차도 일어날 것같지 않다.)</p> + + <p>시간이 어떤 이유에서건 반복된다고 가정해보자. 즉, 시스템 + 시계가 꼬여서 시간이 과거로 돌아가는 (혹은 시계가 너무 앞서가서 + 올바로 재설정한후 미래에 같은 시간이 되는) 경우다. 이 경우 + pid와 시간을 모두 재사용할 수 있다. 카운터의 초기화 공식은 + 이 문제를 해결하려고 고안되었다. 우리는 실제 무작위 숫자로 + 카운터를 초기화하길 원하지만, 많은 시스템에서 이런 수를 + 쉽게 얻을 수 없다. (<em>예를 들어</em>, seed가 필요하기때문에 + rand()를 사용할 수 없고, 시간은 최소한 일초 단위이기때문에 + 시간으로 seed로 사용할 수 없다.) 즉 완벽한 해결책이 없다.</p> + + <p>그럼 이 방법은 얼마나 괜찮을까? 컴퓨터중 하나가 요청을 + 초당 최대 500개 (시스템은 일반적으로 정적인 파일을 전송하는 + 것 이상의 작업을 하므로 이 글을 쓰는 시점에서 상당히 높은 + 값이다.) 서비스한다고 가정하자. 동시에 얼마만큼의 클라이언트를 + 처리하는가에 따라 자식의 개수가 결정된다. 그러나 우리는 + 비관적으로 한 자식이 요청을 초당 500개 처리할 수 있다고 + 가정한다. 재사용한 pid를 가진 자식의 500개 요청과 이전 자식의 + 500개 요청의 카운터값이 겹칠 수 있는 카운터 시작값 경우수는 + 1000개이다. 그래서 (초단위에서) 자식이 카운터값을 반복하여 + 유일성이 깨질 확률은 1.5%이다. 이것은 매우 비관적인 가정이며, + 실제 이럴 경우는 상당히 더 낮다. 그래도 시스템에서 이런 + 일이 발생할 것 같다면 (소스를 수정하여) 카운터를 32비트로 + 만들어라.</p> + + <p>섬머타임때문에 시계가 "뒤로 가는" 것을 걱정할지도 모른다. + 그러나 여기서 사용하는 시간은 국제 표준시(UTC), 즉 시간이 + "항상" 앞으로 가므로 문제가 없다. x86기반 유닉스에서는 + 적절한 설정이 필요하다. 메인보드 시계가 UTC를 사용하도록 + 설정해야 한다. 그러나 NTP를 사용한다면 재시작후 조금 지나면 + UTC 시간에 올바로 맞춘다.</p> + + <p>환경변수 <code>UNIQUE_ID</code>는 MIME base64 인코딩과 + 비슷한 방법으로 112비트 (32비트 IP 주소, 32비트 pid, 32비트 + 시간, 16비트 카운터) 묶음을 알파벳 <code>[A-Za-z0-9@-]</code>로 + 표현한다. 실제 MIME base64 알파벳은 + <code>[A-Za-z0-9+/]</code>이지만 <code>+</code>와 + <code>/</code>는 URL에서 특별한 의미로 사용하므로 제외했다. + 모든 값을 네트웍 바이트순서로 인코딩하기때문에 다른 바이트순서를 + 사용하는 아키텍쳐간에 값이 같다. 실제 인코딩 순서는 + 시간, IP 주소, pid, 카운터 순서이다. 이 순서에는 어떤 목적이 + 있지만, 프로그램은 인코딩 순서에 의존하여 값들을 분석하면 + 안됨을 강조한다. 프로그램은 인코딩된 <code>UNIQUE_ID</code> + 전체를 한 단위로 생각하고, 다른 <code>UNIQUE_ID</code>와 + 동일한지만 비교할 수 있다.</p> + + <p>순서는 앞으로 기존의 <code>UNIQUE_ID</code> 데이터베이스와 + 충돌을 염려하지않고 인코딩을 변경할 수 있도록 고안했다. + 새로운 인코딩은 첫 항목으로 시간을 사용하거나, 같은 알파벳과 + 비트 길이를 사용할 수도 있다. 시간이 기본적으로 증가하는 값이므로 + 클러스터에 있는 모든 컴퓨터가 요청 서비스를 중단하고 이전 + 인코딩 형식을 그만 사용하기위해 <em>기준 초(flag second)</em>만으로 + 충분하다. 이후 요청을 재게하고 새로운 인코딩을 시작할 수 + 있다.</p> + + <p>우리는 이 방법이 이 문제에 대하여 상대적으로 포팅가능한 + 해결책이라고 믿는다. 이 방법은 Windows NT와 같은 멀티쓰레드 + 시스템으로 확장할 수 있고, 앞으로 용도에 따라 확장할 수 + 있다. 미래에 필요한만큼 더 긴 식별자를 만들 수 있기때문에 + 생성한 식별자는 기본적으로 영원한 수명을 가진다. 기본적으로 + 클러스터의 컴퓨터들 사이에 통신이 필요없고 (부하가 작은 + NTP 동기만 필요하다), httpd 프로세스 사이에 통신도 필요없다 + (커널이 부여하는 pid값이 암묵적인 통신이다). 매우 특이한 + 상황이라면 인식자 크기를 줄일 수 있지만 더 많은 정보를 + 가정해야 한다. (예를 들어, 어떤 사이트에서 32비트 IP 주소 + 구분은 불필요하게 크지만, 이를 줄이는 방법은 상황에 따라 + 다르다.) </p> +</section> + + +</modulesynopsis> diff --git a/docs/manual/mod/mod_userdir.xml.ko b/docs/manual/mod/mod_userdir.xml.ko new file mode 100644 index 0000000000..1f2640c861 --- /dev/null +++ b/docs/manual/mod/mod_userdir.xml.ko @@ -0,0 +1,145 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.13 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<modulesynopsis metafile="mod_userdir.xml.meta"> + +<name>mod_userdir</name> +<description>사용자별 디렉토리</description> +<status>Base</status> +<sourcefile>mod_userdir.c</sourcefile> +<identifier>userdir_module</identifier> + +<summary> +<p>이 모듈을 사용하면 <code>http://example.com/~user/</code> 식으로 +사용자별 디렉토리에 접근할 수 있다.</p> +</summary> + +<seealso><a href="../urlmapping.html">URL을 파일시스템에 대응</a></seealso> +<seealso><a href="../howto/public_html.html">public_html +투토리얼</a></seealso> + +<directivesynopsis> + +<name>UserDir</name> +<description>사용자별 디렉토리 위치</description> +<syntax>UserDir <em>directory-filename</em></syntax> +<default>UserDir public_html</default> +<contextlist><context>server config</context> <context>virtual +host</context></contextlist> + +<usage> + + <p><directive>UserDir</directive> 지시어는 사용자의 문서에 대한 +요청을 받을때 사용자 홈디렉토리 안에서 사용할 실제 디렉토리를 +지정한다. <em>Directory-filename</em>은 다음 중 하나이다:</p> + + <ul> + <li>아래와 같은 디렉토리명 혹은 패턴.</li> + + <li><code>disabled</code> 키워드. +<code>enabled</code> 키워드로 (아래 참고) 직접 이름을 지정하지 않았다면 +<em>모든</em> 사용자명-디렉토리 변환을 하지 않는다.</li> + + <li><code>disabled</code> 키워드 뒤에 공백으로 구분한 사용자명 목록. +사용자명이 <code>enabled</code> 구문에 있다고 하더라도, 이 목록에 +있는 사용자명은 디렉토리 변환을 하지 <em>않는다</em>.</li> + + <li><code>enabled</code> 키워드 뒤에 공백으로 구분한 사용자명 목록. +전체 disable을 사용하고 사용자명이 <code>disabled</code> 구문에 +없더라도, 사용자명을 디렉토리 변환한다.</li> + </ul> + + <p><code>Userdir</code> 지시어에 <code>enabled</code>나 +<code>disabled</code> 키워드를 사용하지 않으면, 아규먼트를 +파일명 패턴으로 처리하여 디렉토리로 변환한다. +<code>http://www.foo.com/~bob/one/two.html</code>에 대한 요청은 +다음과 같이 변환된다:</p> + +<table> +<tr><th>사용한 UserDir 지시어</th> +<th>변환한 경로</th></tr> +<tr><td>UserDir public_html</td><td>~bob/public_html/one/two.html</td></tr> +<tr><td>UserDir /usr/web</td><td>/usr/web/bob/one/two.html</td></tr> +<tr><td>UserDir /home/*/www</td><td>/home/bob/www/one/two.html</td></tr> +</table> + + <p>다음 지시어는 클라이언트에게 리다이렉션을 보낸다:</p> + +<table> +<tr><th>사용한 UserDir 지시어</th> +<th>변환한 경로</th></tr> +<tr><td>UserDir http://www.foo.com/users</td><td>http://www.foo.com/users/bob/one/two.html</td></tr> +<tr><td>UserDir +http://www.foo.com/*/usr</td><td>http://www.foo.com/bob/usr/one/two.html</td></tr> +<tr><td>UserDir +http://www.foo.com/~*/</td><td>http://www.foo.com/~bob/one/two.html</td></tr> +</table> + +<note> + <strong>이 지시어를 사용할때 주의하라; 예를 들어, +<code>"UserDir ./"</code>는 <code>"/~root"</code>를 아마도 바람직하지 않게 +<code>"/"</code>로 변환한다. 설정에 "<code>UserDir + disabled root</code>"를 포함하길 강력히 권한다. 자세한 정보를 알려면 +<directive + module="core">Directory</directive> 지시어와 <a + href="../misc/security_tips.html">보안 팁</a>도 참고하라.</strong> +</note> + +<p>추가 예제:</p> + +<p>몇몇 사용자에게만 <code>UserDir</code> 디렉토리를 허용한다면, +다음과 같다:</p> + +<example> +UserDir disabled<br /> +UserDir enabled user1 user2 user3 +</example> + +<p>대부분의 사용자에게 <code>UserDir</code> 디렉토리를 허용하고 +일부만 거부한다면, 다음과 같다:</p> + +<example> +UserDir enabled<br /> +UserDir disabled user4 user5 user6 +</example> + +<p>다른 사용자 디렉토리를 지정할 수도 있다. +다음과 같은 명령어를 사용한다면:</p> +<example> +Userdir public_html /usr/web http://www.foo.com/ +</example> +<p>http://www.foo.com/~bob/one/two.html 요청을 하면, +먼저 ~bob/public_html/one/two.html 페이지를 찾고, +/usr/web/bob/one/two.html을 찾은 후, 마지막으로 +http://www.foo.com/bob/one/two.html으로 리다이렉션을 보낸다.</p> +<p>리다이렉션을 사용한다면 목록의 마지막에 두어야 한다. +아파치는 리다이렉션이 성공했는지 알 수 없기때문에, 리다이렉션을 +목록 앞에 두면 항상 리다이렉션을 사용하게 된다.</p> + +</usage> + +<seealso><a href="../howto/public_html.html">public_html +투토리얼</a></seealso> + +</directivesynopsis> +</modulesynopsis> + + diff --git a/docs/manual/mod/module-dict.xml.ko b/docs/manual/mod/module-dict.xml.ko new file mode 100644 index 0000000000..7190af6c71 --- /dev/null +++ b/docs/manual/mod/module-dict.xml.ko @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> +<!-- English Revision: 1.5 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<manualpage metafile="module-dict.xml.meta"> + + <title>모듈을 설명하기위해 사용한 용어들</title> + +<summary> + <p>이 문서는 아파치 <a href="./">모듈</a>을 설명하기위해 + 사용한 용어를 설명한다.</p> +</summary> + +<section id="Description"><title>설명</title> + +<p>모듈 목적에 대한 간단한 설명.</p> +</section> + +<section id="Status"><title>상태</title> + + <p>모듈이 아파치 웹서버와 얼마나 밀접히 연관되있는지 나타낸다. + 즉, 특정 모듈과 모듈의 기능을 사용하기위해서 서버를 다시 + 컴파일해야 할 경우가 있다. 이 속성의 값은:</p> + + <dl> + <dt>MPM</dt> + + <dd>상태가 "MPM"인 모듈은 <a href="../mpm.html">다중처리 + 모듈</a>이다. 다른 종류의 모듈과 달리 아파치는 오직 한 + MPM만을 사용한다. 이런 종류의 모듈은 기본적인 요청 처리와 + 분배를 담당한다.</dd> + + <dt>Base</dt> + + <dd>상태가 "Base"인 모듈은 기본적으로 서버와 같이 컴파일되므로, + 설정에서 모듈을 제거하지 않는 한 보통 사용할 수 있다.</dd> + + <dt>Extension</dt> + + <dd>상태가 "Extension"인 모듈은 보통 서버와 같이 컴파일되지 + 않는다. 모듈과 모듈의 기능을 사용하려면 서버 컴파일 + 구성파일을 변경하고 아파치를 다시 컴파일해야 한다.</dd> + + <dt>Experimental</dt> + + <dd>"Experimental" 상태는 모듈이 아파치 배포본에 포함되있지만, + 사용하려면 위험을 감수해야 한다. 모듈에 대한 문서가 있지만, + 모듈을 지원한다는 말은 아니다.</dd> + + <dt>External</dt> + + <dd>"External" 상태는 기본 아파치 배포본에 포함되지 않은 + 모듈("제삼자가 만든 모듈")이다. 우리는 이런 모듈에 책임이 + 없고 지원하지도 않는다.</dd> + </dl> +</section> + +<section id="SourceFile"><title>소스파일</title> + + <p>간단하게 말해서 모듈 소스코드가 있는 소스파일명이다. + <directive module="core" type="section">IfModule</directive> + 지시어에서 사용하는 이름이기도 하다.</p> +</section> + +<section id="ModuleIdentifier"><title>모듈명</title> + + <p>모듈을 지칭하는 문자열로, 모듈을 동적으로 읽어들이는 + <directive module="mod_so">LoadModule</directive> 지시어에서 + 사용한다. 정확히 말하면 소스파일에서 module 형의 외부변수 + 이름이다.</p> +</section> + +<section id="Compatibility"><title>지원</title> + + <p>모듈이 원래 아파치 버전 2 배포본에 포함되지 않았다면, + 모듈을 처음 소개한 버전을 알려준다. 또, 모듈이 특정 + 플래폼용이라면 상세히 설명한다.</p> +</section> + +</manualpage> diff --git a/docs/manual/mod/quickreference.xml.ko b/docs/manual/mod/quickreference.xml.ko new file mode 100644 index 0000000000..fd22d7e485 --- /dev/null +++ b/docs/manual/mod/quickreference.xml.ko @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="EUC-KR" ?> +<!DOCTYPE quickreference SYSTEM "../style/modulesynopsis.dtd" + [ <!ENTITY allmodules SYSTEM "allmodules.xml.ko"> ] +> +<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?> +<!-- English Revision: 1.9 --> + +<!-- + Copyright 2004 The Apache Software Foundation + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<quickreference metafile="quickreference.xml.meta"> + <title>지시어 빠른참조</title> + <summary> + <p>이 문서는 아파치 설정지시어 각각의 용도, 기본값, 상태, + 사용장소를 보여준다. 이들은 <a + href="directive-dict.html">지시어 사전</a>에서 설명한다.</p> + + <p>첫번째 열은 지시어 이름과 용도를 알려준다. 두번째 열은 + 지시어에 기본값이 있다면 기본값을 보여준다. 만약 기본값이 + 너무 길다면, "+" 기호로 생략했음을 알린다.</p> + + <p>세번째와 네번째 열은 각각 아래 표에 따라 지시어를 사용할 + 수 있는 장소와 지시어의 상태를 나타낸다.</p> + </summary> + + <legend> + <table> + <columnspec><column width=".1"/><column width=".2"/></columnspec> + <tr><th>s</th><td>주서버설정</td></tr> + <tr><th>v</th><td>가상호스트</td></tr> + <tr><th>d</th><td>directory</td></tr> + <tr><th>h</th><td>.htaccess</td></tr> + </table> + + <table> + <columnspec><column width=".1"/><column width=".2"/></columnspec> + <tr><th>C</th><td>Core</td></tr> + <tr><th>M</th><td>MPM</td></tr> + <tr><th>B</th><td>Base</td></tr> + <tr><th>E</th><td>Extension</td></tr> + <tr><th>X</th><td>Experimental</td></tr> + </table> + </legend> + + &allmodules; +</quickreference> |