chore(docs): revise content for OAuth scopes configuration

[ossdhaval]

Prepare

• Read PR guidelines
• Read license information

---

Description

Target issue

closes #issue-number-here

Implementation Details

---

Test and Document the changes

• Static code analysis has been run locally and issues have been fixed
• Relevant unit and integration tests have been added/updated
• Relevant documentation has been updated if any (i.e. user guides, installation and configuration guides, technical design docs etc)

Please check the below before submitting your PR. The PR will not be merged if there are no commits that start with docs: to indicate documentation changes or if the below checklist is not selected.

• I confirm that there is no impact on the docs due to the code changes in this PR.

[dryrunsecurity]

DryRun Security Summary

The pull request focuses on improving the documentation and usability of the OAuth Scopes management functionality in the Janssen Server, introducing different ways to manage OAuth Scopes, providing detailed steps and examples for common operations, and emphasizing the use of secure and standard practices for managing OAuth Scopes.

Expand for full summary

Summary:

The code changes in this pull request are focused on improving the documentation and usability of the OAuth Scopes management functionality in the Janssen Server. The changes introduce different ways to manage OAuth Scopes, including using the command-line interface, text-based UI, and REST API, and provide detailed steps and examples for common operations like finding/viewing, creating, updating, patching, and deleting OAuth Scopes.

From an application security perspective, these changes are positive as they emphasize the use of secure and standard practices for managing OAuth Scopes, which define the permissions and access granted to clients. The documentation highlights the use of JSON Patch for updating specific attributes of an existing OAuth Scope, which is a secure and recommended approach. Overall, the changes do not appear to introduce any new security vulnerabilities or concerns, and they are focused on enhancing the user experience and documentation around OAuth Scopes management, which is an important aspect of application security in the Janssen Server.

Files Changed:

• docs/admin/config-guide/auth-server-config/oauth-scopes-config.md: This file has been updated to provide more detailed information on managing OAuth Scopes in the Janssen Server. The changes include introducing different ways to manage OAuth Scopes, providing detailed steps and examples for common operations, explaining the relevant command-line operations and their parameters, and highlighting the use of JSON Patch for updating specific attributes of an existing OAuth Scope.

Code Analysis

We ran 7 analyzers against 3 files and 0 analyzers had findings. 7 analyzers had no findings.

Riskiness

🟢 Risk threshold not exceeded.

View PR in the DryRun Dashboard.