Skip to content

Commit 602cf1c

Browse files
committed
docs: fix all markdown linter warnings in firmware-reference-values.md
Add blank lines before all lists and code blocks to comply with markdownlint rules MD031 (blanks-around-fences) and MD032 (blanks-around-lists). Fixed warnings at lines: 138, 178, 187, 195, 221, 230, 238, 248
1 parent f2af79f commit 602cf1c

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

docs/firmware-reference-values.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@ The script creates a secret with this structure:
135135
```
136136

137137
**Key points:**
138+
138139
- Each field is an **array** of strings (supports multiple valid values)
139140
- Hash values are lowercase hex strings (SHA-384 = 96 hex chars)
140141
- Empty arrays `[]` mean "not available" - attestation will skip that check
@@ -175,6 +176,7 @@ The RVPS will automatically reload reference values from the `rvps-reference-val
175176
Different OpenShift versions may have different firmware measurements due to kernel/initrd changes. To support multiple versions:
176177

177178
1. **Collect from each version:**
179+
178180
```bash
179181
# OCP 4.18 cluster
180182
veritas collect --output refvals-ocp-4.18.json
@@ -184,6 +186,7 @@ Different OpenShift versions may have different firmware measurements due to ker
184186
```
185187

186188
2. **Merge the arrays:**
189+
187190
```json
188191
{
189192
"mr_td": ["<4.18-value>", "<4.19-value>"],
@@ -192,6 +195,7 @@ Different OpenShift versions may have different firmware measurements due to ker
192195
```
193196

194197
3. **Push merged values to Vault:**
198+
195199
```bash
196200
vault kv put secret/hub/firmwareReferenceValues \
197201
mr_td='["val1","val2"]' \
@@ -218,6 +222,7 @@ Veritas does not extract minimum required TCB levels (e.g., SNP microcode versio
218222
```
219223

220224
Then update the attestation policy to check:
225+
221226
```rego
222227
input.snp.report.reported_tcb.bootloader >= tcb_bootloader_min
223228
```
@@ -227,6 +232,7 @@ input.snp.report.reported_tcb.bootloader >= tcb_bootloader_min
227232
The SNP guest policy contains multiple flags (smt_allowed, migrate_ma, debug, etc.). Veritas reports the full policy word but does not break it into individual enforcement rules.
228233

229234
To enforce specific policy bits, add to attestation policy:
235+
230236
```rego
231237
input.snp.report.policy.smt_allowed == false
232238
input.snp.report.policy.debug == false
@@ -235,6 +241,7 @@ input.snp.report.policy.debug == false
235241
### 3. Container Image Measurements
236242

237243
Veritas does not measure the application container image digest. Image policy enforcement is handled separately via:
244+
238245
- Confidential Data Hub (CDH) pulling image from KBS
239246
- Kyverno policies validating image signatures (cosign, Notary)
240247

@@ -245,6 +252,7 @@ Veritas does not measure the application container image digest. Image policy en
245252
**Symptom:** `veritas collect` returns empty or errors
246253

247254
**Check:**
255+
248256
1. Pod is using `kata-remote` RuntimeClass
249257
2. Pod is actually running on bare metal (not Azure peer-pods)
250258
3. TEE device exists: `ls /dev/tdx_guest` (TDX) or `ls /dev/sev` (SNP)

0 commit comments

Comments
 (0)