'accessPolicy' is mis-represented and mis-understood #1119
Merged
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
requireAccessandaccessPolicyattributes. It introduces additional explanatory notes to improve understanding of their functionality and execution context.Updates to
requireAccessattribute:requireAccessto emphasize its role in determining the execution level of a handler and added a note explaining that handlers may still be initialized even if theirrequireAccessvalue does not match the currentaccessPolicylevel. (iis/configuration/system.webServer/handlers/add.md)Updates to
accessPolicyattribute:accessPolicyto clarify its purpose as a filtering mechanism rather than a strict security policy and added a note explaining its interaction with therequiredAccessattribute. (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
requireAccesspolicy 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.