Novell IDENTITY MANAGER 3.6.1 - WORKORDER DRIVER IMPLEMENTATION GUIDE... User manual

Novell®

www.novell.com

novdocx (en) 17 September 2009

AUTHORIZED DOCUMENTATION

Identity Manager 3.6.1 WorkOrder Driver Implementation Guide.

Identity Manager

3.6.1

December 18, 2009

WorkOrder Driver Implementation Guide

novdocx (en) 17 September 2009

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.

stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this

document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.

patents listed on the Novell Legal Patents Web page (http://www.novell.com/company/legal/patents/) and one or

more additional patents or pending patent applications in the U.S. and in other countries.

Novell, Inc.

404 Wyman Street, Suite 500

Waltham, MA 02451

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).

novdocx (en) 17 September 2009

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.

4Identity Manager 3.6.1 WorkOrder Driver Implementation Guide.

novdocx (en) 17 September 2009

Contents 5

Contents

novdocx (en) 17 September 2009

About This Guide 7

1Overview 9

1.1 The Work Order Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1.1.1 Subscriber Channel Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1.1.2 Publisher Channel Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.2 Key Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3 Support for Standard Driver Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.4 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2 Implementation Checklist 15

3 Installing Driver Files 17

4 Creating a New Driver 19

4.1 Creating the WorkOrder Container in the Identity Vault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2 Creating the Driver in Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2.1 Importing the Driver Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2.2 Configuring the Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.2.3 Deploying the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.2.4 Starting the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.3 Creating the Driver in iManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.3.1 Importing the Driver Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.3.2 Configuring the Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

4.3.3 Starting the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

4.4 Activating the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

5 Upgrading an Existing Driver 27

5.1 Supported Upgrade Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

5.2 What’s New in Version 3.6.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

5.3 Upgrade Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6 Customizing the Driver 29

6.1 Policies and Rules Used in the Basic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6.1.1 Subscriber Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6.1.2 Publisher Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

6.2 Human Resource Example Using an HR Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

6.2.1 Human Resource Driver Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

6.2.2 WorkOrder Driver Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

6.3 Human Resource Example without an HR Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

6.3.1 Filter Additions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

6.3.2 Subscriber Create Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

6.3.3 Subscriber Command Transform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

6.3.4 Work Order E-Mail Notification of Work Order Completion . . . . . . . . . . . . . . . . . . . . 34

6Identity Manager 3.6.1 WorkOrder Driver Implementation Guide.

novdocx (en) 17 September 2009

7 Creating and Managing Work Orders 35

7.1 Using Drivers to Create Work Orders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

7.2 Using iManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

7.2.1 Creating a New Work Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

7.2.2 Editing Work Order Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

7.2.3 Filtering the Work Order List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

8 Managing the Driver 39

9 Troubleshooting Driver Processes 41

A Driver Properties 43

A.1 Driver Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

A.1.1 Driver Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

A.1.2 Driver Object Password (iManager Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

A.1.3 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

A.1.4 Startup Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A.1.5 Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

A.1.6 ECMAScript (Designer Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

A.2 Global Configuration Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

B Objects and Attributes Used 49

B.1 New Objects Used by the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

B.1.1 DirXML-WorkOrder Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

B.1.2 DirXML-WorkToDo Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

B.2 DoItNow and SendToPublisher Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

B.2.1 DoItNow Flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

B.2.2 SendToPublisherFlag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

C Schema and Policy Rules For Work Order Management 51

C.1 DirXML-WorkOrder Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

C.2 DirXML-WorkToDo Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

C.3 Publisher Placement Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

C.4 Subscriber Placement Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

C.5 Subscriber Create Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

About This Guide 7

novdocx (en) 17 September 2009

About This Guide

This guide explains how to install and configure the Novell®Identity Manager WorkOrder driver.

Chapter 1, “Overview,” on page 9

Chapter 2, “Implementation Checklist,” on page 15

Chapter 3, “Installing Driver Files,” on page 17

Chapter 4, “Creating a New Driver,” on page 19

Chapter 5, “Upgrading an Existing Driver,” on page 27

Chapter 6, “Customizing the Driver,” on page 29

Chapter 7, “Creating and Managing Work Orders,” on page 35

Chapter 8, “Managing the Driver,” on page 39

Chapter 9, “Troubleshooting Driver Processes,” on page 41

Appendix A, “Driver Properties,” on page 43

Appendix B, “Objects and Attributes Used,” on page 49

Appendix C, “Schema and Policy Rules For Work Order Management,” on page 51

Audience

This guide is intended for developers and administrators using Identity Manager and the WorkOrder

driver.

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 WorkOrder Driver Implementation Guide, visit

the Identity Manager Documentation Web site (http://www.novell.com/documentation/

idm36drivers).

Additional Documentation

For documentation on other Identity Manager drivers, see the Identity Manager Documentation Web

site (http://www.novell.com/documentation/idm36drivers).

Documentation Conventions

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

items in a cross-reference path.

8Identity Manager 3.6.1 WorkOrder Driver Implementation Guide.

novdocx (en) 17 September 2009

A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party

trademark.

Overview

novdocx (en) 17 September 2009

Overview

Typically, changes to data in the Identity Vault or a connected application are immediately

processed. Work orders enable you to schedule when tasks are to be performed.

For example, a new employee is hired but is not scheduled to start for a month. The employee needs

to be added to the HR database but should not be granted access to any corporate resources (e-mail,

servers, and so forth) until the start date. In a typical scenario, the user would be granted access as

soon as he or she is added to the HR database. With work orders implemented, a work order is

created that delays account provisioning to the user’s start date.

The WorkOrder driver provides work order functionality. The following sections introduce the

WorkOrder driver and the key concepts and terminology associated with the driver:

Section 1.1, “The Work Order Process,” on page 9

Section 1.2, “Key Features,” on page 14

Section 1.3, “Support for Standard Driver Functions,” on page 14

Section 1.4, “Terminology,” on page 14

1.1 The Work Order Process

From a high-level perspective, work orders are processed as follows:

1. A work order is created, either through an automated process (another driver) or a manual

process (iManager), and is added as a WorkOrder object in a the Identity Vault’s work order

container.

2. At the scheduled time (as defined in the WorkOrder object), the driver begins processing the

work order.

3. The driver applies any policies to the work order (performing any actions associated with the

policies) and creates a WorkToDo object in the Identity Vault’s work order container.

4. Depending on how you configure the WorkOrder driver and the other drivers in your system,

either the WorkOrder driver performs the desired work or other drivers use the information in

the the WorkToDo object to perform the work. Because the WorkOrder driver is designed to

accomodate a variety of configuration scenarios, sample scenarios are provided in Chapter 6,

“Customizing the Driver,” on page 29.

The following sections provide detailed information about the work performed by the driver’s

Subscriber and Publisher channels. Because the WorkOrder driver channels function differently than

with other drivers, you should carefully review the information.

Section 1.1.1, “Subscriber Channel Functions,” on page 9

Section 1.1.2, “Publisher Channel Functions,” on page 11

1.1.1 Subscriber Channel Functions

This section provides a basic understanding of the functions the Subscriber channel performs in the

WorkOrder driver.

10 Identity Manager 3.6.1 WorkOrder Driver Implementation Guide.

novdocx (en) 17 September 2009

First, Placement and Create rules are configured so all new work orders that contain the required

attributes are sent to the Subscriber channel. The following attributes must be present for a work

order to pass the Create rule and go to the Subscriber channel:

DirXML-nwoContent

DirXML-nwoStatus

DirXML-DoItNow Flag

DirXML-SendToPublisher Flag

Figure 3-1 shows what happens when the Subscriber channel receives a work order.

Figure 1-1 Subscriber Channel Configuration

The Subscriber channel performs the following actions:

1. Creates an association for each WorkOrder object it receives.

2. Checks if the DoItNow and SendToPublisher flags are set to True. If these attributes are set to

True, the Subscriber channel builds a work order and sends it immediately to the Publisher

channel.

3. If the DoItNow and SendToPublisher flags are not set to True, the Subscriber channel waits

until the next event.

Is it an Add

work order?

Subscriber gets the

WorkOrder XML

from the engine.

Write the

association

to the engine.

Returns to

the engine.

Write the Work

Order object to

the Publisher.

Yes

Is the

SendToPublisher

or the DoItNow

flag set?

This manual suits for next models

Table of contents

Other Novell Software manuals

Novell

Novell IDENTITY MANAGER 3.6. - INTEGRATION Quick setup guide

Novell

Novell LINUX ENTERPRISE SERVER 11 - STORAGE ADMINISTRATION GUIDE... Instruction Manual

Novell

Novell GROUPWISE 7 - 04-2007 User manual

Novell

Novell LINUX ENTERPRISE SERVER 10 - INSTALLATION AND ADMINISTRATION... User manual

Novell

Novell PLATESPIN ORCHESTRATE 2.0.2 - ADMINISTRATOR REFERENCE... User manual

Novell

Novell CLIENT FOR LINUX 1.2 User manual

Novell

Novell ACCESS MANAGER 3.1 SP1 - AGENT GUIDE User manual

Novell

Novell APPARMOR - AND User manual

Novell

Novell eBook Reader Instruction Manual

Novell

Novell OPEN WORKGROUP SUITE SMALL BUSINESS EDITION 9.3 - ADMINISTRATION... User manual

Novell

Novell GROUPWISE 7 - POST OFFICES User manual

Novell

Novell GROUPWISE 8 - MONITOR User manual

Novell

Novell OPEN ENTERPRISE SERVER CLUSTER SERVICES 1.8.2 -... User manual

Novell

Novell DATA SYNCHRONIZER - UPDATE 1 User manual

Novell

Novell GROUPWISE 7 - SECURITY POLICIES User manual

Novell

Novell GROUPWISE 7 - POST OFFICE AGENT User manual

Novell

Novell GROUPWISE 8 - TROUBLESHOOTING 3 User manual

Novell

Novell LINUX ENTERPRISE DESKTOP 10 SP2 User manual

Novell

Novell LINUX ENTERPRISE 11 SP1 - LINUX AUDIT User manual

Novell

Novell EDIRECTORY 8.8 SP1 User manual

Novell

Novell iFOLDER 3.6 - READ ME 05-2008 User manual

Novell

Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - NETWORK DISCOVERY DATABASE... User manual

Novell

Novell BUSINESS CONTINUITY CLUSTERING 1.0 -... User manual

Novell

Novell LINUX ENTERPRISE SERVER 11 - DEPLOYMENT Quick reference guide

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual

Lexmark

Lexmark Apps Administrator's guide