Using the Certificate Mapping API

[Previous] [Next]

ldapu_set_cert_mapfn()

Specifies which certificate mapping function is used for a given certificate authority (CA). Call this function if you want to configure the server to call your own function instead of the default certificate mapping function.

Syntax

NSAPI_PUBLIC 
int ldapu_set_cert_mapfn(const char *issuerDN, 
      CertMapFn_t mapfn);

Parameters

This function has the following parameters:


Name	Description
issuerDN	DN of the certificate authority (CA). If NULL, the function specified by the `mapfn` argument becomes the default certificate mapping function.
mapfn	The certificate mapping function that you want called when evaluating certificates issued by this CA. The function must comply with the CertMapFn_t (Mapping Function) type definition.

Returns

Returns one of the following values:

LDAPU_SUCCESS, if the function was successful.

An error code, if a problem occurred. (You can pass this error code to ldapu_err2string() to get more information on the problem.)

Description

In your initialization function, you need to call this function if you want to associate a custom certificate mapping function with this CA.

The given CA must have an entry in the certmap.conf file.

If you want to specify a custom function to be used as the default function, pass NULL as the issuerDN argument.

Example

See the example under "CertMapInitFn_t (Init Function)".

See Also

CertMapFn_t (Mapping Function), CertMapInitFn_t (Init Function), ldapu_get_cert_mapfn().

[Previous] [Next]

Copyright ⌐ 1997 Netscape Communications Corporation