Oracle Internet Directory Application Developer's Guide -- Contents

About Oracle Internet Directory Software Developer's Kit Release 9.0.2

Components of the Oracle Internet Directory Software Developer's Kit

Other Components of Oracle Internet Directory

Operating Systems Supported

History of LDAP

Overview of LDAP Models

LDAP Naming Model

LDAP Information Model

LDAP Functional Model

LDAP Security Model

About the Oracle Internet Directory API

Initializing an LDAP Session

Initializing the Session by Using the C API

Initializing the Session by Using DBMS_LDAP

LDAP Session Handle Options in the C API

Enabling Authentication to a Directory Server

Enabling Authentication to a Directory Server by Using the C API

Enabling Authentication to a Directory Server by Using DBMS_LDAP

Searching by Using DBMS_LDAP

Flow of Search-Related Operations

Search Scope

Filters

Enabling Session Termination by Using DBMS_LDAP

About the Oracle Internet Directory C API

Oracle Internet Directory SDK C API SSL Extensions

C API Reference

Summary of LDAP C API

Functions

Initializing an LDAP Session

LDAP Session Handle Options

Working With Controls

Authenticating to the Directory

Closing the Session

Performing LDAP Operations

Abandoning an Operation

Obtaining Results and Peeking Inside LDAP Messages

Handling Errors and Parsing Results

Stepping Through a List of Results

Parsing Search Results

Sample C API Usage

C API Usage with SSL

C API Usage Without SSL

Building Applications with the C API

Required Header Files and Libraries

Building a Sample Search Tool

Dependencies and Limitations

About the DBMS_LDAP Package

Building Applications with DBMS_LDAP

Dependencies and Limitations

DBMS_LDAP Sample Programs

DBMS_LDAP Reference

Summary of Subprograms

Exception Summary

Data-Type Summary

Subprograms

The LDAP Access Model

Application Installation Logic

Application Startup and Bootstrap Logic

Application Runtime Logic

Application Shutdown Logic

Application Deinstallation Logic

Entities Modeled in LDAP

Users

Groups

Subscribers

API Enhancements: Overview & Usage Model

API Enhancements: Assumptions

System Placement

API Enhancements Functional Categorization

API Enhancements Usage Model

Installation and First Use

Class Descriptions

User Class

Subscriber Class

Group Class

PropertySetCollection, PropertySet, and Property Classes

Classes

oracle.ldap.util.Base64

oracle.ldap.util.Group

oracle.ldap.util.Guid

oracle.ldap.util.LDIF

oracle.ldap.util.LDIFAttribute

oracle.ldap.util.LDIFMigration

oracle.ldap.util.LDIFReader

oracle.ldap.util.LDIFRecord

oracle.ldap.util.LDIFSubstitute

oracle.ldap.util.LDIFWriter

oracle.ldap.util.Property

oracle.ldap.util.PropertySet

oracle.ldap.util.PropertySetCollection

oracle.ldap.util.Subscriber

oracle.ldap.util.User

oracle.ldap.util.Util

java.util.Hashtable getAllDASUrl(DirContext ctx)

oracle.ldap.util.jndi.ConnectionUtil

Exceptions

oracle.ldap.util.AcctIPLockedException

oracle.ldap.util.AcctTotallyLockedException

oracle.ldap.util.AuthFailureException

oracle.ldap.util.AuthPasswdChangeWarningException

oracle.ldap.util.AuthPasswdExpiredException

oracle.ldap.util.GeneralErrorException

oracle.ldap.util.InvalidLDIFRecordException

oracle.ldap.util.InvalidParameterException

oracle.ldap.util.InvalidRootOrclctxException

oracle.ldap.util.InvalidSubscriberOrclctxException

oracle.ldap.util.LoginPolicyFailureException

oracle.ldap.util.MigrationException

oracle.ldap.util.MultipleSubscriberException

oracle.ldap.util.MultipleUserException

oracle.ldap.util.NoGroupMembersException

oracle.ldap.util.NoRootOrclctxException

oracle.ldap.util.NoSubscriberOrclctxException

oracle.ldap.util.NoSuchGroupException

oracle.ldap.util.NoSuchSubscriberException

oracle.ldap.util.NoSuchUserException

oracle.ldap.util.ParameterException

oracle.ldap.util.PasswdExpiredException

oracle.ldap.util.SetPropertiesException

oracle.ldap.util.SubscriberNotFoundException

oracle.ldap.util.UtilException

Introduction

DBMS_LDAP_UTL Reference

Summary of Subprograms

User-Related Subprograms

Group-Related Subprograms

Subscriber-Related Subprograms

Miscellaneous Subprograms

Function Return Code Summary

Data-Type Summary

Prerequisite Knowledge

Development Usage Model for Provisioning Integration

Development Tasks for Provisioning Integration

Application Installation

User Creation and Enrollment

User Deletion

Application Deinstallation

Provisioning Event Interface Description

LDAP_NTFY Function Definitions

FUNCTION event_ntfy

LDAP Data Interchange Format (LDIF) Syntax

Command-Line Tools Syntax

Catalog Management Tool Syntax

Provisioning Subscription Tool Syntax

Introduction

Prerequisite Knowledge

Concepts

About Directory Server Plug-ins

About Server Plug-in Framework

Operation-Based Plug-ins Supported in Oracle Internet Directory

Requirements

Enabling and Disabling Plug-ins

Exception Handling

Plug-in LDAP API

Plug-in and Replication

Plug-in and DB Tools

Security

Plug-in LDAP API Specifications

Usage Model and Examples

Example 1: Search Query Logging

Example 2: Synchronizing Two DITs

Type Definition & Usage Model

Database Object Type Definitions

Plug-in Module Interface Specifications

LDAP Server Error Code Reference

Using DBMS_LDAP from a Database Trigger

Using DBMS_LDAP for a Search

Java Sample Code

User Class Sample Code

Subscriber Class Sample Code

Group Class Sample Code

Print Sample Code

Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Introduction

Part I Standard LDAP APIs

2 Concepts

3 C API for Oracle Internet Directory

4 The DBMS_LDAP PL/SQL Package

Part II Oracle Extensions to LDAP APIs

5 Overview of Oracle Extensions

6 Java API for Oracle Internet Directory

7 The DBMS_LDAP_UTL PL/SQL Package

8 Developing Provisioning-Integrated Applications

Part III Command-Line Tools

9 Command-Line Tools Syntax

10 Oracle Internet Directory Server Plug-in Framework

A Sample Usage

Glossary

Index