Элемент deny для элемента authorization (схема параметров ASP.NET)
Добавляет правило авторизации, запрещающее доступ к ресурсу, в сопоставления правил авторизации.
<deny
users="comma-separated list of users"
roles="comma-separated list of roles"
/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
users |
Обязательный атрибут элемента String. Разделенный запятыми список имен пользователей, которым запрещен доступ к ресурсу. Вопросительный знак (?) указывает, что доступ запрещен анонимным пользователям; звездочка (*) указывает, что доступ запрещен для всех пользователей. |
roles |
Обязательный атрибут типа String. Разделенный запятыми список ролей, которым запрещен доступ. |
verbs |
Необязательный атрибут типа String. Разделенный запятыми список методов передачи HTTP, которым разрешен доступ к ресурсу. К командам, зарегистрированным в ASP.NET, относятся GET, HEAD, POST и DEBUG. |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework. |
system.web |
Определяет корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой. |
authorization |
Задает конфигурацию авторизации веб-приложения. Элемент authorization управляет доступом клиента к URL-ресурсам. Этот элемент может объявляться на любом уровне (компьютер, веб-узел, приложение, подпапка или страница). |
Заметки
Элемент deny добавляет к сопоставлению правил авторизации, хранящихся в элементе authorization, правило авторизации, запрещающее доступ к ресурсу.
Элемент authorization задает конфигурацию авторизации веб-приложения, определяя доступ клиента к URL-ресурсам. В качестве обязательных атрибутов можно использовать атрибут users, roles или оба сразу.
Во время выполнения модуль авторизации просматривает элементы allow и deny, начиная с локального файла конфигурации, до тех пор, пока не будет найдено первое подходящее данному пользователю правило доступа. Затем модуль авторизации разрешает или запрещает доступ к URL-ресурсу в зависимости от того, будет ли первое найденное правило содержать allow или deny. По умолчанию используется правило авторизации <allow users="*"/>. Таким образом, по умолчанию доступ разрешен, если не установлено иное значение.
Чтобы облегчить развертывание клиента, поддерживается обозначение текущего компьютера с помощью точки (.). Это позволяет перед именем каждого пользователя или роли ставить префикс, представляющий последовательность точек и обратных косых черт, (.\), например:
<allow roles=".\roleName"/>
<allow users=".\userName"/>
Во время выполнения клиентского приложения последовательности точек и обратных косых черт (.\) заменяются последовательностями "имен_локальных_машин\". Замена делается, только если с запросом используется удостоверение Windows. Это делается для того, чтобы избежать конфликтов в том случае, если последовательность из точки и обратной косой черты (.\) используется в произвольных ролях со специальными участниками.
Поскольку элемент authorization не является коллекцией, он не содержит дочерних элементов clear или remove . Чтобы удалить сопоставление правил авторизации, используйте методы Clear и Remove, определенные в классе AuthorizationRuleCollection.
Пример
В следующем примере кода демонстрируется, как разрешить доступ всем членам роли Admins и запретить доступ всем остальным пользовательским учетным записям.
<configuration>
<system.web>
<authorization>
<allow roles="admins"/>
<deny users="*"/>
</authorization>
</system.web>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Ссылки
Элемент authorization (схема параметров ASP.NET)
Элемент allow для элемента authorization (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент system.web (схема параметров ASP.NET)
Основные понятия
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности ASP.NET
Другие ресурсы
Управление авторизацией с помощью ролей
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET