You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _guides/security-authorize-web-endpoints-reference.adoc
+18-5Lines changed: 18 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,25 +13,38 @@ include::_attributes.adoc[]
13
13
Quarkus incorporates a pluggable web security layer.
14
14
When security is active, the system performs a permission check on all HTTP requests to determine if they should proceed.
15
15
16
-
[NOTE]
17
-
====
18
-
If you use Jakarta RESTful Web Services, consider using `quarkus.security.jaxrs.deny-unannotated-endpoints` or `quarkus.security.jaxrs.default-roles-allowed` to set default security requirements instead of HTTP path-level matching because annotations can override these properties on an individual endpoint.
19
-
====
20
-
21
16
Authorization is based on user roles that the security provider provides.
22
17
To customize these roles, a `SecurityIdentityAugmentor` can be created, see
If you work with Jakarta RESTful Web Services (JAX-RS) and need to set default security requirements, consider using <<standard-security-annotations>> and `quarkus.security.jaxrs.deny-unannotated-endpoints` or `quarkus.security.jaxrs.default-roles-allowed` properties instead of the HTTP security policy path-level matching because the security annotations can override these properties on an individual JAX-RS resource or method level.
26
+
====
27
+
28
28
Permissions are defined in the Quarkus configuration by permission sets, each specifying a policy for access control.
29
29
30
30
[NOTE]
31
31
====
32
32
When a security policy's `paths` property contains the most specific path that matches the current request path, it takes precedence over other security policies with matching paths and is said to win.
33
33
====
34
34
35
+
[NOTE]
36
+
====
37
+
Configured HTTP security policy must not contain a semicolon ';' character in its `paths` property.
38
+
Use <<custom-http-security-policy>> when a security policy decision depends on a presence of certain matrix parameters in the request path.
39
+
====
40
+
41
+
[IMPORTANT]
42
+
====
43
+
Be careful with creating complex, possibly overlapping HTTP security policy path expressions.
44
+
Make sure your HTTP policy configuration is thoroughly tested.
45
+
If you work with Jakarta RESTful Web Services (JAX-RS) and need to create complex security policies, consider using <<standard-security-annotations>> instead.
0 commit comments