Novell IDENTITY MANAGER DRIVER FOR ID PROVIDER 3.6.1 -... User manual

Novell®

www.novell.com

novdocx (en) 13 May 2009

AUTHORIZED DOCUMENTATION

Identity Manager 3.6 ID Provider Driver Implementation Guide

Identity Manager Driver for ID Provider

3.6.1

June 05, 2009

implementation Guide

novdocx (en) 13 May 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) 13 May 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 ID Provider Driver Implementation Guide

novdocx (en) 13 May 2009

Contents 5

Contents

novdocx (en) 13 May 2009

About This Guide 7

1 Understanding the ID Provider Driver 9

1.1 Why Use the Driver? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1.2 Design Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1.3 Schema Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2 Installing Driver Files 15

3 Creating a New Driver 17

3.1 Creating the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.2 Creating ID Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4 Configuring ID Clients 23

4.1 ID Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.2 Standalone Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

5 Managing the ID Provider Driver 27

6 Troubleshooting 29

A Driver Properties 31

A.1 Driver Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

A.1.1 Driver Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

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

A.1.3 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

A.1.4 Startup Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

A.1.5 Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

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

A.2 Global Configuration Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

6Identity Manager 3.6 ID Provider Driver Implementation Guide

novdocx (en) 13 May 2009

About This Guide 7

novdocx (en) 13 May 2009

About This Guide

This guide explains the purpose of the ID Provider driver and how to implement the driver.

Chapter 1, “Understanding the ID Provider Driver,” on page 9

Chapter 2, “Installing Driver Files,” on page 15

Chapter 3, “Creating a New Driver,” on page 17

Chapter 4, “Configuring ID Clients,” on page 23

Chapter 5, “Managing the ID Provider Driver,” on page 27

Audience

This guide is intended for Identity Manager administrators.

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 this guide, visit the Identity Manager Drivers Documentation Web

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

Additional Documentation

For documentation on Identity Manager, see the Identity Manager Documentation Web site (http://

www.novell.com/documentation/idm36/index.html).

Documentation Conventions

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

items in a cross-reference path.

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

trademark.

When a single pathname can be written with a backslash for some platforms or a forward slash for

other platforms, the pathname is presented with a backslash. Users of platforms that require a

forward slash, such as Linux* or UNIX*, should use forward slashes as required by your software.

8Identity Manager 3.6 ID Provider Driver Implementation Guide

novdocx (en) 13 May 2009

Understanding the ID Provider Driver

novdocx (en) 13 May 2009

Understanding the ID Provider

Driver

The ID Provider driver enables you to create and maintain a central source of unique IDs that can be

consumed by client applications or systems. When the driver receives an ID request from a client, it

generates an ID based on policies you define, passes it to the client, and then stores it in the Identity

Vaul t .

Section 1.1, “Why Use the Driver?,” on page 9

Section 1.2, “Design Architecture,” on page 9

Section 1.3, “Schema Architecture,” on page 11

1.1 Why Use the Driver?

There are many different reasons why you would want to use the ID Provider driver. For example:

For administrators it is convenient to have one basic ID for each objects in the system, and to

have complete control of the ID. No other system can change this ID.

You can use the ID Provider driver in conjunction with the WorkOrder driver to verify that each

WorkOrder ID that is created is unique.

You can use the driver to help manage UIDs and GIDs in Linux.

1.2 Design Architecture

Identity Manager drivers listen for events and then apply the proper Identity Manager policies for

the event. That information is then passed to the Metadirectory engine that executes the policies.

The ID Provider driver is different from all other Identity Manager drivers. It also listens for events,

but it has two sets of policies: the Identity Manager policies and the ID Provider policies. The ID

Provider policies allow the driver to generate and assign unique IDs to objects.

The driver has three major components:

ID Client: The ID client communicates with the ID Provider driver to obtain a unique ID. The

client can be another Identity Manager driver (for example, the WorkOrder driver) or a

standalone Java* application.

ID Provider Driver: The driver receives ID requests from clients, generates unique IDs that

are stored in the Identity Vault, and passes the unique IDs back to the client. The driver uses

LDAP to access the Identity Vault and uses Java RMI (Remote Method Invocation) to

communicate with ID clients.

Identity Vault: The Identity Vault provides the location for storing unique IDs and also

contains the policies used to generate the IDs. All IDs and policies are stored in the ID Policy

Container.

10 Identity Manager 3.6 ID Provider Driver Implementation Guide

novdocx (en) 13 May 2009

The ID Provider driver can be used in two different scenarios:

“Scenario 1: Using the Identity Vault to Store the ID Provider Policies” on page 10

“Scenario 2: Using an LDAP Database to Store the ID Provider Policies” on page 11

Scenario 1: Using the Identity Vault to Store the ID Provider Policies

This is the most commonly used scenario with the driver. The ID Provider policies are created and

stored in the Identity Vault when the driver is created and configured. Figure 1-1 shows how an

unique ID is generated.

Figure 1-1 Identity Vault Stores the ID Provider Policies

1. A new User object is created in the Identity Vault, then the ID Provider driver picks up the

Create event.

2. The ID Provider driver reads the last ID that was generated from the ID Provider polices in the

Identity Vault and generates a new ID. The ID is then written back to the ID Provider policies

in the Identity Vault to track the unique IDs.

3. The ID Provider driver then assigns the new ID to the new User object.

[root]

system data

services

ID Policies

users

user1

user2

policies1

policies2

policies3

New user 1

Identity Vault

LDAP Interface

IDM

Engine

read last ID from policy, generate new

ID and write back new ID to policy

add

event

This manual suits for next models

Table of contents

Other Novell Software manuals

Novell

Novell ACCESS MANAGER 3.1 SP2 IR1 - README 07-2010 User manual

Novell

Novell LINUX ENTERPRISE DESKTOP 11 - KDE 17-03-2009 User manual

Novell

Novell IDENTITY MANAGER 3.6.1 - NULL SERVICE AND LOOPBACK SERVICE... User manual

Novell

Novell CLIENT FOR LINUX 1.2 User manual

Novell

Novell EDIRECTORY 8.8 SP5 Quick start guide

Novell

Novell IFOLDER 3.8 - DEPLOYMENT Quick reference guide

Novell

Novell LINUX ENTERPRISE 10 SP1 - LINUX AUDIT User manual

Novell

Novell GROUPWISE 7 - SECURITY POLICIES User manual

Novell

Novell IFOLDER 3.7 - SECURITY ADMINISTRATION User manual

Novell

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

Novell

Novell CLIENT FOR LINUX 2.0 SP3 Instruction Manual

Novell

Novell ZENWORKS NETWORK ACCESS CONTROL 5.0 - INSTALLATION GUIDE... User manual

Novell

Novell LINUX ENTERPRISE DESKTOP 11 - ADMINISTRATION GUIDE... User manual

Novell

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

Novell

Novell SP2 - S Instruction Manual

Novell

Novell CLIENT FOR LINUX 2.0 SP1 - ADMINISTRATION Instruction Manual

Novell

Novell LINUX ENTERPRISE SERVER 10 SP3 -... Manual

Novell

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

Novell

Novell IMANAGER - INSTALLATION V2.7 User manual

Novell

Novell CLIENT FOR LINUX 2.0 SP3 Instruction Manual

Novell

Novell ACCESS MANAGER 3.1 SP2 - README 2010 User manual

Novell

Novell OPEN WORKGROUP SUITE SMALL BUSINESS EDITION 9.3 -... Instruction Manual

Novell

Novell GROUPWISE 8 - DATABASES User manual

Novell

Novell LINUX ENTERPRISE 11 SP1 - LINUX AUDIT User manual

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