From bc1a0b231e0afcc3b14e4b8a47274bf5913d2a2b Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Mon, 27 May 2024 23:17:57 +0200
Subject: [PATCH] chore(kb): start articles about proxies

---
 .vscode/settings.json                 |  1 +
 knowledge base/acme.md                |  7 +++
 knowledge base/nginx proxy manager.md | 63 +++++++++++++++++++++++++
 knowledge base/nginx.md               | 63 +++++++++++++++++++++++++
 knowledge base/proxy.md               | 47 +++++++++++++++++++
 knowledge base/traefik.md             | 67 +++++++++++++++++++++++++++
 6 files changed, 248 insertions(+)
 create mode 100644 knowledge base/nginx proxy manager.md
 create mode 100644 knowledge base/nginx.md
 create mode 100644 knowledge base/proxy.md
 create mode 100644 knowledge base/traefik.md

diff --git a/.vscode/settings.json b/.vscode/settings.json
index 6ca7c42..3557a84 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -286,6 +286,7 @@
         "todomd",
         "tolerations",
         "tput",
+        "traefik",
         "truenas",
         "trufflehog",
         "turris",
diff --git a/knowledge base/acme.md b/knowledge base/acme.md
index 8449ea9..a746d76 100644
--- a/knowledge base/acme.md	
+++ b/knowledge base/acme.md	
@@ -9,6 +9,11 @@ Protocol allowing for automation of issuance and renewal of certificates.
 
 - [Let's Encrypt]
 
+Providers:
+
+- [Nginx Proxy Manager]
+- [Traefik]
+
 ### Sources
 
 - [What is ACME protocol and how does it work?]
@@ -21,6 +26,8 @@ Protocol allowing for automation of issuance and renewal of certificates.
 <!-- In-article sections -->
 <!-- Knowledge base -->
 [let's encrypt]: letsencrypt.md
+[nginx proxy manager]: nginx%20proxy%20manager.md
+[traefik]: traefik.md
 
 <!-- Files -->
 <!-- Upstream -->
diff --git a/knowledge base/nginx proxy manager.md b/knowledge base/nginx proxy manager.md
new file mode 100644
index 0000000..ad9dc34
--- /dev/null
+++ b/knowledge base/nginx proxy manager.md	
@@ -0,0 +1,63 @@
+# Nginx Proxy Manager
+
+TODO
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Installation and configuration</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [Proxy]
+- [Nginx]
+- [Website]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[nginx]: nginx.md
+[proxy]: proxy.md
+
+<!-- Files -->
+<!-- Upstream -->
+[website]: https://nginxproxymanager.com/
+
+<!-- Others -->
diff --git a/knowledge base/nginx.md b/knowledge base/nginx.md
new file mode 100644
index 0000000..9a80469
--- /dev/null
+++ b/knowledge base/nginx.md	
@@ -0,0 +1,63 @@
+# nginx
+
+TODO
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Installation and configuration</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [Proxy]
+- [Website]
+- [Nginx Proxy Manager]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[nginx proxy manager]: nginx%20proxy%20manager.md
+[proxy]: proxy.md
+
+<!-- Files -->
+<!-- Upstream -->
+[website]: https://nginx.org/en/
+
+<!-- Others -->
diff --git a/knowledge base/proxy.md b/knowledge base/proxy.md
new file mode 100644
index 0000000..12712c7
--- /dev/null
+++ b/knowledge base/proxy.md	
@@ -0,0 +1,47 @@
+# Proxy
+
+Application acting as an intermediary between a client requesting a resource and the server providing that resource.<br/>
+It may reside on one's local host or at any point between it and destination servers on the Internet.
+
+Proxy servers passing unmodified requests and responses are usually called _gateways_ or _tunneling proxies_.<br/>
+_Anonymous_ proxies reveal their identity as proxy servers but do not disclose the originating IP address of clients.<br/>
+_Transparent_ proxies identify themself as proxy servers but also give the originating IP address away using HTTP header
+fields like `X-Forwarded-For`.
+
+1. [Forwarding proxy](#forwarding-proxy)
+1. [Reverse proxy](#reverse-proxy)
+1. [Further readings](#further-readings)
+
+## Forwarding proxy
+
+Internet-facing proxies used to retrieve and eventually cache data from a wide range of sources (in most cases, anywhere
+on the Internet).
+
+## Reverse proxy
+
+Proxy servers that accept connections from clients, forward them to one or more backend servers to handle the requests,
+and return the response as if it came directly from them.<br/>
+This should leave the clients with no knowledge of the backend servers.
+
+Reverse proxies commonly perform load-balancing, authentication, decryption and caching.
+
+## Further readings
+
+Reverse proxies:
+
+- [Nginx]
+- [Traefik]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[nginx]: nginx.md
+[traefik]: traefik.md
+
+<!-- Files -->
+<!-- Upstream -->
+<!-- Others -->
diff --git a/knowledge base/traefik.md b/knowledge base/traefik.md
new file mode 100644
index 0000000..b2ef22b
--- /dev/null
+++ b/knowledge base/traefik.md	
@@ -0,0 +1,67 @@
+# Traefik
+
+TODO
+
+Cloud native application proxy.
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Installation and configuration</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [Proxy]
+- [Website]
+- [Github]
+- [Documentation]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[proxy]: proxy.md
+
+<!-- Files -->
+<!-- Upstream -->
+[documentation]: https://doc.traefik.io/traefik/
+[github]: https://github.com/traefik/traefik/
+[website]: https://traefik.io/traefik/
+
+<!-- Others -->