/!\ since MoniWiki 1.1.2 모니위키의 SecurityPlugin의 한가지 [[TableOfContents]] == 설정 == `config.php`에 다음을 넣으면 ACL SecurityPlugin이 활성화됩니다. {{{ $security_class="acl"; $acl_type="default"; }}} == 미리 정의된 그룹 @group == * @ALL: 모든 사용자 (priority: 1) * @User: 등록 사용자 (priority: 2) == 사용자 정의 그룹 @group 그리고 @group의 priority == {{{ ##@그룹이름 사용자리스트 [priority] @Guest Anonymous # priority를 지정하지 않으면 기본값 2 @Kiwirian foobar,kiwi,hello123 20 # @Kiwirain 그룹의 priority를 잡는다. }}} /!\ 여기서 Anonymous 사용자는 @Guest로 지정되어 있으며, @Guest는 미리 정의된 그룹이 아닙니다. ---- 모니위키 1.1.5부터는 network/ip 주소를 지원합니다. {{{ # 부분 IP, CIDR 등등도 모두 지원. @Block 123.123.0.0/255.255.0.0, 123.12, 123.125.0/16 }}} 위의 예에서 @Block 그룹을 정의하고 있으며 이에 해당되는 IP대역, 부분IP 등등을 지정하고 있습니다. 아래와 같이 그룹에 대한 효력을 발생시킬 수 있습니다. {{{ * @Block deny * // 모든 페이지(*)를 @Block 사용자그룹에 대해 모든 액션(*)을 거부(deny) }}} /!\ IP, CDIR, 부분IP 등등은 그룹 지정에서만 사용 가능합니다. == ACL 타입 == * `allow` : 허용 * `deny` : 제한 * `protect`: 비밀번호 제한이 가능한 몇몇 POST액션에 대해 (모든 액션이 관리비번으로 제한가능하지는 않습니다) * 일부 POST액션은 관리자 비밀번호로 제한을 걸어둘 수 있는 액션은 protect 가능한 액션입니다. protect 액션은 ''제한된 allow''이며, 일부 POST액션만 지원합니다. 예) do_post_savepage()는 post 액션이며, 일반 do_goto()같은 액션과는 달리 관리자 비밀번호로 액션을 제한을 할 수 있습니다. 지정 방법은 {{{*}}}는 모든 액션을 가리키며, 페이지 이름은 regex가 가능합니다. {{{ # 페이지이름 @그룹/특정사용자 allow/deny 액션리스트 FoobarPage @ALL allow * FoobarPage babo deny edit,diff,info HelpOn.* @ALL deny edit,savepage }}} === 간단한 적용의 일부 === {{{ @Guest Anonymous // @Guest 사용자 그룹 정의 * @ALL deny * // 모든 페이지(*)를 모든 사용자(@ALL)에서 모든 액션(*)을 거부(deny) * @ALL allow ticket // 모든 페이지를 모든 사용자에게 ticket 액션을 허락(allow) * @ALL allow read,userform,rss_rc,aclinfo,fortune,deletepage,fixmoin,ticket // 여러 줄로 나눠쓰기 가능 * @User allow * // 모든 페이지(*)를 일반 가입 사용자에게(@User) 허락(*) WikiSandBox @Guest allow edit,info,diff // WikiSandBox 페이지를 @Guest 그룹에 edit,info,diff 액션을 허용(allow) WikiSandBox Foobar deny edit // 사용자 Foobar는 WikiSandbox 편집 못하게 함 }}} === 완전한 적용의 예 === /!\ ''//''로 시작되는 줄은 설명줄입니다. {{{ # acl.default.php # // 파일은 php이지만 형식은 php가 아닌 일반 텍스트다. # Please don't modify the lines above # # A sample Access Control Lists file for Moniwiki # @Guest Anonymous // @Guest 사용자 그룹 정의 * @ALL deny * // 모든 페이지(*)를 모든 사용자(@ALL)에서 모든 액션(*)을 거부(deny) * @ALL allow ticket // 모든 페이지(*)를 모든 사용자(@ALL)에게 ticket 액션을 허락(allow) ticket은 가입 폼에 나오는 로봇가입방지 captcha * @User allow * // 모든 페이지(*)를 일반 가입 사용자에게(@User) 허락(*) # some pages are allowed to edit WikiSandBox @Guest allow edit,info,diff // WikiSandBox 페이지를 @Guest 그룹에 edit,info,diff 액션을 허용(allow) # some POST actions support protected mode using admin password * @ALL protect deletefile,deletepage,rename,rcspurge,rcs,chmod,backup,restore // 모든 페이지(*)에 대해 모든 사용자의(@ALL) detetefile,deltetepage 등등의 protect 가능한 액션을 protect # some actions allowed to @ALL * @ALL allow read,userform,rss_rc,aclinfo,fortune,deletepage,fixmoin,ticket # some pages have restrict permission MoniWiki @ALL deny edit,uploadfile,diff // MoniWiki 페이지를 @ALL 모든 사용자에게 edit,upload,diff등의 일부 액션을 거부 }}} == ACL이 성립되는 과정 == === 마지막 ACL 항목이 적용된다 === explicit하게 지정할 경우 최종 ACL 항목이 적용된다. * {{{allow read}}} + {{{deny read}}} = {{{deny read}}} * {{{deny read}}} + {{{allow read}}} = {{{allow read}}} ---- wildcard를 쓴 경우도 역시 최종 ACL 항목이 적용된다. * {{{allow *}}} + {{{deny *}}} = {{{deny *}}} 모든 액션을 거부 * {{{deny *}}} + {{{allow *}}} = {{{allow *}}} 모든 액션을 승인 === explicit하게 지정해야 한다 === wildcard를 쓴 것 보다 explicit하게 지정된 것이 먼저 적용된다. (순서에 상관 없다) * {{{deny *}}} + {{{allow edit,info}}} = edit와 info 액션만 가능: '''explicit하게 지정된''' 액션만 허락 * {{{allow *}}} + {{{deny info,diff}}} = info/diff 이외의 액션이 모두 허용: '''explicit하게 지정된''' 액션만 거부 * {{{deny info,diff}}} + {{{allow *}}} = 위의 경우와 같다. explicit하게 지정된 액션인 info, diff만 거부 /!\ {{{deny *}}} + {{{allow read}}}는 아파치의 {{{Order allow,deny}}}와 같다. 즉, explicit하게 지정된 allow에 대해 먼저 검사하여 액션이 read일때만 허락하고 나머지 액션은 deny. {{{deny edit}}} + {{{allow *}}}은 그 반대로 {{{Order deny,allow}}}가 된다. === 예 === 모든 페이지에 대해서 읽기만 가능하게, ProtectedPage에 대해서는 읽기도 거부 {{{ * @ALL deny * * @ALL allow read ProtectedPage @ALL deny read }}} ProtectedPage는 {{{deny *}}} + {{{allow read}}} + {{{deny read}}} = {{{deny *}}}이 된다. ---- /!\ 주의: 모든 경우, explicit하게 지정될 경우에 효력이 발생한다. {{{ * @ALL deny * * @ALL allow read ProtectedPage @ALL deny * }}} ProtectedPage는 {{{deny *}}} + {{{allow read}}} + {{{deny *}}}이 된다: explicit하게 허락된 read가 허용된다. 마지막 줄 {{{ProtectedPage @ALL deny *}}}는 무시되게 되는 것이다. == priority가 다른 경우 ACL의 성립 과정 == 앞절의 설명은 priority가 같은 경우에 대한 일반적인 설명이었다. 그룹의 priority를 두었을 때는 어떻게 적용될까? === 예제 1 === {{{ @ALL deny * @User allow * }}} 이 경우 @User의 priority가 높으므로 {{{allow *}}}이 적용된다. === 예제 2 === {{{ @ALL deny * @User allow read }}} @User에서 read가 허용. 나머지는 {{{@ALL deny *}}}에 의해 거부된다. === 예제 3 === {{{ * @ALL deny * * @ALL allow read,ticket,info,diff,titleindex,bookmark,pagelist ProtectedPage @All deny read,ticket,info,diff,titleindex,bookmark,pagelist }}} * 모든 사용자(@ALL)에게 allow를 제외한 모든 액션 거부. * ProtectedPage는 edit,savepage를 제외하고 모두 불허 * 이 경우, allow를 explicit하게 한 모든 액션에 대해 explicit하게 deny를 걸어주어야 된다. {{{deny *}}} 라고만 하면 안된다. {{{ * @ALL deny * * @ALL allow show,ticket,titleindex,bookmark,pagelist * @User allow edit,savepage ProtectedPage @User deny * # 이것만으로는 의도대로 작동 안한다. # 다음을 explicit하게 명시해야 의도대로 작동한다. ProtectedPage @User deny edit,savepage }}} * 일반 등록 사용자(@User)는 edit,savepage 허락. * ProtectedPage는 모두 불허 * 이 경우 등록 사용자에 대해 {{{@User deny *}}} + {{{@User allow edit,savepage}}}이므로 edit,savepage만 허용된다. * {{{allow edit,savepage}}}라고 explicit하게 정의된 것을 다시 취소시켜야 의도대로 작동하는 것이다. 따라서 {{{ProtectedPage @User deny edit,savepage}}}라고 써 주어야 한다. === 연습 === 1) 그룹 priority가 같은 항목끼리 합쳐지고, 2) 그룹 priority가 높은 항목이 우선적으로 적용된다. {{{ ####### @ALL 그룹의 priority는 1이다. @Guest Anonymous # @ALL을 제외한 모든 그룹의 priority는 그 값이 지정되지 않으면 2 이다. @Group1 peter,john 20 # priority = 20 @Group2 simon,soo # default group priorty = 2 * @ALL allow * # group priority = 1 * @ALL deny backup,restore * @Guest deny * # group priority = 2 * @Group1 deny * # User defined @Group1 group * @Group1 allow read,info,diff * @Group2 deny info,diff }}} * peter와 john: {{{allow read,info,diff}}} + {{{deny *}}} = read,info,diff만 허용 * Anonymous (@Guest): {{{deny *}}}: 모두 거부 (@Guest그룹의 priority가 높으므로 @ALL에 대해 허용된 것과 무관하게 거부된다) * 다른 모든 사용자(@ALL): {{{deny backup,resotre}}} + {{{allow *}}} ('''Order Deny,Allow''') * @Group1 : {{{allow read,info,diff}}} + {{{deny *}}} ('''Order Allow,Deny''') * @Group2 : {{{deny info,diff}}} + {{{@ALL deny backup,restore}}} + {{{allow *}}}: priority가 같은 항목이 합쳐진다. /!\ 각 ACL 항목의 같은 priority를 가지는 모든 항목이 합해져서 적용됩니다. config.php에 {{{$acl_debug=1}}} 옵션을 넣으면, 어떤 식으로 적용될지를 보여줍니다. ----