Skip to content

Commit b50dd1a

Browse files
committed
fix: clarifies wording for security requirements
1 parent 4e9c5d6 commit b50dd1a

File tree

1 file changed

+3
-2
lines changed

1 file changed

+3
-2
lines changed

versions/3.1.1.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3986,10 +3986,11 @@ flows:
39863986
Lists the required security schemes to execute this operation.
39873987
The name used for each property MUST correspond to a security scheme declared in the [Security Schemes](#security-scheme-object) under the [Components Object](#components-object).
39883988

3989-
Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
3989+
A Security Requirement Object MAY refer to multiple security schemes in which case all schemes MUST be satisfied for a request to be authorized.
39903990
This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.
39913991

3992-
When a list of Security Requirement Objects is defined on the [OpenAPI Object](#openapi-object) or [Operation Object](#operation-object), only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.
3992+
When the security field is defined on the [OpenAPI Object](#openapi-object) or [Operation Object](#operation-object) and contains multiple Security Requirement Objects, only one of the entries in the list needs to be satisfied to authorize the request.
3993+
This enables support for scenarios where the API supports alternative security schemes, or when they are optional.
39933994

39943995
##### Patterned Fields
39953996

0 commit comments

Comments
 (0)