diff options
author | Andrew Clayton <a.clayton@nginx.com> | 2023-08-09 18:22:46 +0100 |
---|---|---|
committer | Andrew Clayton <a.clayton@nginx.com> | 2023-08-17 13:09:49 +0100 |
commit | 47ff51009fa05d83bb67cd5db16829ab4c0081d7 (patch) | |
tree | 48066be1f1bd013314fcb2ebb23422146cf9f492 /auto/help | |
parent | e99854afdf555678df5af149e53659c5b30a2f6d (diff) | |
download | unit-47ff51009fa05d83bb67cd5db16829ab4c0081d7.tar.gz unit-47ff51009fa05d83bb67cd5db16829ab4c0081d7.tar.bz2 |
Wasm: Add support for directory access.
Due to the sandboxed nature of WebAssembly, by default WASM modules
don't have any access to the underlying filesystem.
There is however a capabilities based mechanism[0] for allowing such
access.
This adds a config option to the 'wasm' application type;
'access.filesystem' which takes an array of directory paths that are
then made available to the WASM module. This access works recursively,
i.e everything under a specific path is allowed access to.
Example config might look like
"access" {
"filesystem": [
"/tmp",
"/var/tmp"
]
}
The actual mechanism used allows directories to be mapped differently in
the guest. But at the moment we don't support that and just map say /tmp
to /tmp. This can be revisited if it's something users clamour for.
Network sockets are another resource that may be controlled in this
manner, for example there is a wasi_config_preopen_socket() function,
however this requires the runtime to open the network socket then
effectively pass this through to the guest.
This is something that can be revisited in the future if users desire
it.
[0]:
<https://github.com/bytecodealliance/wasmtime/blob/main/docs/WASI-capabilities.md>
Reviewed-by: Alejandro Colomar <alx@nginx.com>
Signed-off-by: Andrew Clayton <a.clayton@nginx.com>
Diffstat (limited to 'auto/help')
0 files changed, 0 insertions, 0 deletions