Skip to content

'accessPolicy' is mis-represented and mis-understood#1119

Merged
wadepickett merged 3 commits intoMicrosoftDocs:mainfrom
StephenMolloy:clarify-handlers-accesspolicy
Jun 27, 2025
Merged

'accessPolicy' is mis-represented and mis-understood#1119
wadepickett merged 3 commits intoMicrosoftDocs:mainfrom
StephenMolloy:clarify-handlers-accesspolicy

Conversation

@StephenMolloy
Copy link
Copy Markdown
Contributor

This pull request updates documentation for IIS handler attributes, specifically clarifying the behavior of requireAccess and accessPolicy attributes. It introduces additional explanatory notes to improve understanding of their functionality and execution context.

Updates to requireAccess attribute:

  • Updated the description of requireAccess to emphasize its role in determining the execution level of a handler and added a note explaining that handlers may still be initialized even if their requireAccess value does not match the current accessPolicy level. (iis/configuration/system.webServer/handlers/add.md)

Updates to accessPolicy attribute:

  • Enhanced the description of accessPolicy to clarify its purpose as a filtering mechanism rather than a strict security policy and added a note explaining its interaction with the requiredAccess attribute. (iis/configuration/system.webServer/handlers/index.md)

Additional updates:

There are docs in the older "unmaintained" trove of IIS documentation that reference this feature. I know there are great warnings about how we don't maintain those docs, but every so often someone sees a handler get initialized when it doesn't meet the requireAccess policy and gets confused and files an issue that comes back to a PG. I can't open a PR on those. Not sure if they should also be updated or if we really don't maintain them anymore.

…all out that preventing execution does not necessarily prevent initialization.
Copy link
Copy Markdown
Contributor

@wadepickett wadepickett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great.

@wadepickett wadepickett merged commit aefec89 into MicrosoftDocs:main Jun 27, 2025
2 checks passed
tdykstra pushed a commit that referenced this pull request Dec 20, 2025
* Update using-dynamic-ip-restrictions.md (#1097)

* Update using-dynamic-ip-restrictions.md

broken link

* Update iis/manage/configuring-security/using-dynamic-ip-restrictions.md

Fixed link.

* Update using-dynamic-ip-restrictions.md

Fixed meta data author value's format

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* 'accessPolicy' is mis-represented and mis-understood (#1119)

* 'accessPolicy' is a little mis-represented. And definitely needs to call out that preventing execution does not necessarily prevent initialization.

* Update add.md

Updated ms.date

* Update index.md

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Add SFI ms.custom values (#1120)

* Update docfx.json with ms.update-cycle setting (#1121)

Adding ms.update-cycle setting in docfx.json to reflect tier level support.

* Update getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md (#1124)

Grammar error

* Update Reverse Proxy Rule Templates (#1125)

* adding URL Rewrite samples for blocking tomcat path traversal

* updating URL Rewrite rule template article

* Adding sample rule for redirecting https

* Adding sample rule for redirecting https

* Apply suggestions from code review

Minor style guide related adjustments

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

---------

Co-authored-by: EsraShrouf <79594213+EsraShrouf@users.noreply.github.com>
Co-authored-by: Steve Molloy <smolloy@microsoft.com>
Co-authored-by: Dickson Mwendia <64727760+Dickson-Mwendia@users.noreply.github.com>
Co-authored-by: Fenton Hutson <112075131+FentonPlusPlus@users.noreply.github.com>
Co-authored-by: Konst Khurin <kkhurin@microsoft.com>
tdykstra pushed a commit that referenced this pull request Jan 7, 2026
* Update using-dynamic-ip-restrictions.md (#1097)

* Update using-dynamic-ip-restrictions.md

broken link

* Update iis/manage/configuring-security/using-dynamic-ip-restrictions.md

Fixed link.

* Update using-dynamic-ip-restrictions.md

Fixed meta data author value's format

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* 'accessPolicy' is mis-represented and mis-understood (#1119)

* 'accessPolicy' is a little mis-represented. And definitely needs to call out that preventing execution does not necessarily prevent initialization.

* Update add.md

Updated ms.date

* Update index.md

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Add SFI ms.custom values (#1120)

* Update docfx.json with ms.update-cycle setting (#1121)

Adding ms.update-cycle setting in docfx.json to reflect tier level support.

* Update getting-started-with-the-iis-manager-in-iis-7-and-iis-8.md (#1124)

Grammar error

* Update Reverse Proxy Rule Templates (#1125)

* adding URL Rewrite samples for blocking tomcat path traversal

* updating URL Rewrite rule template article

* Adding sample rule for redirecting https

* Adding sample rule for redirecting https

* Apply suggestions from code review

Minor style guide related adjustments

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Fix typo in preloadEnabled attribute documentation (#1122)

* Fix typo in preloadEnabled attribute documentation

* Apply suggestion from @wadepickett

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

---------

Co-authored-by: EsraShrouf <79594213+EsraShrouf@users.noreply.github.com>
Co-authored-by: Steve Molloy <smolloy@microsoft.com>
Co-authored-by: Dickson Mwendia <64727760+Dickson-Mwendia@users.noreply.github.com>
Co-authored-by: Fenton Hutson <112075131+FentonPlusPlus@users.noreply.github.com>
Co-authored-by: Konst Khurin <kkhurin@microsoft.com>
Co-authored-by: David Brink <43828739+david-brink-talogy@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants