Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

StephenMolloy
Copy link

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.

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