Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Session Methods › CreateSingleCertMap Method—Creates Single-Attribute Certificate Map

CreateSingleCertMap Method—Creates Single-Attribute Certificate Map

The CreateSingleCertMap method creates a certificate map between a single attribute in the certificate's Subject DN and the corresponding user attribute in the user directory. For authentication to succeed, the attribute's value in the Subject DN must match the value of the corresponding user attribute in the user directory.

Syntax

The CreateSingleCertMap Method method has the following format:

Netegrity::PolicyMgtSession‑>CreateSingleCertMap(IssuerDN, Attribute[, DirectoryType])

Parameters

The CreateSingleCertMap Method method accepts the following parameters:

IssuerDN (string)

Specifies the distinguished name of the certificate issuer.

Attribute (string)

Specifies the name of the attribute whose values in the certificate's Subject DN and in the user directory must match.

Syntax: %{attribute_name}

Example: %{uid}

DirectoryType (int)

(Optional) Specifies the type of the user directory specified for authentication.

• Sm_PolicyApi_DirType_LDAP (default)
• Sm_PolicyApi_DirType_WinNT
• Sm_PolicyApi_DirType_ODBC

Return Value

The CreateSingleCertMap Method method returns one of the following values:

• PolicyMgtCertMap (object)
• undef if the call is unsuccessful

Remarks

When a certificate map is created, the following flags are set to false, the default value:

• certificate_required_flag
• use_distributionpoints_flag
• verify_signature_flag
• check_certificate_revocation_list_flag
• cache_certificate_revocation_list_entries_flag

For information on changing the value of these flags, see the method PolicyMgtSession‑>CreateExactCertMap.