Skip to content

Conversation

@StephenMolloy
Copy link
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
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 <[email protected]>

* '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 <[email protected]>

* 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 <[email protected]>

---------

Co-authored-by: EsraShrouf <[email protected]>
Co-authored-by: Steve Molloy <[email protected]>
Co-authored-by: Dickson Mwendia <[email protected]>
Co-authored-by: Fenton Hutson <[email protected]>
Co-authored-by: Konst Khurin <[email protected]>
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