[DAL-834] Document OAuth scope management - #39469
Conversation
|
To use Codex here, create an environment for this repo. |
Preview links (active after the
|
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0c69d408d9
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| Enable Application Scope Management to modify the allowed scopes for an application. | ||
|
|
||
| Only MCP applications support Application Scope Management. | ||
| Adding or removing a scope affects access to the application for all users in your organization. Disabling a scope revokes existing authorizations that include the scope. Affected users must re-authorize the application to regain access with the remaining allowed scopes. |
There was a problem hiding this comment.
Document re-authorization when enabling a scope
When an application already has authorized users, enabling another scope does not add it to their existing authorizations; the replacement screenshot explicitly states that users must manually re-authorize to grant the new scope. This paragraph explains re-authorization only after disabling a scope, so administrators may expect saving an added scope to update existing grants and then encounter authorization failures. Document the corresponding re-authorization requirement for enabled scopes.
Useful? React with 👍 / 👎.
drichards-87
left a comment
There was a problem hiding this comment.
Left some feedback from Docs on the PR.
Motivation
Application Scope Management is no longer limited to MCP applications.
Changes
Follow-up
The PR also replaces the outdated screenshot with the current Application Scope Management interface.
This PR incorporates the scope management guidance from #38920 and supersedes that PR.
This PR was AI-assisted using @codex.