Skip to content

Latest commit

 

History

History
30 lines (17 loc) · 1.67 KB

vaultmgr.md

File metadata and controls

30 lines (17 loc) · 1.67 KB

Vault Manager Microservice

Vault Manager is responsible for providing data security at rest on EVE. For more details refer to https://github.com/lfedge/eve/blob/master/docs/SECURITY.md https://wiki.lfedge.org/display/EVE/Encrypting+Sensitive+Information+at+Rest+at+the+Edge

Vault

A "Vault" refers to a directory, where files under that directory are stored in encrypted format on the disk.

Default Vaults

Currently vaultmgr creates one vaults on the device persist/vault. This is created when a device is booting for the first time, after the installation.

Encryption Tool

EVE uses fscrypt, an open source tool to encrypt files using native file system capability of Linux Kernel. For more details, please refer to https://github.com/google/fscrypt

Vault Keys

The encryption key is randomly generated during first time installation, and stored inside TPM. This encryption key is used to encrypt/unlock the Vaults.

Troubleshooting

One can use /opt/zededa/bin/fscrypt command to print the status of vaults on the pillar shell prompt. To see logs from vaultmgr, one can find recent ones with source being vaultmgr it under /persist/newlog/devUpload using zcat if it has not been uploaded to controller or on the controller.

Future Work

There is a lot of scope for further hardening of data security at rest, at the Edge. Please refer to https://wiki.lfedge.org/display/EVE/Security+APIs for future enhancements being discussed.