<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2015, v.4002-->
<!DOCTYPE pubsConcept PUBLIC "-//PTC//DTD PUBS DITA Concept//EN"
 "pubsConcept.dtd">
<?Pub UDT template _font?>
<?Pub Inc?>
<pubsConcept id="_ACL_config_21571" xml:lang="en"
xmlns:import="http://www.oberontech.com/import"
import:style="0_TopicSub"
import:map-object="2Heading_to_concept_in_conceptH1">
<title>Controlling Read/Update Access</title>
<prolog>
<metadata><keywords>
<indexterm>permission<indexterm>Read</indexterm></indexterm>
<indexterm>permission<indexterm>Update</indexterm></indexterm>
<indexterm>ACLs<indexterm>read access</indexterm></indexterm>
<indexterm>ACLs<indexterm>update access</indexterm></indexterm>
<indexterm>Update permission</indexterm>
<indexterm>Read permission</indexterm>
<indexterm>ACLs<indexterm>revising<indexterm>read/update access</indexterm
></indexterm></indexterm>
<indexterm>permission<indexterm>revising read/update access</indexterm
></indexterm>
<indexterm>Administration Client<indexterm>revising mks aa mks ACL</indexterm
></indexterm>
</keywords></metadata>
</prolog>
<pubsConbody>
<p>The <codeph import:style="Literal">mks:aa:mks</codeph> ACL controls
the ability to read (or view) and update the ACL system. For this
reason it is important that you, as administrator, control the permissions
assigned to users within this ACL.</p>
<p>The two permissions controlled through <codeph import:style="Literal"
>mks:aa:mks</codeph> are <codeph import:style="Literal">Read</codeph
> and <codeph import:style="Literal">Update</codeph>. The <codeph
import:style="Literal">Read</codeph> permission allows a user to view
the ACL system and assigned permissions, while the <codeph
import:style="Literal">Update</codeph> permission allows a user to
make changes to the system, such as allowing or denying permissions,
or deleting entire ACLs.</p>
<p>As a general rule, only an administrator, or administrative group,
should have access to updating or modifying the ACLs. Depending on
the workflow at your site, you may also want to restrict viewing access
to the ACLs.</p>
<p>The following procedures detail the steps required to revise the <codeph
import:style="Literal">Read</codeph> and <codeph import:style="Literal"
>Update</codeph> permissions.</p>
<p>Keep in mind the important distinction between clearing and denying
a permission. Based on inheritance, an explicitly denied permission
takes precedence, even if that permission is allowed through another
principal. When you clear a permission, that permission can still
be explicitly allowed through another principal.</p>
<note type="caution"><p>In controlling read and update access, the
sequence of operations is extremely important. First you must first
ensure that, as administrator, you have assigned yourself both the <codeph
import:style="Literal8">Read</codeph> and <codeph
import:style="Literal8">Update</codeph> permissions and that you retain
these permissions after any other changes to the ACL system. Only
then can you clear those permissions for the <codeph
import:style="Literal8">everyone</codeph> group.</p></note>
<p import:style="ProcedureNoToc">To revise Read/Update permissions
using the <ph conkeyref="text_variables/ProdName06"></ph>:</p>
<ol>
<li import:style="1Step"><p>From the <ph
conkeyref="text_variables/ProdName06"></ph>, open the <menucascade>
<uicontrol>Permissions</uicontrol><uicontrol>ACL Control</uicontrol>
</menucascade> view, and click <uicontrol import:style="GUI">ACL</uicontrol
>. The display pane shows the <codeph import:style="Literal">mks:aa:mks</codeph
> ACL. Remember, ACL entries consist of principals and permissions.
In this case, the assigned permissions are <codeph
import:style="Literal">Read</codeph> and <codeph import:style="Literal"
>Update</codeph>.</p></li>
<li import:style="1Step+"><p>You should first add a new ACL entry
that gives you or your administrator group full access to reading
and updating the ACLs. To add a new ACL entry, select <menucascade>
<uicontrol>ACL</uicontrol><uicontrol>View ACL</uicontrol></menucascade
> from the main menu. A panel displays the default permissions for
the <codeph import:style="Literal">mks:aa:mks</codeph> ACL.</p></li><?Pub
Caret 165?>
<li import:style="1Step+"><p>To add a new ACL entry, select <menucascade>
<uicontrol>ACL</uicontrol><uicontrol>Add Principal</uicontrol>
</menucascade>. The <uicontrol import:style="GUI">Select Principal</uicontrol
> dialog box displays.</p></li>
<li import:style="1Step+"><p>From the <uicontrol import:style="GUI"
>Principal</uicontrol> list, select the administrative group or user
you want to add the new ACL entry for, and click <uicontrol
import:style="GUI">OK</uicontrol>. The <uicontrol import:style="GUI"
>Change Permissions</uicontrol> dialog box displays.</p><note><p>Once
you add a principal, you can edit the associated permissions at any
time by selecting the required option from the <uicontrol
import:style="GUI8">ACL</uicontrol> menu or by right clicking and
choosing the required option from the shortcut menu. Menu options
include <uicontrol import:style="GUI8">Allow Permission</uicontrol
>, <uicontrol import:style="GUI8">Deny Permission</uicontrol>, and <uicontrol
import:style="GUI8">Clear Permission</uicontrol>.</p></note></li>
<li import:style="1Step+"><p>To allow the selected administrative
user or group the permissions for both read and update, change the
permissions for the target administrative group or user in <codeph
import:style="Literal">mks:aa:mks</codeph>, and click <uicontrol
import:style="GUI">Allow All</uicontrol> to allow both read and update
permissions.</p></li>
<li import:style="1Step+"><p>To accept the changes, click <uicontrol
import:style="GUI">OK</uicontrol>. The new ACL entry for the administrator
displays.</p></li>
<li import:style="1Step+"><p>Clear the <codeph import:style="Literal"
>Update</codeph> permission for the <codeph import:style="Literal"
>everyone</codeph> group. To view the permissions for the <codeph
import:style="Literal">everyone</codeph> group, highlight <uicontrol
import:style="GUI">ACL Control</uicontrol>, and select <menucascade>
<uicontrol>ACL</uicontrol><uicontrol>View ACL</uicontrol></menucascade
> from the main menu. A panel displays the default permissions for
the <codeph import:style="Literal">everyone</codeph> group in the <codeph
import:style="Literal">mks:aa:mks</codeph> ACL.</p></li>
<li import:style="1Step+"><p>To clear the <codeph import:style="Literal"
>Update</codeph> permission for the <codeph import:style="Literal"
>everyone</codeph> group, highlight <uicontrol import:style="GUI"
>everyone</uicontrol>, and select <menucascade><uicontrol>ACL</uicontrol>
<uicontrol>Change Permissions</uicontrol></menucascade>. The <uicontrol
import:style="GUI">Change Permissions</uicontrol> dialog box displays.</p
><p import:style="Bullet Text">In the default condition, both the <codeph
import:style="Literal">Read</codeph> and <codeph import:style="Literal"
>Update</codeph> permissions are allowed for the <codeph
import:style="Literal">everyone</codeph> group.</p></li>
<li import:style="1Step+"><p>To clear the <codeph import:style="Literal"
>Update</codeph> access permission for the <codeph
import:style="Literal">everyone</codeph> group, click the indicator
box for <codeph import:style="Literal">Update</codeph> and toggle
through the condition indicator until the box is blank indicating
a cleared condition.</p><note type="caution"><p>When setting <codeph
import:style="Literal8">mks:aa:mks</codeph> ACL permissions for the <codeph
import:style="Literal8">everyone</codeph> group, be careful that you
only clear the permissions. </p><p import:style="NoteBody">Do not
deny permissions to the <codeph import:style="Literal8">everyone</codeph
> group—this effectively denies permission to all users, including
any administrator included in that group. Denial of read and update
access to the administrator means that you cannot access the ACL database.</p
><p import:style="NoteBottom">You may also want to consider clearing
the <codeph import:style="Literal8">Read</codeph> permission for the <codeph
import:style="Literal8">everyone</codeph> group if you do not want
users to view the ACL system.</p></note></li>
<li import:style="1Step+"><p>To accept the changes and return to the
main <ph conkeyref="text_variables/ProdName06"></ph> interface, click <uicontrol
import:style="GUI">OK</uicontrol>. The <codeph import:style="Literal"
>Update</codeph> permission is now clear for the <codeph
import:style="Literal">everyone</codeph> group and explicitly allowed
only for the administrator.</p></li>
</ol>
</pubsConbody>
</pubsConcept>
