lowRISC / lowRISC/opentitan

[keymgr, kmac] Entropy error code SW guideline

Open
#17,785 1 comment 0 reactions 1 assignee View on GitHub

@vogelpi is already working on this.

Since Sep 15, 2026.

Component:Doc Component:Software Earlgrey-PROD Candidate IP:keymgr IP:kmac Priority:P2 SW:cryptolib
Dominant language
SystemVerilog
Stars
3.6k
Forks
1.1k
Avg merge
2d 22h
Merged PRs (30d)
141

Description

### Description

Spin-off from https://github.com/lowRISC/opentitan/issues/15088#issuecomment-1346193920.

If KMAC encounters entropy related error during keymgr initiated operation, then this error is not reported back to keymgr. Therefore, until we fix the error reporting mechanism https://github.com/lowRISC/opentitan/issues/15088, SW needs to remedy this by checking:

- Before the operation, KMAC does not have any error.
- After the operation, KMAC did not report any error.

> estimate 4

We also need to update SW guidelines. Additionally, maybe SW should also check that KMAC is configured in EDN mode, instead of SW provided seed. This last part is open to discussion.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.