kata-containers/docs/use-cases
Jakob Naucke d808cef2fb
agent: AP bind-associate for Secure Execution
Kata Containers has support for both the IBM Secure Execution trusted
execution environment and the IBM Crypto Express hardware security
module (used via the Adjunct Processor bus), but using them together
requires specific steps.

In Secure Execution, the Acceleration and Enterprise PKCS11 modes of
Crypto Express are supported. Both modes require the domain to be
_bound_ in the guest, and the latter also requires the domain to be
_associated_ with a _guest secret_. Guest secrets must be submitted to
the ultravisor from within the guest.

Each EP11 domain has a master key verification pattern (MKVP) that can
be established at HSM setup time. The guest secret and its ID are to
be provided at `/vfio_ap/{mkvp}/secret` and
`/vfio_ap/{mkvp}/secret_id` via a key broker service respectively.

Bind each domain, and for each EP11 domain,
- get the secret and secret ID from the addresses above,
- submit the secret to the ultravisor,
- find the index of the secret corresponding to the ID, and
- associate the domain to the index of this secret.

To bind, add the secret, parse the info about the domain, and
associate, the s390_pv_core crate is used. The code from this crate
also does the AP online check, which can be removed from here.

Signed-off-by: Jakob Naucke <jakob.naucke@ibm.com>
2025-03-26 16:37:23 +01:00
..
CEX-passthrough-and-coco.md agent: AP bind-associate for Secure Execution 2025-03-26 16:37:23 +01:00
GPU-passthrough-and-Kata.md docs: Document Intel Discrete GPUs usage with Kata 2024-04-16 11:50:02 -07:00
Intel-Discrete-GPU-passthrough-and-Kata.md docs: Document Intel Discrete GPUs usage with Kata 2024-04-16 11:50:02 -07:00
Intel-GPU-passthrough-and-Kata.md docs: Remove table of contents 2021-07-30 10:58:22 +01:00
NVIDIA-GPU-passthrough-and-Kata.md docs: add doc about building kernel with upcall and GPU hotplug 2024-03-25 20:25:17 +08:00
using-Intel-QAT-and-kata.md docs: replace egrep/fgrep with grep -E/-F to avoid deprecation warning 2025-01-29 11:25:54 +01:00
using-Intel-SGX-and-kata.md docs: Fix volumeMounts in SGX usage example 2022-10-25 23:20:49 -07:00
using-SPDK-vhostuser-and-kata.md docs: remove duplicate sentences 2022-12-17 11:26:36 +00:00
using-SRIOV-and-kata.md docs: replace egrep/fgrep with grep -E/-F to avoid deprecation warning 2025-01-29 11:25:54 +01:00