background image

Creating Policies to Support Entitlements

5

27

no

vd

ocx 

(e

n)

  

13

 Ma
y 20

09

5

Creating Policies to Support 
Entitlements

An entitlement gives a user permission to access the resource represented by the entitlement. 
However, for the entitlement to actually be granted or revoked, you need to create the appropriate 
policies.

Information about how to create policies is provided in the 

Policies in Designer 3.0

 (http://

www.novell.com/documentation/idm36/policy_designer/data/bookinfo.html)

 and 

Policies in 

iManager for Identity Manager 3.6.1

 (http://www.novell.com/documentation/idm36/

policy_imanager/data/bookinfo.html)

 guides.

By default, the Active Directory driver includes several entitlements and the policies required to 
support the entitlements. These policies are listed below. You can use these policies as examples of 
the types of policies you might need to create to support entitlements on other drivers.

Š

Input Transform (driver level): 

The Check Target Of Add Association For Group 

Membership Entitlements rule in this policy checks the target of “add-association” for group 
membership entitlements. Group membership entitlements assigned to users being created in 
Active Directory cannot be processed until the user is successfully created. Add-association 
signals that an object has been created by the driver in Active Directory. If the object is also 
tagged for group entitlement processing, it performs the work now.

Š

Event Transform (Publisher channel): 

The Disallow User Account Delete rule in this policy 

disallows a user account delete in the Identity Vault. When you use the User Account 
Entitlement, managed user accounts are controlled by the entitlement in the Identity Vault. A 
delete in Active Directory does not delete the controlling object in the Identity Vault. A future 
change to the object in the Identity Vault or a merge operation might re-create the account in 
Active Directory.

Š

Command (Subscriber channel): 

The Command policy contains the following rules 

pertaining to entitlements: 

Š

The User Account Entitlement Change (Delete Option) rule. The User Account 
Entitlement grants the user an enabled account in Active Directory. Revoking the 
entitlement disables or deletes the Active Directory account, depending on the value you 
select for the 

When account entitlement revoked

 global variable. This rule executes when 

the entitlement is changing and you have selected the 

Delete

 option.

Š

The User Account Entitlement Change (Disable Option) rule. The User Account 
Entitlement grants the user an enabled account in Active Directory. Revoking the 
entitlement disables or deletes the Active Directory account, depending on the value you 
select for the 

When account entitlement revoked

 global variable. This rule executes when 

the entitlement is changing and you have selected the 

Disable

 option.

Š

The Check User Modify for Group Membership Being Granted or Revoked rule. 

Š

The Check User Modify for Exchange Mailbox Being Granted or Revoked rule.

Š

Matching (Subscriber channel): 

This is the Account Entitlement: Do Not Match Existing 

Accounts rule for this policy. When you use the User Account entitlement with the Identity 
Manager user application or Role-Based Entitlements, accounts are created and deleted (or 
disabled) by granting or revoking the entitlement. The default policy does not match an existing 

Summary of Contents for IDENTITY MANAGER 3.6.1 - ENTITLEMENTS

Page 1: ...Novell www novell com novdocx en 13 May 2009 AUTHORIZED DOCUMENTATION Identity Manager 3 6 1 Entitlements Guide Identity Manager 3 6 1 June 05 2009 Entitlements Guide...

Page 2: ...r re export to entities on the current U S export exclusion lists or to any embargoed or terrorist countries as specified in the U S export laws You agree to not use deliverables for prohibited nuclea...

Page 3: ...Trademarks For Novell trademarks see the Novell Trademark and Service Mark list http www novell com company legal trademarks tmlist html Third Party Materials All third party trademarks are the proper...

Page 4: ...4 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Page 5: ...20 4 2 3 Valued Entitlement that Queries an External Application 21 4 3 Creating Entitlements in iManager 24 5 Creating Policies to Support Entitlements 27 6 Editing Entitlements 29 6 1 Editing Entit...

Page 6: ...6 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Page 7: ...online documentation or go to www novell com documentation feedback html and enter your comments there Documentation Updates For the most recent version of the Entitlements Guide visit the Identity Ma...

Page 8: ...8 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Page 9: ...figured Entitlements on page 11 1 1 How Entitlements Work The following diagram shows the basic entitlement process Figure 1 1 Overview of Entitlements 1 An entitlement agent grants an entitlement to...

Page 10: ...itlements Both roles based provisioning and workflow based provisioning require the use of entitlements If you use either of these User Application provisioning methods you must use entitlements If yo...

Page 11: ...y Grant and revoke accounts group membership Exchange Mailbox GroupWise Grant and revoke accounts grant and revoke members of distribution lists LDAP Grant and revoke user accounts and group membershi...

Page 12: ...12 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Page 13: ...ttribute to the User class The following drivers are already enabled for entitlements You do not need to complete this task for these drivers Active Directory GroupWise LDAP Linux and UNIX Lotus Notes...

Page 14: ...r Role Based Entitlements Implementation Guide http www novell com documentation idm36drivers entitlements data bktitle html User Application Roles Based Provisioning Manages entitlements based on rol...

Page 15: ...d Unix Lotus Notes RACF 3 1 Using Designer to Enable Entitlements Designer is the recommended tool for creating entitlements see Section 4 2 Creating Entitlements in Designer on page 17 During the ent...

Page 16: ...hlighted 7 Click User and select Add Attribute then scroll to the bottom and select Show all attributes 8 Select the DirXML EntitlementRef attribute then click OK 9 Select DirXML EntitlementRef in the...

Page 17: ...to create for other drivers User Account Entitlement Grants or revokes an account in Active Directory for the user When the account is granted the user is given an enabled logon account When the acco...

Page 18: ...is displayed select Yes then click OK to enable the entitlement for the driver Skip the remaining steps in this section or Select Yes if the entitlement needs to include values click Next then continu...

Page 19: ...n this example the values are corporate buildings Building A through Building D Through an entitlement client such as an iManager Role Based Entitlement task or through the user application users or d...

Page 20: ...lows the driver filter to listen for entitlement activities which is necessary in order to use the entitlements you are creating or If you don t want to see the Add To Filter window on entitlements yo...

Page 21: ...rity Merging the values merges the entitlements of all involved Role Based Entitlement policies so if one policy revokes an entitlement but another policy grants an entitlement the entitlement is even...

Page 22: ...e Schema Browser The list includes both the Attributes and the Inherited Attributes for the selected class Description Defines the attribute that displays as a description for that value For the descr...

Page 23: ...policy grants an entitlement the entitlement is eventually granted Solving conflicts by priority works if you need to ensure that only one policy is applied to this entitlement at any time This examp...

Page 24: ...w again 4 3 Creating Entitlements in iManager We strongly recommend that you use the Entitlement Wizard in Designer to create entitlements The Entitlement Wizard creates the entitlement XML from the i...

Page 25: ...es in the policies that are implementing the entitlement The entitlement name is stored on the Ref and Result attributes within the policy The context for the entitlement is already populated because...

Page 26: ...26 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Page 27: ...Vault When you use the User Account Entitlement managed user accounts are controlled by the entitlement in the Identity Vault A delete in Active Directory does not delete the controlling object in th...

Page 28: ...ased Entitlements accounts are created only for users that are specifically granted the account entitlement This rule vetoes user account creation when the entitlement is not granted Identity Vault Ac...

Page 29: ...entitlements You can also edit the XML source directly Section 6 1 1 Using the Entitlement Editor on page 29 Section 6 1 2 Using the XML Source and XML Tree Views on page 31 6 1 1 Using the Entitlemen...

Page 30: ...priority button is the default Values Allows you to define how values are defined no values administrator defined values or values from an application The information that appears in the Entitlement E...

Page 31: ...he XML code in a formatted state The upper right corner of the XML Source view has the following selections Name Description Expand All Allows you to see all items under the item that you have selecte...

Page 32: ...a tree control view of the XML source code You can perform the same edits in this view as you can in the Entitlement Editor view or the XML Source view To view the entitlement in XML Tree view select...

Page 33: ...d Before a Comment a Processing Instruction a PCDATA a CDATA Section a new Element Add After a Comment a Processing Instruction a PCDATA a CDATA Section a new Element Name Description Expand All Allow...

Page 34: ...river Sets tab use the Search In field to search for and display the driver set 4 Click the driver set to open the Driver Set Overview page 5 Click the driver to display the Driver Overview page 6 On...

Page 35: ...s provide information to help you create XML entitlement documents Section A 1 Novell Entitlement Document Type Definition DTD on page 35 Section A 2 Examples to Help You Write Your Own Entitlements o...

Page 36: ...c id param state status msg timestamp ELEMENT dn PCDATA ELEMENT state PCDATA ELEMENT status PCDATA ELEMENT msg ANY ELEMENT timestamp PCDATA Cached query results stored in the DirXML SPCachedQuery attr...

Page 37: ...Policy has a higher priority If an entitlement is single valued conflicts must be resolved by priority because a union of values results in more than one value being applied Role Based Entitlements p...

Page 38: ...esult set element to help you interpret the result of an external application query There are three pieces of data that are of interest the display name of the value the display name child element the...

Page 39: ...EntitlementRef portion is actually not part of the Entitlement definition You don t need to do anything with the elements and attributes under this heading A 2 Examples to Help You Write Your Own Enti...

Page 40: ...perform future modifications to the entitlement The actual name of the entitlement is UserAccount while the display name displays in a managing agent as User Account Entitlement A 2 2 Example 2 Applic...

Page 41: ...top of the tree and continues through its subtrees These values come from the connected Active Directory server and the application query starts at the nds tag Under the query xml tag this query recei...

Page 42: ...states that the entitlement grants or revokes an Exchange mailbox for the user in Microsoft Exchange which is enough detail for what the entitlement does The display name is Exchange Mailbox Entitleme...

Page 43: ...orporate building letters Building A through Building F Then through an entitlement client such as an iManager Roles Based Entitlement task or through the User Application users or defined task manage...

Page 44: ...44 Identity Manager 3 6 1 Entitlements Guide novdocx en 13 May 2009...

Reviews: