Skip to content

Commit 5559b5c

Browse files
authored
Merge pull request #4123 from baywet/fix/security-requirements-wording
clarifies security requirements wording for 3.1.1
2 parents 4e9c5d6 + 4436e3a commit 5559b5c

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

versions/3.1.1.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -3986,10 +3986,13 @@ 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 allows multiple, independent security schemes.
3994+
3995+
An empty Security Requirement Object (`{}`) indicates anonymous access is supported.
39933996

39943997
##### Patterned Fields
39953998

0 commit comments

Comments
 (0)