Skip to content

Commit 01469b2

Browse files
bosouzaschavis
andauthored
Update content/vault/global/partials/policies/list-allowed-parameters.mdx
Co-authored-by: Sarah Chavis <62406755+schavis@users.noreply.github.com>
1 parent bd0d788 commit 01469b2

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

content/vault/global/partials/policies/list-allowed-parameters.mdx

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,16 @@ For example, if you set `allowed_parameters` to `"X": ["A", "B"]`:
1414
even `"X": ["A"]`, because the parameter value does not
1515
**exactly** match one of the allowed values ("A" or "B").
1616

17-
The same logic applies to `denied_parameters`: if it is set to `"Y": ["C", "D"]`,
18-
Vault **allows** a request with parameter `"Y": ["C", "D"]`, which can lead to
19-
unauthorized access if the intent was to deny any request that includes "C", "D"
20-
or both. As a result, we **strongly recommend** using `allowed_parameters` instead of
21-
`denied_parameters` for list parameters.
17+
The same logic applies to `denied_parameters`. If you create a policy with
18+
`denied_parameters` set to `"Y": ["C", "D"]`:
19+
20+
- Vault only denies requests with parameter `"X": "C"` or `"X": "D"`.
21+
- Vault allows all other requests. For example, Vault allows requests with
22+
parameter `"Y": ["C", "D"]`, which can lead to unauthorized access if you
23+
intended to deny any request that included "C", "D", or both.
24+
25+
As a result, we **strongly recommend** using `allowed_parameters`
26+
instead of `denied_parameters` for list parameters.
2227

2328
Additionally, Vault v1.20 and earlier does not treat comma-separated strings in request
2429
parameters as lists when evaluating `allowed_parameters` and `denied_parameters`.

0 commit comments

Comments
 (0)