From 8e2626182fc38f65551966e68b952c4f4ac83675 Mon Sep 17 00:00:00 2001
From: Dimitrij Drus <dimitrij.drus@innoq.com>
Date: Fri, 4 Feb 2022 12:51:15 +0100
Subject: [PATCH] doc about trafic integration

---
 docs/docs/guides/traefik-proxy-integration.md | 34 +++++++++++++++++++
 docs/sidebar.json                             |  2 +-
 2 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/guides/traefik-proxy-integration.md

diff --git a/docs/docs/guides/traefik-proxy-integration.md b/docs/docs/guides/traefik-proxy-integration.md
new file mode 100644
index 0000000000..12a21fa481
--- /dev/null
+++ b/docs/docs/guides/traefik-proxy-integration.md
@@ -0,0 +1,34 @@
+---
+id: traefik-proxy-integration
+title: Traefik Proxy Integration
+---
+
+[Traefik Proxy](https://doc.traefik.io/traefik/) is modern HTTP proxy and load balancer for microservices, oathkeeper can be integrated with via the [ForwardAuth Middleware](https://doc.traefik.io/traefik/middlewares/http/forwardauth/) by making use of the available [Access Control Decision API](index.md#access-control-decision-api).
+
+To achieve this,
+* configure traefik
+  * to make use of the aforesaid ForwardAuth middleware by setting the `address` property to the decision URL endpoint and
+  * by including the required header name(s), the oathkeeper sets in the HTTP responses into the `authResponseHeaders` property.
+* configure the route of your service to make use of this middleware
+
+Example (using Docker labels):
+
+```.yaml
+edge-router:
+  image: traefik
+  # further configuration
+  labels:
+    - traefik.http.middlewares.oathkeeper.forwardauth.address=http://oathkeeper:4456/decisions
+    - traefik.http.middlewares.oathkeeper.forwardauth.authResponseHeaders=X-Id-Token,Authorization
+    # further labels
+
+service:
+  image: my-service
+  # further configuration
+  labels:
+    - traefik.http.routers.service.middlewares=oathkeeper
+    # further labels
+```
+
+
+
diff --git a/docs/sidebar.json b/docs/sidebar.json
index d04a51075d..0ab14691e4 100644
--- a/docs/sidebar.json
+++ b/docs/sidebar.json
@@ -19,7 +19,7 @@
     ]
   },
   {
-    "Guides": ["configure-deploy"]
+    "Guides": ["configure-deploy", "guides/traefik-proxy-integration"]
   },
   "reference/api",
   {