ipSecurity Element [IIS Settings Schema]

Note

For more information about the ipSecurity element, see the following topic on the Microsoft IIS.net Web site: IP Security <ipSecurity>.

Specifies access restrictions based on the IP version 4 address or DNS domain name.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute

Description

allowUnlisted

Optional Boolean attribute.

Specifies whether to allow unlisted IP addresses. True allows an unlisted IP address to access the server. False locks down the server, preventing access to all IP address unless they are listed. If you were to set this attribute to false and not list the local loopback address (127.0.0.1) as an allowed IP address, you would not be able to access your server by using a browser from a local console.

This attribute can also affect delegation. If you were to set this attribute to false in a parent configuration, you would not be able use the <clear> element to clear this configuration in child configuration files.

The default value is true.

enableReverseDns

Optional Boolean attribute.

Specifies whether to enable or disable reverse Domain Name System (DNS) lookups for the Web server. Reverse lookups involve looking up the domain name when the IP address is known.

Caution

Reverse DNS lookups will use significant resources and time.

The default value is false.

Child Elements

Element

Description

add

Optional element.

Adds an IP restriction to the collection of IP address restrictions.

remove

Optional element.

Removes a reference to a restriction from the ipSecurity collection.

clear

Optional element.

Removes all references to restrictions from the ipSecurity collection.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

security

Specifies the section group that contains security-related sections.

Remarks

For more information about the ipSecurity element, see the following topic on the Microsoft IIS.net Web site: IP Security <ipSecurity>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

add Element for ipSecurity [IIS Settings Schema]

remove Element for ipSecurity [IIS Settings Schema]

clear Element for ipSecurity [IIS Settings Schema]