Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Directory Editor 1 2005Q1 Installation and Configuration Guide 

Appendix D
Working with Operational Attributes

Operational attributes are attributes that are stored in a directory and used to provide information to the directory server. For example, an access control instruction (ACI) is an operational attribute that helps the directory server manage access control.

Directory Editor does not generally provide access to operational attributes from its user interface, but you may find it useful to view and edit these attributes.
This appendix uses the following scenario to illustrate the procedure for adding operational attributes to a Directory Editor form.

If you want to add an ACI to the People OU that allows only HR Managers group members to change a person's manager, customize the organizationalUnit form to display the ACI, as follows:

  1. Select Configure > Forms.
  2. If necessary, scroll down the page and locate organizationalunit in the Name column. Click the Customize button in the Action column.
  3. When the Forms page is displayed, click the New Field button.
  4. The left side of the Forms page changes to Field Undefined as shown in the following figure:

    Figure D-1  Specifying the New Field
    Specifying a new field for the operational attribute.

  5. On the Field Properties tab, provide the following information:
    • Name: Enter attributes[aci].value (which is how attributes are referenced in a form).
    • Title: Enter a title for the new field, which will be displayed in the form.
      For example, type ACI:.
    • Type: Select Text from the menu to indicate that this will be a text field.
    • When the new text fields and checkboxes are displayed below the Type menu, enable the Multi-Valued check box in the Options row because there can be multiple ACIs for each entry.
    • Figure D-2  Completed Field Properties Tab
      Completed Field Properties Tab.

  6. Select the Move Field tab, and move this field after Business Category.
  7. Figure D-3  Completed Move Field Tab
    Completed Move Field tab.

  8. When you are finished, click OK.
  9. Note that the new ACI field is now displayed below the business Category field on the Common Attributes tab.

    Figure D-4  Updated Common Attributes Tab
    Updated Common Attributes tab now includes the ACI field.

  10. Click Save to save the customized organizationalUnit form.

Next you must edit the ACIs on the People OU.


Note

You must be logged in as a Directory Administrator to edit many of the operational attributes. For this example, consider that you are logged in as cn=Directory Manager.


  1. Select the Browse tab and click the People OU.
  2. When the ou=People - Edit page is displayed, click an Add button in the ACI list to add a new field to the list.
  3. Figure D-5  Add a New ACI Field
    Adding a new ACI text field to the list.

  4. Enter the following text into the new ACI field:
  5. (targetattr = "manager") (version 3.0;acl "Only HR can change your manager.";deny (write)(groupdn != "ldap:///cn=HR Managers,ou=groups,
    dc=central,dc=sun,dc=com");)


    Note

    This format is directory-server dependent (it works on Sun ONE Directory Server only).

    This new ACI tells the directory that only HR Managers group members are allowed to change the Manager field for all users in the People OU.


  6. Click Save to add the new ACI to the People OU.

Directory Editor decides which operational attributes to return for an entry, based upon which attributes are requested as form fields. If an operational attribute’s form field name is generated dynamically, you must add a blank field to the form so Directory Editor knows to load that field.

For example, if your form contains a field with the following generated name:

<Field name='attributes[$(fieldName)].value'>

....

</Field>

You must also add a blank field to the form so Directory Editor knows to load the operational attribute as follows:

<Field name='attributes[aci].value' />



Previous      Contents      Index      Next     


Part No: 819-2191.   Copyright 2004 Sun Microsystems, Inc. All rights reserved.