repo_zf1/documentation/manual/id/module_specs/Zend_Acl-Refining.xml

<sect1 id="zend.acl.refining">

    <title>Kontrol Akses Yang Lebih Detail</title>

    <sect2 id="zend.acl.refining.precise">

        <title>Kontrol Akses Yang Presisi</title>

        <para>
        Dasar-dasar ACL yang dijelaskan dalam <link linkend="zend.acl.introduction">sub bab sebelumnya</link>
        memperlihatkan bagaimana berbagai hak akses diterapkan terhadap seluruh ACL (semua resource).
        Namun dalam prakteknya, kontrol akses sering kali memiliki pengecualian-pengecualian dan beragam
        tingkat kompleksitas. Zend_Acl memungkinkan anda mengantisipasi hal-hal detail seperti ini dalam langkah jelas
        dan fleksibel.
        </para>

        <para>
        Sebagai contoh, dalam kasus CMS kita sebelumnya, role 'staff' memiliki hak akses yang mencakup semua
        kebutuhan user. Hanya saja, terkadang kita memerlukan group di bawah 'staff' yang bernama 'marketing'
        yang hanya bisa mengakses "newsletter" dan berita terakhir ("latest news") di CMS.
        </para>

        <para>
        Juga diinginkan agar 'staff' hanya dapat melihat ("view") berita ("news") tapi tidak
        boleh mengedit berita terakhir. Dan terakhir, semua orang (termasuk administrator) mesti tidak bisa membuat arsip
        dari tiap berita pengumumuman ("anountcement news") karena biasanya pengumuman seperti ini cuma berlaku 1-2 hari.
        </para>

        <para>
        Pertama, kita perlu merevisi role registry untuk mangakomodir kebutuhan baru ini. Seperti sudah dijelaskan,
        group 'marketing' memiliki perizinan yang sama dengan 'staff', sehingga kita cukup mendefinisikan 'marketing'
        dengan mewarisi perizinan dari 'staff':
        </para>

        <programlisting role="php"><![CDATA[
// Group baru bernama marketing yang mewarisi perizinan staff
$acl->addRole(new Zend_Acl_Role('marketing'), 'staff');
]]>
        </programlisting>

        <para>
        Berikutnya, kita memerlukan tiga buah resource yaitu "newsletter", "latest news", dan "announcement news":
        </para>

        <programlisting role="php"><![CDATA[
// membuat resource

// newsletter
$acl->add(new Zend_Acl_Resource('newsletter'));

// news
$acl->add(new Zend_Acl_Resource('news'));

// latest news yang merupakan anak dari news
$acl->add(new Zend_Acl_Resource('latest'), 'news');

// announcement news yang merupakan anak dari news
$acl->add(new Zend_Acl_Resource('announcement'), 'news');
]]>
        </programlisting>

        <para>
        Selanjutnya tinggal mendifinisikan aturan-aturan spesifik sesuai kebutuhan di atas ke dalam ACL:
        </para>

        <programlisting role="php"><![CDATA[
// Marketing bisa mempublish and mengarsip (archive) newsletter dan
// berita terakhir
$acl->allow('marketing',
            array('newsletter', 'latest'),
            array('publish', 'archive'));

// Staff (dan juga marketing, sesuai pewarisan), tidak boleh
// merevisi berita terakhir
$acl->deny('staff', 'latest', 'revise');

// Semua (termasuk administrator) tidak boleh
// mengarsip berita pengumuman
$acl->deny(null, 'announcement', 'archive');
]]>
        </programlisting>

        <para>
        Dari aturan baru yang sudah kita buat, kita bisa melakukan query seperti berikut:
        </para>

        <programlisting role="php"><![CDATA[
echo $acl->isAllowed('staff', 'newsletter', 'publish') ?
     "allowed" : "denied";
// denied

echo $acl->isAllowed('marketing', 'newsletter', 'publish') ?
     "allowed" : "denied";
// allowed

echo $acl->isAllowed('staff', 'latest', 'publish') ?
     "allowed" : "denied";
// denied

echo $acl->isAllowed('marketing', 'latest', 'publish') ?
     "allowed" : "denied";
// allowed

echo $acl->isAllowed('marketing', 'latest', 'archive') ?
     "allowed" : "denied";
// allowed

echo $acl->isAllowed('marketing', 'latest', 'revise') ?
     "allowed" : "denied";
// denied

echo $acl->isAllowed('editor', 'announcement', 'archive') ?
     "allowed" : "denied";
// denied

echo $acl->isAllowed('administrator', 'announcement', 'archive') ?
     "allowed" : "denied";
// denied
]]>
        </programlisting>

    </sect2>

    <sect2 id="zend.acl.refining.removing">

        <title>Menghapus Aturan dari Kontrol Akses</title>

        <para>
        Untuk menghapus satu atau lebih aturan dari ACL, anda cukup menggunakan method <code>removeAllow()</code>
        atau <code>removeDeny()</code>. Seperti halnya <code>allow()</code> dan <code>deny()</code>, anda
        bisa menambahkan nilai <code>null</code> untuk mengindikasikan penghapusan aturan itu berlaku terhadap semua role,
        resource dan atau hak akses:
        </para>

        <programlisting role="php"><![CDATA[
// Membuat staff (dan juga marketing karena pewarisan) menjadi
// bisa merevisi berita terakhir
$acl->removeDeny('staff', 'latest', 'revise');

echo $acl->isAllowed('marketing', 'latest', 'revise') ?
     "allowed" : "denied";
// allowed

// Menghapus hak untuk mempublish dan mengarsip (archive) newsletter
// dari marketing
$acl->removeAllow('marketing',
                  'newsletter',
                  array('publish', 'archive'));

echo $acl->isAllowed('marketing', 'newsletter', 'publish') ?
     "allowed" : "denied";
// denied

echo $acl->isAllowed('marketing', 'newsletter', 'archive') ?
     "allowed" : "denied";
// denied
]]>
        </programlisting>

        <para>
        Hak akses dapat dimodifikasi secara spesifik untuk aksi tertentu (publish, archive)
        seperti ditunjukan di atas, tapi nilai <code>null</code> pada hak akses akan menimpah
        modifikasi semacam itu:
        </para>

        <programlisting role="php"><![CDATA[
// kembali memperbolehkan marketing melakukan apapun terhadap
// berita terakhir. Perhatikan kita tidak memasukan parameter terakhir pada allow()
// yang berarti null, dan berarti ini berlaku untuk aksi apapun (publish, archive dll)
$acl->allow('marketing', 'latest');

echo $acl->isAllowed('marketing', 'latest', 'publish') ?
     "allowed" : "denied";
// allowed

echo $acl->isAllowed('marketing', 'latest', 'archive') ?
     "allowed" : "denied";
// allowed

echo $acl->isAllowed('marketing', 'latest', 'anything') ?
     "allowed" : "denied";
// allowed
]]>
        </programlisting>

    </sect2>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->