Novell Access Manager 3.1 SP4 User guide

www.novell.com/documentation

Policy Guide

Access Manager 3.1 SP5

January 2013

Legal Notices

Novell,Inc.,makesnorepresentationsorwarrantieswithrespecttothecontentsoruseofthisdocumentation,andspecifically

disclaimsanyexpressorimpliedwarrantiesofmerchantabilityorfitnessforanyparticularpurpose.Further,Novell,Inc.,

reservestherighttorevisethispublicationandtomakechangestoitscontent,at

anytime,withoutobligationtonotifyany

personorentityofsuchrevisionsorchanges.

Further,Novell,Inc.,makesnorepresentationsorwarrantieswithrespecttoanysoftware,andspecificallydisclaimsany

expressorimpliedwarrantiesofmerchantabilityorfitnessforanyparticularpurpose.Further,Novell,Inc.,reservestheright

to

makechangestoanyandallpartsofNovellsoftware,atanytime,withoutanyobligationtonotifyanypersonorentityof

suchchanges.

AnyproductsortechnicalinformationprovidedunderthisAgreementmaybesubjecttoU.S.exportcontrolsandthetrade

lawsofothercountries.Youagreeto

complywithallexportcontrolregulationsandtoobtainanyrequiredlicensesor

classificationtoexport,re‐exportorimportdeliverables.Youagreenottoexportor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nuclear,missile,orchemicalbiologicalweaponryenduses.SeetheNovellInternationalTrade

ServicesWebpage(http://www.novell.com/info/exports/)formoreinformationonexportingNovellsoftware.Novellassumes

noresponsibilityforyourfailuretoobtainanynecessaryexportapprovals.

Copyright©2013Novell,

Inc.Allrightsreserved.Nopartofthispublicationmaybereproduced,photocopied,storedona 

retrievalsystem,ortransmittedwithouttheexpresswrittenconsentofthepublisher.

Novell, Inc.

1800 South Novell Place

Provo, UT 84606

U.S.A.

www.novell.com

OnlineDocumentation:ToaccessthelatestonlinedocumentationforthisandotherNovellproducts,seetheNovell

DocumentationWebpage(http://www.novell.com/documentation).

Novell 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propertyoftheirrespectiveowners.

Contents 3

Contents

About This Guide 7

1 Managing Policies 9

1.1 Selecting a Policy Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

1.2 Policy Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

1.3 Managing Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.3.1 Creating Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.3.2 Sorting Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.3.3 Deleting Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.3.4 Renaming or Copying a Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

1.3.5 Importing and Exporting Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

1.3.6 Creating the SSL VPN Default Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

1.3.7 Refreshing Policy Assignments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

1.3.8 Viewing Policy Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.4 Viewing Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

1.5 Managing Policy Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.6 Managing a Rule List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

1.6.1 Rule Evaluation for Role Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

1.6.2 Rule Evaluation for Authorization Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

1.6.3 Rule Evaluation for Identity Injection and Form Fill Policies . . . . . . . . . . . . . . . . . . . . . . . .15

1.6.4 Viewing Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

1.7 Adding Policy Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

1.7.1 Installing the Extension on the Administration Console. . . . . . . . . . . . . . . . . . . . . . . . . . . .16

1.7.2 Distributing a Policy Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

1.7.3 Managing a Policy Extension Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

1.7.4 Viewing Extension Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

1.8 Enabling Policy Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

2 Creating Role Policies 21

2.1 Understanding RBAC in Access Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

2.1.1 Assigning All Authenticated Users to a Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

2.1.2 Using a Role to Create an Authentication Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.1.3 Using Prioritized Rules in an Authorization Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

2.2 Creating Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

2.2.1 Selecting Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

2.2.2 Using Multiple Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.2.3 Selecting an Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

2.3 Example Role Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

2.3.1 Creating an Employee Role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

2.3.2 Creating a Manager Role. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

2.3.3 Creating a Rule for a Contract with ORed Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

2.4 Creating Access Manager Roles in an Existing Role-Based Policy System . . . . . . . . . . . . . . . . . . .49

2.4.1 Activating Roles from External Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49

2.4.2 Using Conditions to Assign Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51

2.5 Mapping Roles between Trusted Providers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58

2.5.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

2.5.2 Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

2.6 Enabling and Disabling Role Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60

2.7 Importing and Exporting Role Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

4 Contents

3 Creating Authorization Policies 61

3.1 Designing an Authorization Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61

3.1.1 Controlling Access with a Deny Rule and a Negative Condition . . . . . . . . . . . . . . . . . . . . .62

3.1.2 Configuring the Result on Condition Error Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63

3.1.3 Many Rules or Many Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63

3.1.4 Using Multiple Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

3.1.5 Controlling Access with Multiple Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65

3.1.6 Using Permit Rules with a Deny Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

3.1.7 Using Deny Rules with a General Permit Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

3.1.8 Public Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

3.1.9 General Design Principles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69

3.1.10 Using the Refresh Data Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

3.1.11 Assigning Policies to Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

3.2 Creating Access Gateway Authorization Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

3.3 Sample Access Gateway Authorization Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73

3.3.1 Sample Policy Based on Organizational Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73

3.3.2 Sample Workflow Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76

3.4 Creating Web Authorization Policies for J2EE Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

3.5 Creating Enterprise JavaBean Authorization Policies for J2EE Agents. . . . . . . . . . . . . . . . . . . . . . . 81

3.6 Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

3.6.1 Authentication Contract Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83

3.6.2 Client IP Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

3.6.3 Credential Profile Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86

3.6.4 Current Date Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87

3.6.5 Day of Week Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88

3.6.6 Current Day of Month Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89

3.6.7 Current Time of Day Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90

3.6.8 HTTP Request Method Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

3.6.9 LDAP Attribute Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

3.6.10 LDAP OU Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93

3.6.11 Liberty User Profile Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95

3.6.12 Roles Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

3.6.13 URL Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

3.6.14 URL Scheme Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98

3.6.15 URL Host Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

3.6.16 URL Path Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

3.6.17 URL File Name Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

3.6.18 URL File Extension Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

3.6.19 X-Forward-For IP Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104

3.6.20 Condition Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

3.6.21 Data Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

3.6.22 Using the URL Dredge Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

3.6.23 Edit Button. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

3.7 Importing and Exporting Authorization Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

4 Creating Identity Injection Policies 109

4.1 Designing an Identity Injection Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

4.1.1 Using the Refresh Data Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

4.2 Configuring an Identity Injection Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

4.3 Configuring an Authentication Header Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

4.4 Configuring a Custom Header Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

4.5 Configuring a Custom Header with Tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118

4.6 Specifying a Query String for Injection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121

4.7 Injecting into the Cookie Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123

4.8 Importing and Exporting Identity Injection Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124

4.9 Sample Identity Injection Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Contents 5

5 Creating Form Fill Policies 127

5.1 Understanding an HTML Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

5.2 Creating a Form Fill Policy for the Sample Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

5.3 Implementing Form Fill Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133

5.3.1 Designing a Form Fill Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133

5.3.2 Creating a Form Fill Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138

5.3.3 Creating a Login Failure Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143

5.3.4 Troubleshooting a Form Fill Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144

5.4 Creating and Managing Shared Secrets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

5.4.1 Naming Conventions for Shared Secrets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

5.4.2 Creating a Shared Secret Independent of a Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147

5.4.3 Modifying and Deleting a Shared Secret. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

5.5 Importing and Exporting Form Fill Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

5.6 Configuring a Form Fill Policy for Forms With Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149

5.6.1 Why Does Form Fill Fail with the Default Policy? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149

5.6.2 Understanding How a Form Is Submitted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

5.6.3 Creating a Form Fill Policy for Autosubmission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152

5.6.4 Creating Touch Files for Autosubmission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

6 Troubleshooting Access Manager Policies 155

6.1 Turning on Logging for Policy Evaluation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155

6.2 Understanding Policy Evaluation Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156

6.2.1 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157

6.2.2 Policy Result Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163

6.2.3 Role Assignment Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

6.2.4 Identity Injection Traces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165

6.2.5 Authorization Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167

6.2.6 Form Fill Traces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

6.3 Common Configuration Problems That Prevent a Policy from Being Applied as Expected. . . . . . .174

6.3.1 Enabling Roles for Authorization Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174

6.3.2 LDAP Attribute Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175

6.3.3 Result on Condition Error Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175

6.3.4 An External Secret Store and Form Fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176

6.4 The Policy Is Using Old User Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176

6.5 Form Fill and Identity Injection Silently Fail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177

6.6 Checking for Corrupted Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

6.7 Policy Page Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

6.8 Policy Creation and Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

6.9 Policy Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

6.10 Policy Evaluation: Access Gateway Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179

6.10.1 Successful Policy Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180

6.10.2 No Policy Defined Configuration Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181

6.10.3 Deny Access Configuration/Evaluation Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181

6 Contents

About This Guide 7

About This Guide

Thisguidedescribesthefollow ingfeaturesofNovellAccessManagerpolicies:

 Chapter 1,“ManagingPolicies,”onpage 9

 Chapter 2,“CreatingRolePolicies,”onpage 21

 Chapter 3,“CreatingAuthorizationPolicies,”onpage 61

 Chapter 4,“CreatingIdentityInjectionPolicies,”onpage 109

 Chapter 5,“CreatingFormFillPolicies,”onpage 127

 Chapter 6,“TroubleshootingAccessManagerPolicies,”onpage 155

Thisis

intendedtohelpyouunderstandandconfigureallofthepolicyfeaturesprovidedbyAccess

Managerandincludesadvancedtopics.

Itisrecommendedthatyoufirstbecomefamiliarwiththeinform ationintheNetIQAccessManager

3.1SP5SetupGuide,whichhelpsyouunderstandhowtoperformabasicIdentity

Server

configuration,setuparesourceprotectedbyanAccessGateway,andconfigureSSL.

Audience

ThisguideisintendedforAccessManageradministrators.Itisassumedthatyouhaveknowledgeof

evolvingInternetprotocols,suchas:

 ExtensibleMarkupLanguage(XML)

 SimpleObjectAccessProtocol(SOAP)

 SecurityAssertionMarkupLanguage(SAML)

 PublicKeyInfrastructure(PKI)digitalsignatureconceptsandInternetsecurity

 SecureSocketLayer/TransportLay erSecurity(SSL/TLS)

 HypertextTransferProtocol(HTTPandHTTPS)

 UniformResourceIdentifiers(URIs)

 DomainNameSystem(DNS)

 WebServicesDescriptionLanguage(WSDL)

Feedback

Wewanttohearyourcommentsandsuggestionsaboutthisguideandtheotherdocumentation

includedwiththisproduct.PleaseusetheUserCommentsfeatureatthebottomofeachpageofthe

onlinedocumentation,orgotoDocumentationFeedback(http://www.novell.com/documentation/

feedback.html)atwww.novell.com/documentation/feedback.htmlandenteryourcommentsthere.

Documentation Updates

ForthemostrecentversionoftheAccessManagerPoliciesGuide,visittheNovellAccessManager

DocumentationWebsite(http://www.novell.com/documentation/novellaccessmanager31).

8 Novell Access Manager 3.1 SP5 Policy Guide

Additional Documentation

Beforeproceeding,youshouldbefamiliarwiththeNetIQAccessManager3.1SP5InstallationGuide

andtheNetIQAccessManager3.1SP5SetupGuide,whichprovideinformationaboutinstallingand

settinguptheAccessManagersystem.

Thefollowingdevicereferenceguidesarealsoavailable:

 NetIQAccessManager3.1SP5IdentityServer

Guide

 NetIQAccessManager3.1SP5AdministrationConsoleGuide

 NetIQAccessManager3.1SP5AccessGatewayGuide

 NovellAccessManager3.1SP4SSLVPNServerGuide

 NetIQAccessManager3.1SP5J2EEAgentGuide

Documentation Conventions

InNovelldocumentation,agreater‐thansymbol(>)isusedtoseparateactionswithinastepand

itemsinacross‐referencepath.

1

Managing Policies 9

1

Managing Policies

Policiesarelogicalandtestablerulesthatyouusetomaintainorder,security,andconsistencywithin

yourAccessManagerinfrastructure.Youcanspecifyactivationcriteria,deactivationcriteria,

temporalconstraints(suchastimeofdayorsubnet),identityconstraints(suchasuserobjectattribute

values),andadditionalseparation‐of‐dutyconstraints.Identity

informationcancomefromany

identitysource(suchLDAP,anIdentityVault,oradirectory)orfromtheAccessManager’sIdentity

Server,whichprovidesfullLibertyAlliancespecificationsupportandSAML2.0support.Identityis

availablethroughoutthedeterminationofrightsandpermissions.

 Section 1.1,“SelectingaPolicyType,”onpage 9



Section 1.2,“PolicyPerformance,”onpage 10

 Section 1.3,“ManagingPolicies,”onpage 10

 Section 1.4,“ViewingPolicies,”onpage 13

 Section 1.5,“ManagingPolicyContainers,”onpage 13

 Section 1.6,“ManagingaRuleList,”onpage 14

 Section 1.7,“AddingPolicyExtensions,”onpage 16

 Section 1.8,“EnablingPolicyLogging,”onpage 20

1.1 Selecting a Policy Type

AccessManagerusesthepolicytypetodefinethecontextwithinwhichapolicyisevaluated.Each

typeofpolicydiffersinpurpose,whichinturndeterminestheconditionsandactionsthatapply.For

example,theconditionsandactionsofanAuthorizationpolicydifferfromtheconditionsandactions

ofan

IdentityInjectionpolicy.

WhenyouclickNewonthePoliciespage,thesystemdisplaysthepredefinedpolicy typesinadrop‐

downlist.Eachpolicytyperepresentsthesetofconditionsandactionsthatareavailable.Youthen

configurerulestodetermineuserroles,makedecisionrequests,andenforceauthorizationdecisions.



Youcanalsosetuppolicieswithnoconditions,allowingactionstoalwaystakeplace.Aspoliciesand

conditionsbecomecomplex,itcanbesimplerandmoremanageabletodesignpolicieswith

conditionsthatdenyorrestrictaccesstolargegroupsofusers,ratherthansettinguppoliciesthat

permit

accesstocertainusers.

AccessManagerhasthefollowingpolicytypes:

 AccessGateway:Authorization:Thispolicytypeisusedtopermitordenyaccesstoprotected

resources,suchasWebservers.Afteryouhavesetuptheprotectedresource,youusethepolicy

rulestodefinehowyouwanttorestrict

access.Forexample,ifauserisdeniedaccesstoa

resource,youcanuse thepolicytoredirectthemtoaURLwheretheycanrequestaccesstothe

resource.

10 Novell Access Manager 3.1 SP5 Policy Guide

 AccessGateway:IdentityInjection:ThispolicytypeevaluatestherulesforIdentityInjection,

whichretrievesidentitydatafromadatasource(userstore)andforwardsittoWebapplications.

Suchapolicycanenablesinglesign‐on.Aftertheuserhasauthenticated,thepolicysuppliesthe

informationrequiredbythe

resourceratherthanallowingtheresourcetopromptthe userfor

theinformation.

 AccessGateway:FormFill:Thispolicytypeisusedtocreateapolicythatautomaticallyfillsin

theinformationrequiredinaform,aftertheuserhasfilledintheformonce.Suchapolicycan

enablesingle

sign‐ontoresourcesthatrequireformdatabeforeallowingaccess.

 IdentityServer:Roles:Thispolicytypeevaluatesrulesforestablishingtherolesofan

authenticateduser.Rolesaregeneratedbasedonpolicystatementseachtimeauser

authenticates.RolesareplacedintoanAuthenticati onProfile,whichcanbeused

asinputin

policiesforAuthorizationorIdentityInjection.

 J2EEAgent:EJBAuthorization:Thispolicytypeallowsyoutocreatepoliciesthatprotectan

EnterpriseJavaBean.Youcanprotecttheentirebeanorspecificinterfacesormethods.

 J2EEAgent:WebAuthorization:Thispolicytypeallowsyoutocreatepoliciesthat

protectthe

Webapplications onaJ2EEserver.

1.2 Policy Performance

AuthorizationandIdentityInjectionpoliciesallowyoutoselectconditions,oneofwhichisRoles.If

youhavethousandsofusersaccessingyourresources,youmightwanttodesignmostofyour

policiestouse roles.Rolesareevaluatedwhenauserlogsin,andtherolesassignedtotheuser

are

cachedaslongasthesessionisactive.Whentheuseraccessesaresourceprotectedbyapolicythat

usesroleconditions,thepolicycanbeimmediatelyevaluatedbecausetheuser’srolevaluesare

available.Thisisnottrueforallconditions;thevaluesforsomeconditionsmustbe

retrievedfromthe

userstore.Forexample,ifthepolicyusesaconditionwithanLDAPattribute,theuser’svaluemust

beretrievedfromtheLDAPuserstorebeforethepolicycanbeevaluated.Onasystemwithmedium

traffic,thisdelaywon’tbenoticed.Onasystemwithhightraffic,

thedelaymightbenoticeable.

However,youcandesignyourpoliciestohavethesameresultswithoutcausingtheretrievalofthe

LDAPattributevalueatresourceaccess.YoucancreateaRolepolicyfortheLDAPattributeandhave

usersassignedtothisroleatauthenticationwhentheymatch

theattributevaluerequirements.When

theusersaccesstheresources,theygainimmediateaccess(orareimmediatelydeniedaccess)

becausetheirroleassignmentsarecached.

IfthesameLDAPattributepolicyisusedtograntaccesstomultipleresources,thechancethatthe

usernoticesadelayisslight.Thefirst

timeapolicyisevaluatedforauser,thedatarequiredforthe

policyiscachedandisthereforeimmediatelyavailablethenexttimeitisrequested.

AnotheroptionavailableforLDAPattributesistohavetheattributevaluessentwiththeassertionat

authentication.Youconfigureanattributeset

fortheattributes,andthenconfiguretheservice

providerfortheseattributes.Formoreinformation,see“ConfiguringtheAttributesSentwith

Authentication”intheNetIQAccessManager3.1SP5IdentityServerGuide.

Asyoudesignyourpolicies,experimentandfindthetypethatworksbestforyournetworkandyour



customers.

1.3 Managing Policies

1 IntheAdministrationConsole,clickPolicies>Policies.

2 InthePolicyContainerdrop‐downlist,selectthecontainer.

Ifyouhavenotcreatedanycontainers,onlytheMaster_Containerisavailableinthelist.

Managing Policies 11

3 Youcanperformthefollowingtasksfromthispage:

 “CreatingPolicies”onpage 11

 “SortingPolicies”onpage 11

 “DeletingPolicies”onpage 11

 “RenamingorCopyingaPolicy”onpage 11

 “ImportingandExportingPolicies”onpage 12

 “CreatingtheSSLVPNDefaultPolicy”onpage 12

 “RefreshingPolicyAssignments”onpage 12

1.3.1 Creating Policies

Beforecreatingpolicies,youneedtodesignyourpolicystrategy.Forexample,ifyouaregoingtouse

role‐basedaccess,youneedtodecidewhichrolesyouneedandwhichrolesallowaccesstoyour

protectedresources.Roles,whichareusedbyAuthorizationpoliciesthatgrantanddenyaccess,

need

tobecreatedfirst.Ifyouhavealreadycreatedtherolesandassignedthemtousersinyour

LDAPuserstore,youcanusethevaluesofyourroleattributesintheAuthorizationpoliciesrather

thanusingAccessManagerroles.

Tocreateapolicy,seethefollowingsections:

 Chapter 2,“CreatingRole

Policies,”onpage 21

 Chapter 3,“CreatingAuthorizationPolicies,”onpage 61

 Chapter 4,“CreatingIdentityInjectionPolicies,”onpage 109

 Chapter 5,“CreatingFormFillPolicies,”onpage 127

1.3.2 Sorting Policies

Policiescanbesortedbynameandbytype.OnthePoliciespage,clickNameinthePolicyList,andthe

policiesaresortedalphabeticallybyname.Tosortalphabeticallybytype,clickTypeinthePolicyList.

Youcanalsousecontainerstoorganizeyourpolicies.Formoreinformation,

seeSection 1.5,

“ManagingPolicyContainers,”onpage 13.

1.3.3 Deleting Policies

Apolicycannotbedeletedaslongasaresourceisconfiguredtousethepolicy.ForAccessGateway

andJ2EEAgentpolicies,thismeansthatyoumustremovethepolicyfromallprotectedresources.

RolescanbeusedbyAuthorization,FormFill,andIdentityInjectionpolicies.Beforeyoucandelete

a

Rolepolicy,youmustremoveanyreferencetotherolefromallotherpolicies.

1.3.4 Renaming or Copying a Policy

Copy:Tocopyapolicy,sel ecta policy,clickCopy,thenclickOK.Thenewpolicyisnamed“Copyof

...”Thisisusefulwhenyouarecreatingmultiplepoliciesthatrequireonlyminorvariationstomake

themunique.Youshouldrenamethepolicyaftermakingthesemodifications.

Rename:To

renameapolicy,selectapolicy,clickRename,specifyanewname,thenclickOK.

12 Novell Access Manager 3.1 SP5 Policy Guide

1.3.5 Importing and Exporting Policies

PoliciesthatarecreatedintheAdministrationConsolecanbeexportedandusedinanother

AdministrationConsolethatismanagingadifferentgroupofAccessGatewaysandotherdevices.

Eachpolicytypehasslightlydifferentimportrequirements.Seethefollowing:

 Section 2.7,“ImportingandExportingRolePolicies,”onpage 60

 Section 3.7,“Importingand

ExportingAuthorizationPolicies,”onpage 107

 Section 4.8,“ImportingandExportingIdentityInjectionPolicies,”onpage 124

 Section 5.5,“ImportingandExportingFormFillPolicies,”onpage 148

1.3.6 Creating the SSL VPN Default Policy

TocreatethedefaultpolicythattheSSLVPNserveruses,clicktheCreateSSLVPNDefaultoption.

ThisoptioncreatesanIdentityInjectionpolicythatisusedtosetupsinglesign‐onwiththeSSLVPN

server.Afteryouhavecreatedthispolicy,thisoptionisnolongeravailable.

1.3.7 Refreshing Policy Assignments

Ifyouhavemadechangesinpolicyassignmentsthatarenotreflectedonthepage,clickRefresh

References.Thisactioncantakeawhiletocompleteifyouhavenumerouspoliciesandhaveassigned

themtoprotectnumerousresources.TheAdministrationConsoleneedstoverifytheconfiguration

ofeachdevice.

1.3.8 Viewing Policy Information

ThePolicyListtabledisplaysthefollowinginformationabouteachpolicy.

Column Description

Name Displays the name of the policy. To modify a policy, click its name.

Type Specifies the type of policy (Authorization, Identity Injection, Roles, or Form Fill) and

the type of resource that can use it (Identity Server, Access Gateway, or J2EE

Agent).

Used By Displays the name of the Access Gateway, the Identity Server configuration, or the

J2EE Agent that the policy is assigned to. If the policy is unassigned, this column

has no value.

If the policy is assigned to a protected resource, click the down-arrow button to view

the names of the resources it has been assigned to.

Extensions Used Specifies whether the policy uses any extensions. If none has been used, this

column has no value.

Description Displays a description of the policy. If no description has been specified, this

column has no value.

Managing Policies 13

1.4 Viewing Policies

TheypolicyviewadministratorscanlogintoAccessManagerwiththeircredentialsandtheyare

allowedtoviewonlythepolicycontainersassignedtothem.

1 LogintoAccesssManager.

2 InthePolicyContainerdrop‐downlist,selectthecontainer.

ThePolicyListtabledisplaysthefollowinginformationabouteachpolicy.

1.5 Managing Policy Containers

Youusepolicycontainerstostoreandorganizepolicies,similartohowyouorganizefilesinfol ders.

TheMaster_Containerisapermanentpolicycontainer,butyoucanusetheContainerstabtocreate

newcontainers.

Apolicycontainercanholdupto500policies.Whenyoureachthatlimit,youmust

createanother

containertoadd,copy,orimportpolicies.Forperformanceandforeaseinfindingapolicy,youmight

wanttolimitacontainerto200orfewerpolicies.Policiesinacontainercanbesortedbynameand

type,toaidyouinfindingaparticularpolicy.

If

youhaveonlyoneadministra torconfiguringandmanagingpolicies,youcancreateadditional

policycontainerstohelpyoukeeppoliciesorganized.Ifyouhavemultipleadministratorscreating

policies,youcancreateacontainerforeachadministratortouse.Thisallowsmultipleadministrators

tomodifypoliciesatthesametime.Whenan

administratoropensapolicyinacontainer,the

containerislocked,whichpreventsotheradministratorsfrommodifyinganypoliciesinthat

containeruntilchangesareappliedorcanceled.

1 IntheAdministrationConsole,clickPolicies>Containers.

2 OntheContainerspage,clickNew .

3 Namethepolicycontainer,thenclickOK.

4 ClickClose.

Afteryouaddapolicycontainer,thesystemdisplaysitinthePolicyContainerdrop‐downliston

thePolicyListpage.

Youmustdeleteallthepoliciesinapolicycontainerbeforeyoucandeletethepolicycontainer.

1 Selectthecheckboxofthepolicycontainer.ClickDelete.AConfirmdialogboxdisplaysa

messageʺNumberofContainersselected:1,DeleteselectedContainers?ʺ

2 ClickOktocontinueorCanceltoclosethewindow

Column Description

Name Displays the name of the policy.

Type Specifies the type of policy (Authorization, Identity Injection, Roles, or Form Fill) and

the type of resource that can use it (Identity Server, Access Gateway, or J2EE

Agent).

Description Displays a description of the policy. If no description has been specified, this

column has no value.

14 Novell Access Manager 3.1 SP5 Policy Guide

1.6 Managing a Rule List

Youconfigurerulestocreateapolicy.Therulescollectivelyrepresentadesiredcourseofactionwhen

therequiredconditionsaremet,suchasdenyingentry‐levelemployeesaccesstoasecureWebsite,

andpermittingaccessforemployeeswhohavearoleofManager.

Whenthesystemevaluatesthepolicy

conditions,itbeginswiththerulewiththehighestpriorityand

evaluatestheconditions,startingwiththefirstconditiongroupintherule.Eachrulecontainsoneor

moreconditionsandoneormoreactions.Ifarule’sconditionsaremet,therule’sactionisperformed.

Forsomepolicytypes,the

performanceofanyrule’sactionterminatesthepolicyevaluation.With

Authorizationpolicies,forexample,afterthepolicyhasdeterminedthatauseriseitherpermittedor

deniedaccesstoaresource,thereisnoreasontoevaluatethepolicyfurther.However,aRolepolicy

mightidentifymultiplerolestowhich

auserbelongs.Inthiscase,eachruleofthepolicymustbe

evaluatedtodetermineallrolestowhichtheuserbelongs.

IMPORTANT:Theinterfaceforthepolicyengineisdesignedforflexibility.Itdoesnotprotectyou

fromcreatingrulesthatdonothingbecausetheyarealwaystrueoralwaysfalse.Forexample,you

cansetupaconditionwhereClientIPisequaltoClientIP,whichisalwaystrue.

Youareresponsible

fordefiningtheconditionsothat itdoesameaningfulcomparison.

Tomanagethelistofrulesforapolicy:

1 IntheAdministrationConsole,clickPolicies>Policies.

2 Selectthecontainer.

3 Clickthenameofthepolicy.

4 IntheRuleListsection,selectoneofthefollowing:

New:Tocreateanewrule,clickNew.

Youusemultiplerulestocoordinatehowapolicyoperates,andthebehaviorvariesaccordingto

thepolicytype.Tounderstandhowmultiplerulesareevaluated,seethefollowing:

 Section 1.6.1,“RuleEvaluationfor

RolePolicies,”onpage 14

 Section 1.6.2,“RuleEvaluationforAuthorizationPolicies,”onpage 15

 Section 1.6.3,“RuleEvaluationforIdentityInjectionandFormFillPolicies,”onpage 15

Delete:Selectarule,thenclickthisoptiontodeletetherule.Ifthepolicyhasonlyonerule,you

cannotdeletethelastrule.

Copy:Select

arule,thenclickthisoptiontocopyarule.Tomodifythecopy,clicktherule

number.

Enable:Selectarule,thenclickthisoptiontoenablearule.

Disable:Selectarule,thenclickthisoptiontodisablearule.

5 ClickOK,thenclickApplyChanges.

1.6.1 Rule Evaluation for Role Policies

ARolepolicyisusedtodeterminewhichroleorrolesauserisassignedto.However,youcanspecify

onlyoneroleperrule.Rolepoliciesareevaluatedwhenauserauthenticates.Rolepoliciesdonot

directlydenyorallowaccesstoanyresource,nordotheydetermineifa

userisauthenticated.A

user’srolecanbeusedintheevaluationofanAuthorizationpolicy,butatthatpointtheevaluationof

therolepolicyhasalreadyoccurredandisnotdirectlypartoftheauthorizationprocess.The

performanceofanaction(assigningausertoarole)does

notterminatetheevaluationofthepolicy,

sosubsequentrulesinthepolicycontinuetobeevaluated.

Managing Policies 15

1.6.2 Rule Evaluation for Authorization Policies

WhentheAccessGatewaydiscoversaruleinanAuthorizationpolicythateitherpermitsordeniesa

useraccesstoaprotectedresource,itstopsprocessingtherulesinthepolicy.Usethefollowing

guidelinesindeterminingwhetheryourAuthorizationpolicyneedsmultiplerules:

 Ifthepolicyenforcesmultipleaccessrequirements

thatcanresultindifferingactions(either

permitordeny),useseparaterulestodefinetheconditionsandactions.

 Ifyouwantotherconditionsoractionsprocessedwhenarulefails,youmustcreateasecond

rulefortheusersthatfailtomatchtheconditions.

Ifyoucreatemultiplerules,

youcanmodifytheorderthattherulesareprocessed.Thisallowsyouto

createpoliciesthatcontainanumberofPermitrulesthatallowaccessiftheusermatchestherule.

ThelowestpriorityruleinsuchapolicyisaDenyrule,whichdeniesaccesstoeveryonewho

hasnot

previouslymatchedaPermitrule.

IMPORTANT:IfyoucreatepolicieswithmultiplePermitrules,youshouldmakethelastruleinthe

policyagenericdenypolicy(arulewithnoconditionsandwithanactionofdeny).Thisensuresthat

iftheResultonErrorConditionfieldinaruleissetincorrectly,the

usermatchesthelastruleandis

deniedaccess.Withoutthisrule,ausermightgainaccessbecausetheuserdidn’tmatchanyofthe

rules.

Youcanalsocreateanumberofpoliciesandenablemultiplepoliciesforthesameprotectedresource.

Ruleprioritydetermineshowtheenabledpoliciesinteractwitheachother.Therulesinthepolicies

aregatheredintoonelist,thensortedbypriority.Theprocessingrulesareappliedasifthe

rulescame

fromonepolicy.Itisapersonaldesignissuewhetheryoucreateapolicywithmultiplerulesorcreate

multiplepoliciesthatyouenableonasingleprotectedresource.Eitherdesignproducesalistofrules,

sortedbypriority,thatisappliedtotheuserrequestingaccesstothe

protectedresource.

1.6.3 Rule Evaluation for Identity Injection and Form Fill Policies

RulesinIdentityInjectionand FormFillpolicieshaveactions,butnoconditions.Becaus etheyhave

noconditions,alltherulesareevaluatedandtheactionsareperformed.IdentityInjectionpolicies

havetwoexceptionstothisrule;theycaninsertonlyoneauthenticationheaderandonecookie

header.Ifyoucreate

multiplerules,eachwithanauthenticationheaderandacookieheader,therule

withthehighestpriorityisprocessedanditsactionsperformed.Theactionsinthesecondrulefor

injectinganauthenticationheaderandacookieheaderareignored.

YoucannotcreatemultiplerulesforaFormFillpolicy.

1.6.4 Viewing Rules

Thepolicyviewadministratorscanviewtheinformationrelatedtorules.Therulescollectively

representadesiredcourseofactionwhentherequiredconditionsaremet,suchasdenyingentry‐

levelemployeesaccesstoasecureWebsite,andpermittingaccessforemployeeswhohavearoleof

Manager.

Whenthesystem

evaluatesthepolicyconditions,itbeginswiththerulewiththehighestpriorityand

evaluatestheconditions,startingwiththefirstconditiongroupintherule.Eachrulecontainsoneor

moreconditionsandoneormoreactions.Ifarule’sconditionsaremet,therule’sactionisperformed.

Forsome

policytypes,theperformanceofanyrule’sactionterminatesthepolicyevaluation.

16 Novell Access Manager 3.1 SP5 Policy Guide

Toviewthelistofrulesforapolicy:

1 IntheAdministrationConsole,clickPolicies>Policies.

2 Selectthecontainer.

3 Clickthenameofthepolicy.

4 IntheRuleListsection,thepolicyviewadministratorcanviewthefollowingdetails.

Type:Displaysthetypeofthepolicy.

Description:Displaysthedescriptionofthepolicytype.

Priority:Displaysthepriorityoftherulenumbertothepolicytype.

Actions:Displaystheactionsforthepolicytype.

1.7 Adding Policy Extensions

IfAccessManagerdoesnotsupplytheaction,thedatatype,ortheconditionthatyouneedfora

policy,youcanaddacustomizedpolicyextension.Forexample,supposeyouneedapolicythat

permitsaccessbasedonwhetherauserhasaspecificrolewhichisassignedtousers

inanOracle

database.ThecustomextensioncouldreadtheroleassignmentsoftheuserfromtheOracledatabase

andreturnastringcontainingtherolenames.Thisdatacouldthenbeusedtodetermineaccessrights

toAccessManagerresources.Forinformationonhowtocreateapolicyextension,

seetheNovell

AccessManagerDeveloperKit(http://developer.novell.com/wik i/index.php/

Novell_Access_Manager_Developer_Tools_and_Examples).

Afterapolicyextensionhasbeencreated,youneedtoperformthefollowingtaskstousethe

extension:

 Section 1.7.1,“InstallingtheExtensionontheAdministrationConsole,”onpage 16

 Section 1.7.2,“DistributingaPolicyExtension,”onpage 18

Afteryouhaveconfiguredtheextension,

youcanperformthefollowingtasks:

 Section 1.7.3,“ManagingaPolicyExtensionConfiguration,”onpage 19

 Section 1.7.4,“ViewingExtensionDetails,”onpage 19

1.7.1 Installing the Extension on the Administration Console

Thepolicyextensioncanbedeliveredaseithera

.jar

fileora

.zip

file.

 “UploadingandConfiguringaJARFile”onpage 16

 “ImportingaZIPFile”onpage 18

Uploading and Configuring a JAR File

Toinstallanextension,youneedtohaveaccesstothe

.jar

fileandknowthefollowinginformation

abouttheextensionorextensionscontainedwithinthefile.

What you need to create

 A display name for the extension.

 A description for the extension.

Managing Policies 17

Ifthefilecontainsmorethanoneextension,youneedtocreateaconfigurationforeachextensionin

thefile.

1 Copythe

.jar

filetoalocationthatyoucanbrowsetofromtheAdministrationConsole.

2 IntheAdministrationConsole,clickPolicies>Extensions.

3 Touploadthefile,clickUpload>Browse,selectthefile,thenclickOpen.

4 (Conditional)Ifyouwantthis

.jar

filetooverwriteanexistingversionofthefile,select

Overwriteexisting*.jarfile.

5 ClickOK.

ThefileisuploadedtotheAdministrationConsole,butnothingisvisibleontheExtensionspage

untilyoucreateaconfiguration.

6 Tocreateanextensionconfiguration,clickNew,thenfillinthefollowingfields:

Name:Specifyadisplaynamefortheextension.

Description:(Optional)Specifythepurposeoftheextensionandhowitshouldbeused.

PolicyType:Fromthedrop‐downlist,selectthetypeofextensionyouhaveuploaded.

Type:From

thedrop‐downlist,selectthedatatypeoftheextension.

ClassName:Specifythenameoftheclassthatcreatestheextension,suchas

com.acme.policy.action.successActionFactory.

FileName:Fromthedrop‐downlist,selectthe

.jar

filethatcontainstheJavaclassthat

implementstheextensionanditscorrespondingfactory.Thisshouldbethefileyouuploadedin

Step 3.

7 ClickOK.

What you need to know

 The policy type of the extension, which defines the policy type it can be used

with. You should know whether it is an extension for an Access Gateway

Authorization policy, an Access Gateway Identity Injection policy, or an Identity

Server Role policy.

 The name of the Java class that is used by the extension. Each data type

usually uses a different Java factory class.

 The filename of the extension.

 The names, IDs, and mapping type of any configuration parameters.

Configuration parameters allow the policy engine to pass data to the extension,

which the extension can then use to retrieve data or to evaluate a condition.

 The type of data the extension manipulates.

Authorization Policy: Can be used to return the following:

 An action of deny, permit, or obligation.

 A condition that the extension evaluates and returns either true or false.

 A data element that the extension retrieves and the policy can use for

evaluating a condition.

Identity Injection Policy: A data extension that retrieves data for injecting into a

header.

Identity Role Policy: Can be used to return the following:

 A condition that the extension evaluates and returns either true or false.

 A data element that the extension retrieves which can be used in evaluating a

condition or used to assign roles.

18 Novell Access Manager 3.1 SP5 Policy Guide

8 (Conditional)IftheextensionrequiresdatafromAccessManager,clickthenameofthe

extension.

9 IntheConfigurationParameterssection,clickNew,specifyanameandID,thenclickOK.

ThedeveloperoftheextensionmustsupplythenameandIDthattheextensionrequires.

10 IntheMappingcolumn,clickthedown‐arrow,thenselecttherequireddatatype.

Thedeveloperoftheextensionmustsupplythedatatypethatisrequired.Ifthedatatypeisa

datastring,thenthe developerneedstoexplainthetypeofinformationyouneedtosupplyin

the

textfield.

11 (Conditional)Iftheextensionrequiresmorethanonedataitem,repeatStep 9andStep 10.

12 ClickOK.

Theextensionisnowavailableforthepolicytypeitwascreatedfor.

13 (Conditional)Iftheclasscanbeusedformultiplepolicytypes,youneedtocreateanextension

configurationforeachpolicytype.

Forexample,ifanextensioncanbeusedforbothanIdentityInjectionpolicyandaRole policy,

youneedtocreateanentryforboth.TheFileName

optionshouldcontainthesamevalue,butthe

otheroptionsshouldcontainuniquevalues.

14 ContinuewithSection 1.7.2,“DistributingaPolicyExtension,”onpage 18.

Importing a ZIP File

A

.zip

filewithanex portedextensioncontainsboththe

.jar

fileandtheextensionconfiguration.

1 Copythe

.zip

filetoalocationthatyoucanbrowsetofromtheAdministrationConsole.

2 IntheAdministrationConsole,clickPolicies>Extensions.

3 Touploadthefile,clickUpload>Browse,selectthefile,thenclickOpen.

4 (Conditional)Ifyouwantthe

.jar

fileinthe importtooverwriteanexistingversionofthefile,

selectOverwriteexisting*.jarfile.

5 ClickOK.

TheextensionisimportedintheAdministrationConsole.

6 (Conditional)Iftheextensionrequiressomecustomizing,clickthenameoftheextensionand

followtheinstructionsthatcamewiththeextension.

7 ContinuewithSection 1.7.2,“DistributingaPolicyExtension,”onpage 18.

1.7.2 Distributing a Policy Extension

Todistributedthepolicyextensiontothedevicesthatneedit:

1 Createapolicythatusestheextension:

 RolePolicy:TocreateaRolepolicythatusestheextension,seeSection 2.2,“Creating

Roles,”onpage 25.

 IdentityInjectionPolicy:TocreateanIdentityInjectionpolicythatusestheextension,see

Section 4.2,“ConfiguringanIdentityInjectionPolicy,”onpage 111.

 AuthorizationPolicy:Tocreate

anAuthorizationpolicythatusestheextension,see

Section 3.2,“CreatingAccessGatewayAuthorizationPolicies,”onpage 71.

2 Assignthepolicytoadevice:

 ForaRolepolicy,enableitforanIdentityServer.

Managing Policies 19

Formoreinformation,seeSection 2.6,“EnablingandDisablingRolePolicies,”onpage 60.

 ForanAuthorizationpolicy,assignittoaprotectedresource.

Formoreinformation,see“AssigninganAuthorizationPolicytoaProtectedResource”in

theNetIQAccessManager3.1SP5AccessGatewayGuide.

 ForanIdentityInjectionpolicy,

assignittoaprotectedresource.

Formoreinformation,see“AssigninganIdentityInjectionPolicytoaProtectedResource”

intheNetIQAccessManager3.1SP5AccessGatewayGuide.

IMPORTANT:Donotupdatethedeviceatthistime.The

.jar

filesmustbedistributedbefore

youupdatethedevice.

3 Distributethe

.jar

files:

3a ClickPolicies>Extensions.

3b Selecttheextension,thenclickDistributeJARs.

3c RestartTomcatonthedeviceslistedforreboot.

 Linux:Enterthefollowingcommand:

/etc/init.d/novell-tomcat5 restart

 Windows:Enterthefollowingcommands:

net stop Tomcat5

net start Tomcat5

4 (Conditional)IftheextensionisforanAuthorizationpolicyoranIdentityInjectionpolicy,

updatetheAccessGateway.

1.7.3 Managing a Policy Extension Configuration

1 IntheAdministrationConsole,clickPolicies>Extensions.

2 Toexportapolicyextension,selectthepolicy,thenclickExport.

3 Todeleteanextension,apolicycannotbeusingit.UsetheUsedBycolumntodeterminethe

policiesthatareusingtheextension.Modifythelistedpolicies.Whentheextensionisnolonger

usedbyanypolicies,selecttheextension,thenclickDelete.

4 Torenameapolicyextension,selecttheextension,clickRename,specifyanewname,thenclick

OK.Whenapolicyextensionisrenamedandtheextensionisinusebyapolicy,thepolicyis

updated.ThiscausestheApplyChangesbuttontobeactiveonthePolicyListpage.

1.7.4 Viewing Extension Details

YoucanmodifythedetailsofanexistingextensionandcontroltheinformationAccessManager

providestotheextensionwhenthedataisevaluated.

1 IntheAdministrationConsole,clickPolicies>Extensions.

2 Clickthenameoftheextension.

Youcan viewormodifythefollowingdetails:

Description:(Optional)Specifiesthepurposeoftheextensionandhowitshouldbeused.

ClassName:Specifiesthenameoftheclassthatcreatestheextension,forexample

com.acme.policy.action.successActionFactory.

FileName:Specifiesthe

.jar

filethatcontainstheJavaclassthatimplementstheextensionand

itscorrespondingfactory.Selecttheappropriatefilefromthedrop‐downlist.

20 Novell Access Manager 3.1 SP5 Policy Guide

3 (Conditional)SpecifytheConditionParametersrequiredbytheextension.

Thedocumentationfortheextensionshouldtellyouthenumberofparametersitrequiresand

thedatatypeofeachparameter.YoucreatethenameandIDfortheparameter,andtheyneedto

beuniquefortheextension.

 Toadda

configurationparameter,clickNew,enteraname(astring)andanID(anumber)

fortheparameter,thenclickOK.IntheMappingfield,clickthedown‐arrow,thenselectthe

dataitemfromthelist.Theselecteddataisavailablewhenevertheextensionclassiscalled

toevaluatean

action,acondition,ordata.

 Todeleteaconfigurationparameter,selecttheparameter,thenclickDelete.

4 ClickOK.

1.8 Enabling Policy Logging

Policyloggingisexpensive;itusesprocessingtimeanddiskspace.Inaproductionenvironment,you

shouldenableitonlyunderthefollowingtypesofconditions:

 Youhavecreatedanewpolicyandneedtoverifyitsfunctionality.

 Youare troubleshootingapolicythatisnotbehavingasexpected.

Togather

troubleshootinginformation,youshouldenabletheFileLoggingandEchoToConsole

optionsintheIdentityServerconfigurationandsettheComponentFileLoggerLevelsforApplicationto

atleastinfo.ThenyoumustupdatetheIdentityServerconfigurationandrestartanyAccessGateway

EmbeddedServiceProviders,sothatthe

EmbeddedServiceProvidersreadtheloggingoptions.See

“ConfiguringComponentLogging”intheNetIQAccessManager3.1SP5IdentityServerGuide.When

youhavesolvedtheproblem,youshoulddisabletheseoptions.

Thelogfileonthecomponentthatexecutedthepolicyiswhereyoushouldlookforlogging

information.Forexample,ifyouhaveanAccessGateway:Authorizationerror,lookatthelogonthe

AccessGatewaythatexecutedthepolicy.

Foradditionalpolicytroubleshootingprocedures,seeChapter 6,“TroubleshootingAccessManager

Policies,”onpage 155.

Page is loading ...

Novell Access Manager 3.1 SP4 User guide

Related papers

Other documents