doc: extend the alpha config changelog notice

Signed-off-by: Jan Larwig <jan@larwig.com>
This commit is contained in:
Jan Larwig 2026-01-16 20:36:38 +01:00
parent a360cb3875
commit 3bc1a5373a
No known key found for this signature in database
GPG Key ID: C2172BFA220A037A
1 changed files with 33 additions and 1 deletions

View File

@ -17,7 +17,7 @@
- [CVE-2025-61727](https://access.redhat.com/security/cve/cve-2025-61727)
- [CVE-2025-47914](https://access.redhat.com/security/cve/cve-2025-47914)
- [CVE-2025-58181](https://access.redhat.com/security/cve/cve-2025-58181)
- 🗂️ Alpha Config YAML parsing revamped using mapstructure with custom decoders
- 🗂️ AMajor Alpha Config YAML parsing revamped for better extensibility and preparing v8
- 🐛 Squashed some bugs
## Important Notes
@ -51,6 +51,38 @@ injectRequestHeaders:
value: my-super-secret
```
Furthermore, Alpha Config now fully supports configuring the `Server` struct using YAML.
```yaml
// Server represents the configuration for the Proxy HTTP(S) configuration.
type Server struct {
// BindAddress is the address on which to serve traffic.
BindAddress string `yaml:"bindAddress,omitempty"`
// SecureBindAddress is the address on which to serve secure traffic.
SecureBindAddress string `yaml:"secureBindAddress,omitempty"`
// TLS contains the information for loading the certificate and key for the
// secure traffic and further configuration for the TLS server.
TLS *TLS `yaml:"tls,omitempty"`
}
// TLS contains the information for loading a TLS certificate and key
// as well as an optional minimal TLS version that is acceptable.
type TLS struct {
// Key is the TLS key data to use.
Key *SecretSource `yaml:"key,omitempty"`
// Cert is the TLS certificate data to use.
Cert *SecretSource `yaml:"cert,omitempty"`
// MinVersion is the minimal TLS version that is acceptable.
MinVersion string `yaml:"minVersion,omitempty"`
// CipherSuites is a list of TLS cipher suites that are allowed.
CipherSuites []string `yaml:"cipherSuites,omitempty"`
}
```
More about how to use Alpha Config can be found in the [documentation](https://oauth2-proxy.github.io/oauth2-proxy/configuration/alpha-config#server).
We are committed to Semantic Versioning and usually avoid breaking changes without a major version release.
Advancing Alpha Config toward its Beta stage required this exception, and even for the Alpha Config we try
to keep breaking changes in v7 to a minium. Thank you for understanding the need for this step to prepare