Share via


ManyToOneCertificateMappingElement Class [IIS 7 and higher]

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

See Also

Reference

AccessSection Class [IIS 7 and higher]

ClientCertificateMappingAuthenticationSection Class [IIS 7 and higher]

CollectionElement Class [IIS 7 and higher]

IisClientCertificateMappingAuthenticationSection Class [IIS 7 and higher]

ManyToOneCertificateMappingRuleElement Class [IIS 7 and higher]

ManyToOneCertificateRuleSettings Class [IIS 7 and higher]