DOCS add secure application access draft

[fabianmuehlberger]

I started writing a tutorial regarding security of TrueNAS applications.

I would have created an Issue for my proposal but created a fork and PR instead. Furthermore, I am not sure if this belongs in master since it is still a draft, but wanted some feedback. Since I am relatively new to TrueNAS it is likely that my contribution contains errors.

I for now I created a _index.md with the content, under Apps/AppSecurity and stored the images under src/static/SCALE/Apps. In frontmatter I added the author (me) and set draft: true

Guidance for further work is appreciated!

Thanks for contributing to TrueNAS documentation! By opening a Pull Request, you're acknowledging that your changes will be distributed under the Creative Commons 4.0 license.

[DjP-iX]

Thank you for the excellent contribution @fabianmuehlberger!

I've left a number of (largely stylistic) suggestions, but the overall procedure looks good.

Note that we're probably going to move this from an index to something like /apps/SecuringApps.md before publishing, but leaving it here for now will let you see the suggestions easier.

[fabianmuehlberger]

Hey @DjP-iX thank you for the prompt reply. Since I went through the process of setting up those applications (first time TrueNAS owner), I thought I write it down while I have it in memory.

Preferably, if you like, I would commit to e.g. "DEV DOC appsecurity" branch created by you. Otherwise, I can stay on my fork if you prefer that.

TY for the suggestions, I hope to implement them tomorrow.

Note that we're probably going to move this from an index to something like /apps/SecuringApps.md before publishing, but leaving it here for now will let you see the suggestions easier.

Regarding the doc structure, I intend to cover multiple ways of securing applications, including Cloudflare, Tailscale, etc. ideally in a more generalized approach, and with the help of the community.
I am not sure about the document structure, depending on the covered areas and apps, I think it should be split into different pages, for easier editing.

Best Fabian

[fabianmuehlberger]

Regarding the image credit, I tried to use "caption"

{{< trueimage src="/images/SCALE/Apps/CloudflareTunnelOverview.jpg" alt="Cloudflare Tunnel Overview" id="Cloudflare Tunnel Overview" caption="cloudflare.com" >}} but that does not work. How should I give credit correctly?

[fabianmuehlberger]

I am not sure how to add a relative ref to an anchor.

line 24: See [security]{{< relref "_index.md#additional-security-considerations" >}}

[DjP-iX]

Looking good @fabianmuehlberger!

If you're planning to contribute additional articles on this subject, then I think we are fine to leave this as an index instead of an individual article.

[fabianmuehlberger]

For splitting the document, I suggest, having everything related to a specific app (in that case, Cloudflare separated).

I would keep it as it is, until there is new content.

stale

[DjP-iX]

Thanks again @fabianmuehlberger!

This one is merged, but feel free to continue working in your fork and open a PR against our Master branch if you have any further changes. Likewise if you do write any further content for other apps/solutions. We'll be happy to see your contributions.

[fabianmuehlberger]

Thank you for the support and lending me a hand! This was my first bigger contribution to a project.