'accessPolicy' is mis-represented and mis-understood #1119
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This pull request updates documentation for IIS handler attributes, specifically clarifying the behavior of
requireAccess
andaccessPolicy
attributes. It introduces additional explanatory notes to improve understanding of their functionality and execution context.Updates to
requireAccess
attribute: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 theirrequireAccess
value does not match the currentaccessPolicy
level. (iis/configuration/system.webServer/handlers/add.md
)Updates to
accessPolicy
attribute:accessPolicy
to clarify its purpose as a filtering mechanism rather than a strict security policy and added a note explaining its interaction with therequiredAccess
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.