ManyToOneCertificateMappingElement Class [IIS 7 and higher]

Article
07/13/2012

Maps one or more certificates to a single user account.

Syntax

class ManyToOneCertificateMappingElement : CollectionElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the ManyToOneCertificateMappingElement class.

Name	Description
Description	A read/write string value that contains a description of the mapping.
Enabled	A read/write boolean value. true if the mapping is enabled; otherwise, false. The default is true.
Name	A required read-only string value that specifies the name of the mapping. The key property.
Password	A read/write string value that specifies the password for the Windows user account to which the certificate is mapped.
PermissionMode	A read/write sint32 value that specifies the behavior of the Rules property. The possible values are listed later in the Remarks section.
Rules	A ManyToOneCertificateRuleSettings value that contains many-to-one certificate mapping rules.
UserName	A read/write string value that specifies the user name for the Windows user account to which the certificate is mapped.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class form members of the ManyToOneMappings property of the IisClientCertificateMappingAuthenticationSection class.

Many-to-one mapping uses wildcard matching rules that verify whether a client certificate contains specific information, such as the issuer or subject. This mapping does not compare the actual client certificate, but rather accepts all the client certificates that fulfill the specific criteria. If a client gets another certificate that contains all the same user information, the existing mapping will work.

The following table lists the possible values for the PermissionMode property. The default is 1 (Allow).

Value	Keyword	Description
1	Allow	The mapping is allowed based on the criteria specified by the Rules property.
2	Deny	The mapping is denied based on the criteria specified by the Rules property.

Inheritance Hierarchy

CollectionElement

ManyToOneCertificateMappingElement

Requirements

Type	Description
Client	Requires IIS 7 on Windows Vista.
Server	Requires IIS 7 on Windows Server 2008.
Product	IIS 7
MOF file	WebAdministration.mof

Share via