Skip to content

Commit d49203a

Browse files
committed
fix: clarifies wording for security requirements
Signed-off-by: Vincent Biret <[email protected]>
1 parent 4e9c5d6 commit d49203a

File tree

1 file changed

+2
-3
lines changed

1 file changed

+2
-3
lines changed

versions/3.1.1.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3986,10 +3986,9 @@ 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.
3990-
This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.
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. This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.
39913990

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.
3991+
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. This enables support for scenarios where the API supports alternative security schemes, or when they are optional.
39933992

39943993
##### Patterned Fields
39953994

0 commit comments

Comments
 (0)