Skip to content

Commit 7963ff0

Browse files
committed
OSDOCS-17626 updated RNs
1 parent 26e8403 commit 7963ff0

File tree

1 file changed

+198
-3
lines changed

1 file changed

+198
-3
lines changed

security/zero_trust_workload_identity_manager/zero-trust-manager-release-notes.adoc

Lines changed: 198 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,207 @@ include::_attributes/common-attributes.adoc[]
77

88
toc::[]
99

10-
The {zero-trust-full} leverages Secure Production Identity Framework for Everyone (SPIFFE) and the SPIFFE Runtime Environment (SPIRE) to provide a comprehensive identity management solution for distributed systems. {zero-trust-full} supports SPIRE version 1.12.4 running as an operand.
10+
The {zero-trust-full} leverages Secure Production Identity Framework for Everyone (SPIFFE) and the SPIFFE Runtime Environment (SPIRE) to provide a comprehensive identity management solution for distributed systems.
1111

1212
These release notes track the development of {zero-trust-full}.
1313

14-
:FeatureName: Zero Trust Workload Identity Manager
15-
include::snippets/technology-preview.adoc[]
14+
[id="zero-trust-manager-release-notes-1-0-0"]
15+
== {zero-trust-full} 1.0.0 (General Availability)
16+
17+
Issued: 2025-12-17
18+
19+
This release of the {zero-trust-full} introduces new capabilities focused on enterprise readiness, security, and operational flexibility. Key features include SPIRE federation support for cross-cluster identity, PostgreSQL database support for production persistence, and enhanced security controls implemented through stricter Security Context Constraints (SCCs) and comprehensive API validation.
20+
21+
{zero-trust-full} supports the following components and versions:
22+
23+
[cols="1,1",options="header"]
24+
|===
25+
| Component
26+
| Version
27+
28+
| SPIRE Server
29+
| 1.13.3
30+
31+
| SPIRE Agent
32+
| 1.13.3
33+
34+
| SPIRE Controller Manager
35+
| 0.6.3
36+
37+
| SPIRE OIDC Discovery Provider
38+
| 1.13.3
39+
40+
| SPIFFE CSI Driver
41+
| 0.2.8
42+
|===
43+
44+
[id="zero-trust-manager-1-0-0-features-enhancements_{context}"]
45+
=== New features and enhancements
46+
47+
[id="zero-trust-manager-1-0-0-federation-support_{context}"]
48+
==== SPIRE federation support
49+
50+
The Operator now includes support for SPIRE federation, enabling workloads across distinct trust domains to securely communicate and authenticate with each other.
51+
52+
* Key capabilities:
53+
54+
** Configuration of bundle endpoints using `https_spiffe` (mTLS) or `https_web` (Web PKI) profiles.
55+
** Automatic certificate management via the ACME protocol (e.g., Let's Encrypt).
56+
** Automatic {product-title} route creation for federation endpoints.
57+
** Ability to configure relationships with multiple federated trust domains.
58+
59+
* Customer Action Required:
60+
61+
** Review the `federation` configuration within the `SpireServer` Custom Resource (CR).
62+
** Ensure proper DNS resolution and network connectivity to federated trust domains.
63+
64+
[id="zero-trust-manager-1-0-0-postgres-database-support_{context}"]
65+
==== PostgreSQL database support
66+
67+
SPIRE Server now supports PostgreSQL as an external database backend, accommodating production deployments that necessitate enterprise-grade data persistence and high availability.
68+
69+
* Supported Types: sqlite3 (default), postgres, mysql.
70+
71+
* Customer action required:
72+
73+
** For production, evaluation of migration from SQLite to PostgreSQL is recommended.
74+
** Creation and configuration of Kubernetes Secrets for database TLS certificates and credentials are required.
75+
76+
[id="zero-trust-manager-1-0-0-configurable-socketpath-plugin-name_{context}"]
77+
==== Configurable agent socket path and Container Storage Interface (CSI) plugin name
78+
79+
The SPIRE Agent socket path and the SPIFFE CSI Driver plugin name are now configurable, providing operational flexibility for environments with specific directory requirements or co-existence with multiple SPIFFE deployments.
80+
81+
* Key configuration points:
82+
83+
** `SpireAgent.spec.socketPath`
84+
** `SpiffeCSIDriver.spec.agentSocketPath`
85+
** `SpiffeCSIDriver.spec.pluginName`
86+
87+
* Customer action required:
88+
89+
** Ensure consistency between `socketPath` in the `SpireAgent` CR and `agentSocketPath` in the `SpiffeCSIDriver` CR.
90+
91+
[id="zero-trust-manager-1-0-0-workload-attestors_{context}"]
92+
==== Workload attestors verification API
93+
94+
A new API has been introduced to configure kubelet certificate verification for workload attestation, enhancing security and supporting various OpenShift configurations.
95+
96+
* Verification types:
97+
98+
** `auto` (default): Verification utilizes OpenShift defaults (`/etc/kubernetes/kubelet-ca.crt`).
99+
** `hostCert`: Uses a custom CA certificate path.
100+
** `skip`: Skips TLS verification (not recommended for production use).
101+
102+
[id="zero-trust-manager-1-0-0-configurable-CA-JWT_{context}"]
103+
==== Configurable Certificate Authority and JSON Web Token key types
104+
105+
Administrators can now configure the cryptographic key types used for the SPIRE Server Certificate Authority (CA) and JSON Web Token (JWT) signing, ensuring compliance with organizational security policies.
106+
107+
* Supported Key Types: `rsa-2048` (default), `rsa-4096`, `ec-p256`, `ec-p384`.
108+
109+
* Customer action required:
110+
111+
** Review organizational security policies to determine required key types.
112+
113+
[id="zero-trust-manager-1-0-0-custom-namespace-deployment_{context}"]
114+
==== Custom namespace deployment
115+
116+
* The Operator and all associated operands can now be deployed within a custom namespace, providing flexibility for organizations with specific namespace governance requirements.
117+
118+
[id="zero-trust-manager-1-0-0-proxy-aware-operator-operands_{context}"]
119+
==== Proxy-aware Operator and operands
120+
121+
* The Operator and all managed operands are now proxy-aware and automatically inherit cluster-wide proxy settings when configured.
122+
123+
[id="zero-trust-manager-1-0-0-enhanced-security-context_{context}"]
124+
==== Enhanced Security Context Constraints
125+
126+
* SPIRE Agent and SPIFFE CSI Driver now operate under the restricted Security Context Constraints (SCC).
127+
128+
* The Operator and all operand containers are configured with the `ReadOnlyRootFilesystem` set to `true`.
129+
130+
[id="zero-trust-manager-1-0-0-enhanced-api-validation_{context}"]
131+
==== Enhanced API validation
132+
133+
Comprehensive Common Expression Language (CEL) validation has been integrated into all Custom Resource Definitions (CRDs) to prevent configuration errors during admission control.
134+
135+
* Key validations:
136+
137+
** All Operator CRDs are enforced as singletons (must be named `cluster`).
138+
** Immutable Fields: Fields including `trustDomain`, `clusterName`, `bundleConfigMap`, federation `bundleEndpoint`, and all `Persistence` settings (`size`, `accessMode`, and `storageClass`) are now immutable after initial creation.
139+
140+
* Customer action required:
141+
142+
** Review existing CR configurations to ensure compliance with the new validation rules.
143+
144+
[id="zero-trust-manager-1-0-0-common-configuration_{context}"]
145+
==== Common configuration consolidation
146+
147+
* Standard configuration options (`labels`, `resources`, `affinity`, `tolerations`, `nodeSelector`) are now standardized across all operand CRs via a shared `CommonConfig` structure.
148+
149+
[id="zero-trust-manager-1-0-0-configure-loglevel-logformat_{context}"]
150+
==== Configuring log level and log format for the operands
151+
152+
This release introduces flexible logging controls to improve observability and debugging across the platform:
153+
154+
* SPIRE Components: Users can now configure the `logLevel` (debug, info, warn, error) and `logFormat` (text, JSON) independently for `SpireServer`, `SpireAgent`, and `SpireOIDCDiscoveryProvider` directly within their CR specifications. The defaults are set to "info" for the `logLevel` and "text" for the `logFormat.
155+
156+
* Operator: The operator’s log verbosity is now configurable via the `OPERATOR_LOG_LEVEL` environment variable using klog’s `textlogger`.
157+
158+
[id="zero-trust-manager-1-0-0-create-only-mode_{context}"]
159+
==== Refactor for create-only mode
160+
161+
By setting the `CREATE_ONLY_MODE` environment variable, users can prevent the operator from reconciling updates. This allows for manual resource modification without interference. If this mode is disabled, the Operator resumes enforcing the state and overwrites any manual changes.
162+
163+
[id="zero-trust-manager-1-0-0-status-observability-improvements_{context}"]
164+
=== Status and observability improvements
165+
166+
[id="zero-trust-manager-1-0-0-enhanced-status-reporting_{context}"]
167+
==== Enhanced status reporting
168+
169+
* The main CR now aggregates status information from all operand CRs.
170+
171+
* New status conditions include Upgradeable (indicating a safe upgrade path) and Progressing (detailing deployment progress).
172+
173+
[id="zero-trust-manager-1-0-0-operator-metrics_{context}"]
174+
==== Operator metrics
175+
176+
* Operator metrics are now exposed and secured with appropriate RBAC configuration.
177+
178+
* Integration is supported with the OpenShift monitoring stack.
179+
180+
[id="zero-trust-manager-1-0-0-bug-fixes_{context}"]
181+
=== Bug fixes
182+
183+
[cols="1,1",options="header"]
184+
|===
185+
| Issue ID
186+
| Description
187+
188+
| SPIRE-60
189+
| Agent runs as non-root user.
190+
191+
| SPIRE-68
192+
| Updating the operands CR spec sometimes does not trigger reconciliation.
193+
194+
| SPIRE-190
195+
| Updating the operands CR spec sometimes does not trigger reconciliation.
196+
197+
| SPIRE-248
198+
| Corrected update logic for `StatefulSet`, `Deployment`, and `DaemonSet` to properly handle operand updates.
199+
200+
| SPIRE-225
201+
| Resolved SPIRE OIDC Discovery Provider restart issue following `ConfigMap`` changes via the CR.
202+
203+
| SPIRE-195
204+
| Fixed reconciliation issue in the spire-controller-manager `ConfigMap`.
205+
206+
| Other fixed issues
207+
| Fixed issues related to continuous reconciliation and unnecessary updates.
208+
209+
Eliminated requeue logic for user input validation errors.
210+
|===
16211

17212
[id="zero-trust-manager-release-notes-0-2-0"]
18213
== {zero-trust-full} 0.2.0 (Technology Preview)

0 commit comments

Comments
 (0)