Skip to content

Commit 60bb426

Browse files
rishabh-f5ryepup
andauthored
clarify allowed upload directories (#1020)
* clarify allowed upload directories * add missing worker-writable directories * add App Protect directory to filesystem * update filesystem restrictions * refactor file system table and restrictions * Update content etc nginx recommeded Co-authored-by: Ryan Davis <[email protected]> * remove plain text table --------- Co-authored-by: Ryan Davis <[email protected]>
1 parent 06ed6e9 commit 60bb426

File tree

1 file changed

+13
-10
lines changed
  • content/nginxaas-azure/getting-started/nginx-configuration

1 file changed

+13
-10
lines changed

content/nginxaas-azure/getting-started/nginx-configuration/overview.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,17 +25,20 @@ The topics below provide information on NGINX configuration restrictions and dir
2525
NGINX configurations stored in GitHub can be applied to existing NGINXaaS for Azure deployments using custom GitHub Action workflows. See [NGINXaaS for Azure Deployment Action](https://github.com/nginxinc/nginx-for-azure-deploy-action) for documentation and examples on how to incorporate these workflows in your GitHub Actions CI/CD pipelines.
2626

2727
## NGINX filesystem restrictions
28-
NGINXaaS for Azure places restrictions on the instance's filesystem; only a specific set of directories are allowed to be read from and written to. Below is a table describing what directories the NGINX worker process can read and write to and what directories files can be written to. These files include certificate files and any files uploaded to the deployment, excluding NGINX configuration files.
2928

30-
{{< table >}}
31-
| Allowed Directory | NGINX worker process can read/write to | Files can be written to |
32-
|------------------ | ----------------- | ----------------- |
33-
| /etc/nginx | | &check; |
34-
| /opt | &check; | &check; |
35-
| /srv | &check; | &check; |
36-
| /tmp | &check; | |
37-
| /var/cache/nginx | &check; | |
38-
| /var/www | &check; | &check; |
29+
NGINXaaS for Azure places restrictions on the instance’s filesystem; only a specific set of directories are allowed to be read from and written to. Below is a table describing what directories the NGINX worker process can read and write to and what directories files can be written to. These files include certificate files and any files uploaded to the deployment, excluding NGINX configuration files.
30+
31+
{{< table >}}
32+
33+
| Directory | Master Read | Master Write | Worker Read | Worker Write | Recommended Use |
34+
|-------------------|:-----------:|:------------:|:-----------:|:------------:|----------------------------------|
35+
| /etc/nginx/ | ✔️ | ✔️ ||| NGINX configuration, certificates, keys, application files (e.g. Lua or njs scripts) |
36+
| /opt/ | ✔️ | ✔️ | ✔️ || Application files (e.g. Lua scripts) |
37+
| /srv/ | ✔️ | ✔️ | ✔️ || Application files |
38+
| /var/www/ | ✔️ | ✔️ | ✔️ || Static files (e.g. index.html) |
39+
| /tmp/ | ✔️ | ✔️ | ✔️ | ✔️ | Temporary files |
40+
| /var/cache/nginx/ | ✔️ | ✔️ | ✔️ | ✔️ | Cache data |
41+
3942
{{< /table >}}
4043

4144
Attempts to access other directories will be denied and result in a `5xx` error.

0 commit comments

Comments
 (0)