Skip to content

Commit 947cd76

Browse files
authored
Merge pull request #4129 from handrews/sec-req-again-304
clarifies security requirements wording for 3.0.4 (port of #4123)
2 parents d486d98 + 133352b commit 947cd76

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

versions/3.0.4.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -3726,10 +3726,13 @@ flows:
37263726
Lists the required security schemes to execute this operation.
37273727
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).
37283728

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

3732-
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.
3732+
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.
3733+
This enables support for scenarios where the API allows multiple, independent security schemes.
3734+
3735+
An empty Security Requirement Object (`{}`) indicates anonymous access is supported.
37333736

37343737
##### Patterned Fields
37353738

0 commit comments

Comments
 (0)