ManyToOneCertificateMappingElement Class

Article
05/19/2022

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	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof

Share via