Programming Guides › Programming Guide for C › Authentication API › Create a Custom Authentication Scheme Library

Previous Topic: Supported Credentials

Next Topic: SmAuthenticate()

Create a Custom Authentication Scheme Library

To create a custom authentication scheme library:

Include the SmApi.h file, as follows:

#include "SmApi.h"

Make the following functions externally visible:

Function

Description

SmAuthenticate()

Performs user authentications. The scheme authenticates user credentials and returns the result.

SmAuthInit()

Initializes the scheme. The scheme should initialize whatever resources it needs at this time.

SmAuthQuery()

Requests scheme information.

SmAuthRelease()

Releases the scheme only when SiteMinder is shutting down. The scheme should release its resources at this time.

Each entry point in the shared library must be defined according to specified syntax.

Note: If you are using Microsoft Visual Studio, export the function addresses to a modular definition file (.DEF) file. To export the function addresses, create a .DEF file, and in the export section of the .DEF file, list all of the authentication scheme functions, described in the previous table. Once you have created the .DEF file, add it to the Microsoft Visual Studio project.

Compile the code into a DLL or shared library. When you define the authentication scheme in the Administrative UI, you will specify this library name in the Authentication Scheme Properties dialog box.

After you have written and compiled a custom authentication scheme library, you define the authentication scheme that will use the custom library. You do so using the Administrative UI.

Copyright © 2010 CA. All rights reserved. Email CA about this topic