Skip to content

Commit a27c18d

Browse files
committed
gep: provisional GEP for CRL
Signed-off-by: Norwin Schnyder <[email protected]>
1 parent 78f48a1 commit a27c18d

File tree

4 files changed

+74
-0
lines changed

4 files changed

+74
-0
lines changed

geps/gep-1897/metadata.yaml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ authors:
99
- robscott
1010
- youngnick
1111
relationships:
12+
extendedBy:
13+
- number: 4080
14+
name: Certificate Revocation Lists for Certificate Validiation
1215
obsoletes:
1316
- number: 1282
1417
name: Describing Backend Properties

geps/gep-4080/index.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# GEP-4080: Certificate Revocation Lists for Certificate Validiation
2+
3+
* Issue: [#4080](https://github.com/kubernetes-sigs/gateway-api/issues/4080)
4+
* Status: Provisional
5+
6+
(See [status definitions](../overview.md#gep-states).)
7+
8+
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
9+
"SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this
10+
document are to be interpreted as described in BCP 14 ([RFC8174]) when, and
11+
only when, they appear in all capitals, as shown here.
12+
13+
[RFC8174]: https://www.rfc-editor.org/rfc/rfc8174
14+
15+
## What
16+
Extend the TLS certificate validation mechanisms defined in [GEP-91](../gep-91/index.md) (Frontend TLS Validation) and [GEP-1897](../gep-1897/index.md) (Backend TLS Validation) by introducing support for Certificate Revocation Lists (CRLs).
17+
18+
With this enhancement, operators and application developpers can configure CRLs that Gateways use during TLS authentication, both when verifying clients connecting to the Gateway and when verifying backends that the Gateway connects to. In both cases, the Gateway will check the presented certificate against the configured CRLs to ensure it has not been revoked by the issuing Certificate Authority (CA).
19+
20+
## Why
21+
While [GEP-91](../gep-91/index.md) and [GEP-1897](../gep-1897/index.md) define how certificates are validated against trusted CAs, neither addresses the issue of revocation. In practice, certificates may need to be revoked long before expiration (e.g., if private keys are compromised, a device is decommissioned, or access rights are withdrawn). Without revocation checks, Gateways may continue to trust certificates that should no longer be valid, exposing clusters to unauthorized access.
22+
23+
This limitation is critical in two directions:
24+
* On the client side, a revoked certificate could still authenticate and gain access if CRLs are not enforced.
25+
* On the backend side, the Gateway could continue to route requests to services or workloads using revoked credentials, undermining the security of service-to-service communication.
26+
27+
## Who: Beneficiaries
28+
* **Application Developers**: Gain stronger guarantees that their applications are protected from unauthorized clients and backends using revoked certificates.
29+
* **Platform Operators/Administrators**: Without CRL support, the only way to remain secure in the face of a compromised certificate is to rotate the entire CA and reissue all certificates, which is an expensive, disruptive, and often impractical operation. CRL support eliminates this burden by allowing platform operators to revoke only the compromised certificates while leaving the rest of the trust hierarchy intact.

geps/gep-4080/metadata.yaml

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
apiVersion: internal.gateway.networking.k8s.io/v1alpha1
2+
kind: GEPDetails
3+
number: 4080
4+
name: Certificate Revocation Lists for Certificate Validiation
5+
status: Provisional
6+
# Any authors who contribute to the GEP in any way should be listed here using
7+
# their GitHub handle.
8+
authors:
9+
- snorwin
10+
relationships:
11+
# obsoletes indicates that a GEP makes the linked GEP obsolete, and completely
12+
# replaces that GEP. The obsoleted GEP MUST have its obsoletedBy field
13+
# set back to this GEP, and MUST be moved to Declined.
14+
obsoletes: {}
15+
obsoletedBy: {}
16+
# extends indicates that a GEP extends the linked GEP, adding more detail
17+
# or additional implementation. The extended GEP MUST have its extendedBy
18+
# field set back to this GEP.
19+
extends:
20+
- number: 91
21+
name: Client Certificate Validation for TLS terminating at the Gateway Listener
22+
- number: 1897
23+
name: TLS from Gateway to Backend for ingress (backend TLS termination)
24+
extendedBy: {}
25+
# seeAlso indicates other GEPs that are relevant in some way without being
26+
# covered by an existing relationship.
27+
seeAlso: {}
28+
# references is a list of hyperlinks to relevant external references.
29+
# It's intended to be used for storing GitHub discussions, Google docs, etc.
30+
references: {}
31+
# featureNames is a list of the feature names introduced by the GEP, if there
32+
# are any. This will allow us to track which feature was introduced by which GEP.
33+
# This is the value added to supportedFeatures and the conformance tests, in string form.
34+
featureNames: {}
35+
# changelog is a list of hyperlinks to PRs that make changes to the GEP, in
36+
# ascending date order.
37+
changelog: {}

geps/gep-91/metadata.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,8 @@ name: Client Certificate Validation for TLS terminating at the Gateway Listener
55
status: Provisional
66
authors:
77
- arkodg
8+
relationships:
9+
extendedBy:
10+
- number: 4080
11+
name: Certificate Revocation Lists for Certificate Validiation
12+

0 commit comments

Comments
 (0)