Skip to content

Commit 799e9bb

Browse files
committed
Update authorization.mdx
1 parent 6cdb80b commit 799e9bb

File tree

1 file changed

+3
-5
lines changed

1 file changed

+3
-5
lines changed

docs/specification/draft/basic/authorization.mdx

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,7 @@ This approach minimizes user friction while following the principle of least pri
234234
The `scopes_supported` field is intended to represent the minimal set of scopes necessary
235235
for basic functionality (see [Scope Minimization](/specification/draft/basic/security_best_practices#scope-minimization)),
236236
with additional scopes requested incrementally through the step-up authorization flow steps
237-
described in the [Scope Error Handling](#scope-error-handling) section.
237+
described in the [Scope Challenge Handling](#scope-challenge-handling) section.
238238

239239
### Authorization Flow Steps
240240

@@ -373,7 +373,7 @@ Servers **MUST** return appropriate HTTP status codes for authorization errors:
373373
| 403 | Forbidden | Invalid scopes or insufficient permissions |
374374
| 400 | Bad Request | Malformed authorization request |
375375

376-
#### Scope Error Handling
376+
#### Scope Challenge Handling
377377

378378
This section covers handling insufficient scope errors during runtime operations when
379379
a client already has a token but needs additional permissions. This follows the error
@@ -426,9 +426,7 @@ Clients acting on behalf of a user **SHOULD** attempt the step-up authorization
426426
The flow is as follows:
427427

428428
1. **Parse error information** from the authorization server response or `WWW-Authenticate` header
429-
2. **Determine required scopes** using the following algorithm:
430-
- If the `scope` parameter is present in the `WWW-Authenticate` header, use those scopes exactly as specified (trusting the server to include any necessary existing scopes along with newly required scopes)
431-
- If `scope` is not available, use all scopes listed in `scopes_supported` from the Protected Resource Metadata document
429+
2. **Determine required scopes** as outlined in [Scope Selection Strategy](#scope-selection-strategy).
432430
3. **Initiate (re-)authorization** with the determined scope set
433431
4. **Retry the original request** with the new authorization no more than a few times and treat this as a permanent authorization failure
434432

0 commit comments

Comments
 (0)