Skip to content

Commit 601b83d

Browse files
committed
Update Status section
1 parent 7b88681 commit 601b83d

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

docs/proposals/authentication-filter.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -831,10 +831,14 @@ This example shows a single HTTPRoute, with a single `filter` defined in a `rule
831831
Only a single `AuthenticationFilter` may be referened in a single rule.
832832

833833
The `Status` the HTTPRoute/GRPCRoute in this scenario should be set to `Invalid`, and the resource should be `Rejected`.
834+
In this scenario, the route rule that is referencing multiple `AuthenticationFilter` resources will be `Rejected`/
835+
All other route rules will remain working.
836+
837+
The HTTPRoute/GRPCRoute resource will display an `UnresolvedRef` message to inform the user that the rule has been `Rejected`.
834838

835839
This behaviour falls in line with the expected behaviour of filters in the Gateway API, which generally allows only one type of a specific filter (authentication, rewriting, etc.) within a rule.
836840

837-
Below is an example of an **invalid** HTTPRoute that references multiple `AuthenticationFilter` resources in a single rule
841+
Below is an example of an **invalid** HTTPRoute that references multiple `AuthenticationFilter` resources in a single rule:
838842

839843
```yaml
840844
apiVersion: gateway.networking.k8s.io/v1
@@ -867,6 +871,11 @@ spec:
867871
port: 80
868872
```
869873

874+
#### Referencing an AuthenticationFilter resource that is invalid
875+
876+
Note: With appropriate use of CEL validation, we are less likely to encounter a scenario where an AuthenticationFilter has been deployed to the cluster with an invalid configuration.
877+
If this does happen, and a route rule references this AuthenticationFilter, the route rule will be set to `Invalid` and the the HTTPRoute/GRPCRoute will display the `UnresolvedRef` status.
878+
870879
#### Attaching a JWT AuthenticationFilter to a route when using NGINX OSS
871880

872881
If a user attempts to attach a JWT type AuthenticationFilter while using NGINX OSS, the rule referencing the filter will be `Rejected`.

0 commit comments

Comments
 (0)