Page is loading ...
Novell®
www.novell.com
AUTHORIZED DOCUMENTATION
Identity Manager Roles Based Provisioning
Module
4.0.1
May 10, 2012
User Application: Administration Guide
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 (http://www.novell.com/company/policies/trade_services/) page for more
information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary
export approvals.
Copyright © 2010 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.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get
updates, see www.novell.com/documentation (http://www.novell.com/documentation).
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark (http://www.novell.com/company/legal/
trademarks/tmlist.html) list.
Third-Party Materials
All third-party trademarks are the property of their respective owners.
4 User Application: Administration Guide
Contents 5
Contents
About This Guide 17
Part I Overview 19
1 Introduction to the User Application 21
1.1 About the User Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
1.1.1 About Identity Self-Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1.1.2 About Roles-Based Provisioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1.1.3 About Resource-Based Provisioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.1.4 About Workflow-Based Provisioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.1.5 About Compliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.2 User Application Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.2.1 User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.2.2 Directory Abstraction Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.2.3 Workflow Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.2.4 SOAP Endpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.2.5 Application Server (J2EE-Compliant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.2.6 Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.2.7 User Application Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.2.8 Role and Resource Service Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.2.9 Designer for Identity Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.2.10 iManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.2.11 Identity Manager Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.2.12 Identity Vault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.2.13 Novell Identity Audit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.3 User Application User Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.3.1 Administrative Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.3.2 Domain Administrators, Domain Managers, and Team Managers . . . . . . . . . . . . . . 35
1.3.3 Designers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
1.3.4 Business Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
1.4 Design and Configuration Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.5 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Part II Configuring the User Application Environment 45
2 Designing the Production Environment 47
2.1 Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.1.1 Design Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.1.2 High Availability Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
2.2 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
2.2.1 Security Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.2.2 Self-Signed Certificates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
2.2.3 Enabling SSL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
2.2.4 Turning on SOAP Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.2.5 Mutual Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
2.2.6 Third-Party Authentication and Single Sign-On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
2.2.7 Encryption of Sensitive User Application Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
2.2.8 Preventing XSS Attacks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
6 User Application: Administration Guide
2.2.9 Modifying the Trustee Rights for User Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.2.10 Modifying the Trustee Rights for a Provisioning Request Definition . . . . . . . . . . . . . 57
2.2.11 Disabling the JMX Management Console on JBOSS . . . . . . . . . . . . . . . . . . . . . . . . 58
2.3 Single Sign On (SSO) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.4 Enabling Anonymous or Guest Access to the User Application. . . . . . . . . . . . . . . . . . . . . . . . 58
2.4.1 Establishing the Guest Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
2.5 Configuring Forgotten Password Self-Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
2.5.1 Accessing an External Password WAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
2.6 Performance Tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.6.1 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.6.2 Identity Vault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
2.6.3 JVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.6.4 Session Time-out Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.6.5 Tuning JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.6.6 Using Secure Sockets for User Application Connections to the Identity Vault . . . . . 65
2.7 Clustering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.7.1 Clustering an Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.7.2 Things to Do Before Installing the User Application . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.7.3 Installing the User Application to a JBoss Cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.7.4 Installing the User Application to a WebSphere Cluster . . . . . . . . . . . . . . . . . . . . . . 75
2.7.5 Installing the User Application to a WebLogic Cluster. . . . . . . . . . . . . . . . . . . . . . . . 75
2.7.6 Things to Do After Installing the User Application . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.8 Localizing and Customizing User Application Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
2.8.1 Localizing User Application Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
2.8.2 Customizing Text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
2.8.3 Ensuring that Characters Display Properly in Role Report PDF Files. . . . . . . . . . . . 83
2.9 Configuring the Roles and Resources Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
2.9.1 Role Service Driver Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
2.9.2 User Application Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
2.9.3 Security Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
2.9.4 View Request Status Search Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
2.9.5 Provisioning Display Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
2.9.6 E-Mail Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
2.9.7 Enabling Drivers for Resource Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
2.9.8 Creating a List in the RBPM Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
2.10 Configuring the Compliance Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
2.10.1 Security Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
2.10.2 E-Mail Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
2.11 Configuring the Work Dashboard Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
2.12 Recreating the Database After Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
2.13 Changing the Default Administrator Assignments After Installation. . . . . . . . . . . . . . . . . . . . . 95
2.13.1 Granting or Removing Assignments in the User Application. . . . . . . . . . . . . . . . . . . 96
2.13.2 Changing the Assignments in Configupdate Without Removing the Existing Users . 96
2.13.3 Changing the Assignments in Configupdate and Removing the Existing Users . . . . 97
2.14 Setting up JMS in WebSphere and WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
2.14.1 Setting up JMS on WebSphere 6.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
2.14.2 Setting up JMS on WebSphere 7.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
2.14.3 Setting up JMS on WebLogic 10.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
3 Setting Up Logging 109
3.1 About Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
3.1.1 About the Log Level Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
3.1.2 Changing the User Application Log Level Settings . . . . . . . . . . . . . . . . . . . . . . . . . 110
3.2 Logging to a Novell Identity Audit or Sentinel Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Contents 7
3.2.1 Adding the Identity Manager Application Schema to your Novell Identity Audit Server as
a Log Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.2.2 Enabling Audit or Sentinel Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.2.3 Log Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.3 Logging to OpenXDAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
3.3.1 Using OpenXDAS with Sentinel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
3.3.2 Enabling OpenXDAS Logging in the User Application . . . . . . . . . . . . . . . . . . . . . . 117
3.3.3 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
3.4 Log Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Part III Administering the User Application 125
4 Using the Administration Tab 127
4.1 About the Administration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.2 Who Can Use the Administration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.3 Accessing the Administration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.4 Administration Tab Actions You Can Perform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
5 Application Configuration 131
5.1 Portal Configuration Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
5.1.1 Caching Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
5.1.2 Driver Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
5.1.3 Identity Vault Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
5.1.4 Logging Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
5.1.5 Portal Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
5.1.6 Single Sign On (SSO) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
5.1.7 Theme Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
5.1.8 Assigning the User Application Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
5.2 Working with the Import and Export Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.2.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.2.2 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.2.3 Exporting Portal Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.2.4 Importing Portal Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
5.3 Password Management Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5.3.1 About Password Management Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
5.3.2 Configuring Challenge Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
5.3.3 Configuring Forgotten Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
5.3.4 Configuring Login. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
5.3.5 Configuring Password Sync Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
5.3.6 Configuring Password Hint Change. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
5.3.7 Configuring Change Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
5.4 Web Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
5.4.1 Directory Layer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
5.4.2 Metrics Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
5.4.3 Notification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
5.4.4 Provisioning Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
5.4.5 Role Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
6 Page Administration 203
6.1 About Page Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
6.1.1 About Container Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
6.1.2 About Shared Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
6.1.3 An Exception to Page Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
8 User Application: Administration Guide
6.2 Creating and Maintaining Container Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
6.2.1 Creating Container Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
6.2.2 Adding Content to a Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
6.2.3 Deleting Content from a Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
6.2.4 Modifying the Layout of a Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.5 Arranging Content on the Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.6 Displaying a Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3 Creating and Maintaining Shared Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.1 Creating Shared Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2 Adding Content to a Shared Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.3 Deleting Content from a Shared Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
6.3.4 Modifying the Layout of a Shared Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.3.5 Arranging Content on the Shared Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.3.6 Displaying a Shared Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
6.4 Assigning Permissions for Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
6.4.1 Assigning Page View Permission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
6.4.2 Assigning Shared Page Owners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
6.4.3 Enabling User Access to the Create User or Group Page. . . . . . . . . . . . . . . . . . . . 232
6.4.4 Enabling User Access to Individual Administration Pages . . . . . . . . . . . . . . . . . . . 233
6.5 Setting Default Pages for Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
6.6 Selecting a Default Shared Page for a Container Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
7 Portlet Administration 237
7.1 About Portlet Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
7.2 Administering Portlet Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
7.2.1 Accessing Portlet Definitions in the Deployed Portlet Application . . . . . . . . . . . . . . 238
7.2.2 Registering Portlet Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
7.2.3 Viewing Information About Portlet Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
7.3 Administering Registered Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.3.1 Accessing Portlet Registrations in the Deployed Portlet Application. . . . . . . . . . . . 242
7.3.2 Viewing Information about Portlet Registrations . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.3.3 Assigning Categories to Portlet Registrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
7.3.4 Modifying Settings for Portlet Registrations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.5 Modifying Preferences for Portlet Registrations . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.6 Assigning Security Permissions for Portlet Registrations . . . . . . . . . . . . . . . . . . . . 248
7.3.7 Unregistering a Portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
8 RBPM Provisioning and Security Configuration 253
8.1 About RBPM Provisioning and Security Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.2 Provisioning Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.2.1 Configuring Delegation and Proxy Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
8.2.2 Configuring the Provisioning UI Display Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 256
8.2.3 Configuring the Workflow Engine and Cluster Settings. . . . . . . . . . . . . . . . . . . . . . 262
8.3 Administrator Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
8.3.1 Viewing Administrator Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
8.3.2 Creating New Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
8.3.3 Editing an Existing Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
8.3.4 Deleting Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
8.3.5 Refreshing the Assignment List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
8.4 Team Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
8.4.1 Viewing Team Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
8.4.2 Creating New Teams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
8.4.3 Editing an Existing Team. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
8.4.4 Deleting Teams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
8.4.5 Refreshing the Team List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Contents 9
8.5 Navigation Access Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Part IV Portlet Reference 291
9 About Portlets 293
9.1 Accessory Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.2 Admin Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3 Identity portlets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.4 System Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
10 Create Portlet Reference 297
10.1 About the Create portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
10.2 Configuring the Create Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
10.2.1 Directory Abstraction Layer Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
10.3 Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
10.4 Configuring the Create Portlet for Self-Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
10.4.1 Guest Access Required Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
11 Detail Portlet Reference 305
11.1 About the Detail portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
11.1.1 Displaying Entity Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
11.1.2 Editing Entity Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
11.1.3 E-Mailing Entity Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
11.1.4 Linking to an organization chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
11.1.5 Linking to Details of Other Entities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
11.1.6 Printing Entity Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
11.1.7 Setting Preferred Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
11.1.8 Overriding the Default Entity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
11.2 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
11.2.1 Configuring the Directory Abstraction Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
11.2.2 Assigning rights to entities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
11.3 Launching Detail from Other Portlets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
11.3.1 Launching Detail from the Search List Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
11.3.2 From the Org Chart Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
11.4 Using Detail on a Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
11.5 Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
11.5.1 About the Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
11.6 Setting up Detail for Anonymous Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
12 Org Chart Portlet Reference 323
12.1 About Org Chart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
12.1.1 About Org Chart Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
12.1.2 About Org Chart Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
12.2 Configuring the Org Chart Portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
12.2.1 Directory Abstraction Layer Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
12.2.2 Setting Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
12.2.3 Dynamically Loading Images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
12.3 Configuring Org Chart for Guest Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
12.3.1 Modifying the Org Chart Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
12.3.2 Modifying the User Application WAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
10 User Application: Administration Guide
13 Resource Request Portlet 353
13.1 About the Resource Request Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
13.2 Configuring the Resource Request Portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
13.2.1 Setting Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
14 Search List Portlet Reference 355
14.1 About Search List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
14.1.1 About Results List Display Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
14.2 Configuring the Search List portlet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
14.2.1 Directory Abstraction Layer Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
14.2.2 Setting Search List preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
14.3 Configuring Search List for Anonymous Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Part V Configuring and Managing Provisioning Workflows 369
15 Configuring the User Application Driver to Start Workflows 371
15.1 About the User Application Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
15.2 Setting Up Workflows to Start Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
15.2.1 About Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
15.2.2 Using the Policy Builder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
15.2.3 Using the Schema Mapping Policy Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
16 Managing Provisioning Request Definitions 385
16.1 About the Provisioning Request Configuration Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
16.2 Working with the Installed Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
16.3 Configuring a Provisioning Request Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
16.3.1 Selecting the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
16.3.2 Deleting a Provisioning Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
16.3.3 Filtering the List of Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
16.3.4 Changing the Status of an Existing Provisioning Request. . . . . . . . . . . . . . . . . . . . 392
16.3.5 Defining Rights on an Existing Provisioning Request . . . . . . . . . . . . . . . . . . . . . . . 393
17 Managing Provisioning Workflows 395
17.1 About the Workflow Administration Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
17.2 Managing Workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
17.2.1 Connecting to a Workflow Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
17.2.2 Finding Workflows that Match Search Criteria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
17.2.3 Controlling the Active Workflows Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
17.2.4 Terminating a Workflow Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
17.2.5 Viewing Details about a Workflow Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
17.2.6 Reassigning a Workflow Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
17.2.7 Managing Workflow Processes in a Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
17.3 Configuring the E-Mail Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
17.4 Working with E-Mail Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
17.4.1 Default Content and Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
17.4.2 Editing E-mail Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
17.4.3 Modifying Default Values for the Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
17.4.4 Adding Localized E-Mail Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
17.5 Allowing a Named Password to be Retrieved over LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Contents 11
Part VI Web Service Reference 423
18 Provisioning Web Service 425
18.1 About the Provisioning Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
18.1.1 Provisioning Web Service Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
18.1.2 Removing Administrator Credential Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
18.1.3 Provisioning Web Service Method Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
18.2 Developing Clients for the Provisioning Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
18.2.1 Web Access to the Provisioning Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
18.2.2 A Java Client for the Provisioning Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
18.2.3 Developing a Mono Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
18.2.4 Sample Ant File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
18.2.5 Sample Log4J File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
18.3 Provisioning Web Service API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
18.3.1 Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
18.3.2 Provisioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
18.3.3 Work Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
18.3.4 Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
18.3.5 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
18.3.6 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
18.3.7 Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
19 Metrics Web Service 495
19.1 About the Metrics Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
19.1.1 Web Service Semantics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
19.1.2 Accessing the Test Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
19.1.3 Web Service Methods Grouped by Security Permissions . . . . . . . . . . . . . . . . . . . . 496
19.1.4 Specifying Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
19.1.5 Generating the Stub Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
19.1.6 Obtaining the Remote Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
19.1.7 Metrics Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
19.2 Metrics Web Service API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
19.2.1 Team Manager Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
19.2.2 Provisioning Application Administrator Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
19.2.3 Utility Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
19.3 Metrics Web Service Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
19.3.1 General Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
19.3.2 Other Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
20 Notification Web Service 513
20.1 About the Notification Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
20.1.1 Accessing the Test Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
20.1.2 Accessing the WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
20.1.3 Generating the Stub Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
20.2 Notification Web Service API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
20.2.1 iRemoteNotification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
20.2.2 BuiltInTokens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
20.2.3 Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
20.2.4 EntryArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
20.2.5 NotificationMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
20.2.6 NotificationService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
20.2.7 StringArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
20.2.8 VersionVO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
20.3 Notification Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
12 User Application: Administration Guide
21 Directory Abstraction Layer (VDX) Web Service 523
21.1 About the Directory Abstraction Layer (VDX) Web Service . . . . . . . . . . . . . . . . . . . . . . . . . 523
21.1.1 Accessing the Test Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
21.1.2 Accessing the WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
21.1.3 Generating the Stub Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
21.1.4 Removing Administrator Credential Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
21.2 VDX Web Service API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
21.2.1 IRemoteVdx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
21.2.2 Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
21.2.3 AttributeArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
21.2.4 AttributeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
21.2.5 BooleanArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
21.2.6 ByteArrayArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
21.2.7 DateArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
21.2.8 EntryAttributeMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
21.2.9 Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
21.2.10 EntryArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
21.2.11 IntegerArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
21.2.12 StringArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
21.2.13 StringEntry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
21.2.14 StringEntryArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
21.2.15 StringMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
21.2.16 VdxService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
21.2.17 VersionVO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
21.3 VDX Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
22 Role Web Service 547
22.1 About the Role Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
22.1.1 Accessing the Test Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
22.1.2 Accessing the WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
22.1.3 Generating the Stub Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
22.1.4 Removing Administrator Credential Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
22.2 Role API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
22.2.1 IRemoteRole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
22.2.2 Approver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
22.2.3 ApproverArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
22.2.4 Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
22.2.5 CategoryArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
22.2.6 CategoryKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
22.2.7 CategoryKeyArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
22.2.8 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
22.2.9 Container. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
22.2.10 DNString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
22.2.11 DNStringArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
22.2.12 Entitlement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
22.2.13 EntitlementArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
22.2.14 Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
22.2.15 IdentityType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
22.2.16 IdentityTypeDnMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
22.2.17 IdentityTypeDnMapArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
22.2.18 LocalizedValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
22.2.19 LongArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
22.2.20 NrfServiceException . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
22.2.21 RequestCategoryType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
22.2.22 RequestStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
22.2.23 Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
Contents 13
22.2.24 RoleAssignment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
22.2.25 RoleAssignmentArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
22.2.26 RoleAssignmentActionType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
22.2.27 RoleAssignmentRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
22.2.28 RoleAssignmentRequestStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
22.2.29 RoleAssignmentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
22.2.30 RoleAssignmentTypeInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
22.2.31 RoleInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
22.2.32 RoleInfoArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
22.2.33 RoleLevel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
22.2.34 RoleLevelArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
22.2.35 RoleRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
22.2.36 RoleServiceDelegate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
22.2.37 RoleServiceSkeletonImpl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
22.2.38 Sod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
22.2.39 SodArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
22.2.40 SodApprovalType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
22.2.41 SodJustification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
22.2.42 SodJustificationArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
22.2.43 User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
22.2.44 VersionVO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
22.3 Role Web Service Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
22.3.1 Retrieving Roles for a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
22.3.2 Retrieving Role Assignment Request Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
22.3.3 Retrieving Type Information for a Role Assignment . . . . . . . . . . . . . . . . . . . . . . . . 634
22.3.4 Retrieving Role Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635
22.3.5 Retrieving Role Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
22.3.6 Verifying Whether a User Is In a ROle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
23 Resource Web Service 639
23.1 About the Resource Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
23.1.1 Accessing the Test Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
23.1.2 Accessing the WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
23.1.3 Removing Administrator Credential Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
23.2 Resource Web Service Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
23.2.1 IRemoteResource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
23.2.2 ResourceRequestParam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
23.2.3 ResourceAssignmentRequestStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650
24 Forgot Password Web Service 653
24.1 About the Forgot Password Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
24.1.1 Accessing the Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
24.1.2 Accessing the WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
24.2 Password Management Web Service Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
24.2.1 processForgotConf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
24.2.2 processUser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
24.2.3 processChaRes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
24.2.4 processChgPwd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
24.3 ForgotPasswordWSBean. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
14 User Application: Administration Guide
Part VII REST Services 659
25 Introduction to Resource Information Services 661
25.1 About RIS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
25.1.1 How it Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
25.1.2 Configuring the RIS WAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
25.2 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666
25.2.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666
25.2.2 Authorization REST Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
25.2.3 Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
25.3 WADL Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
26 Identities Service 681
26.1 About the Identities Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
26.2 Accessing and Using the Identities Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
26.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
26.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
26.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
26.2.4 Event Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
27 Password Management and SSO Services 687
27.1 About the Password Management and SSO Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
27.2 Accessing and Using the Password Management and SSO Services. . . . . . . . . . . . . . . . . . 687
27.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
27.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
27.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
28 Resources Service 697
28.1 About the Resources Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
28.2 Accessing and Using the Resources Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
28.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
28.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
28.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
29 Roles Service 701
29.1 About the Role Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
29.2 Accessing and Using the Role Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
29.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
29.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
29.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
29.2.4 Event Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
30 Work Items Service 711
30.1 About the Work Items Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711
30.2 Accessing and Using the Work Items Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711
30.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711
30.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
30.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 714
30.2.4 JSON Representations Sent by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718
Contents 15
30.2.5 Event Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
30.2.6 JSON Schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720
31 Workflow Process and Definition Service 725
31.1 About the Workflow Process and Definition Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725
31.2 Accessing and Using the Workflow Process and Definition Service . . . . . . . . . . . . . . . . . . . 725
31.2.1 Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725
31.2.2 Complete URI Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726
31.2.3 JSON Representations Received by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 729
31.2.4 JSON Representations Sent by the Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
31.2.5 Event Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
31.2.6 JSON Schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734
31.2.7 Testing the Client with the CURL Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739
Part VIII Appendixes 741
A Schema Extensions for the User Application 743
A.1 Attribute Schema Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743
A.2 Objectclass Schema Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746
A.3 Resource Definition Object (nrfResource) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747
A.4 Resource Request Object (nrfResourceRequest) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
A.4.1 Resource Request Status Codes (nrfStatus). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749
A.5 Role-Resource Configuration (nrfConfiguration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
A.6 Resource Binding to Users (nrfIdentity) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
A.7 Resource Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
B JavaScript Search API 751
B.1 Launching a Basic Search using the SearchListPortlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
B.1.1 Passing Request Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
B.1.2 Using a JSON-formatted String to Represent a Query . . . . . . . . . . . . . . . . . . . . . . 753
B.2 Creating a New Query using the JavaScript API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754
B.2.1 JavaScript API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755
B.3 Performing an Advanced Search Using a JSON-formatted Query . . . . . . . . . . . . . . . . . . . . 758
B.4 Retrieving all Saved Queries for the Current User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758
B.5 Running an Existing Saved Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758
B.6 Performing a Search on All Searchable Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
C Trouble Shooting 761
C.1 Permgen Space Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
C.2 E-Mail Notification Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
C.3 Org Chart and Guest Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
C.4 Provisioning Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
C.5 javax.naming.SizeLimitExceededException. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
C.6 Linux Open Files Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
16 User Application: Administration Guide
About This Guide 17
About This Guide
This guide describes how to administer the Novell Identity Manager User Application. It includes
these parts:
Part I, “Overview,” on page 19
Part II, “Configuring the User Application Environment,” on page 45
Part III, “Administering the User Application,” on page 125
Part IV, “Portlet Reference,” on page 291
Part V, “Configuring and Managing Provisioning Workflows,” on page 369
Part VI, “Web Service Reference,” on page 423
Part VII, “REST Services,” on page 659
Part VIII, “Appendixes,” on page 741
To learn about administering the other features of Identity Manager (which are common to all
packagings), see the Novell Identity Manager: Administration Guide.
Audience
The information in this guide is for system administrators, architects, and consultants who are
responsible for configuring, deploying, and managing the identity self-service features and
workflow-based provisioning features of the Identity Manager User Application.
End-user documentation for these features is provided in the Identity Manager User Application:
User Guide.
Feedback
We want to hear your comments and suggestions about this manual 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 www.novell.com/documentation/feedback.html and enter your
comments there.
Documentation Updates
For the most recent version of the Identity Manager User Application: Administration Guide, visit
the Identity Manager Documentation Web site (http://www.novell.com/documentation/idm401).
18 User Application: Administration Guide
20 User Application: Administration Guide
/
