Previous Topic: Policy Management Setup

Next Topic: Object Retrieval Functions

Earlier Versions of the API

SiteMinder v4.5 introduced changes to the SiteMinder Policy Management API. You cannot mix SiteMinder v4.5 or later Policy Management API code with Policy Management API code from earlier releases.

Programmers who continue to use a pre-4.5 Policy Management API should refer to the documentation that accompanied the earlier release. Pre-4.5 Policy Management API applications cannot be used with versions of the Policy Server after v4.61 SP2.

The primary change at v4.5 was the replacement of name with object identifier (OID) as an object's unique identifier. This change was necessitated by the introduction of nested realms. When a SiteMinder object is created, its OID is written in the pszOid field of the object's defining structure.

Another change was the addition of Sm_PolicyApi_Init() and Sm_PolicyApi_Release(). These functions must be the first and last functions, respectively, that are called by the API client session.

Three pre-SiteMinder v4.5 functions were superseded by new functions that provide similar functionality:

Pre-SiteMinder v4.5

SiteMinder v4.5 or Later

Sm_PolicyApi_RemoveRuleFrom-
Policy()

Sm_PolicyApi_RemoveLinkFrom-
Policy()

Sm_PolicyApi_GetGlobalObject-
Names()

Sm_PolicyApi_GetGlobalObjects()

Sm_PolicyApi_GetGroupNames()

Sm_PolicyApi_GetGroupOids()