From 992438d909b6b8ba7a29ee9f67dce295ab75426d Mon Sep 17 00:00:00 2001
From: fyksen <fredrik@fyksen.me>
Date: Wed, 23 Aug 2023 19:07:39 +0200
Subject: [PATCH] Added Tandoor Recipe documentation

---
 .../services/tandoor-recipes/index.md         | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 website/integrations/services/tandoor-recipes/index.md

diff --git a/website/integrations/services/tandoor-recipes/index.md b/website/integrations/services/tandoor-recipes/index.md
new file mode 100644
index 000000000..6843208c6
--- /dev/null
+++ b/website/integrations/services/tandoor-recipes/index.md
@@ -0,0 +1,69 @@
+---
+title: Tandoor Recipes
+---
+
+<span class="badge badge--secondary">Support level: Community</span>
+
+## What is Tandoor Recipes
+
+> Tandoor Recipes is an easy-to-use, powerful self-hosted food recipe manager.
+>
+> -- https://docs.tandoor.dev/
+
+Tandoor Recipy uses Django Allauth as the authentication engine. It supports Generic OATH 2, openid_connect.
+
+## Preparation
+
+The following placeholders will be used:
+
+-   `tandoor.company` is the FQDN of the Uptime Kuma install.
+-   `authentik.company` is the FQDN of the authentik install.
+
+### Provider
+
+Create an Provider in authentik with the following parameters:
+
+-   Client type
+
+    Confidential
+
+
+-   Client ID
+
+    Take note off Client ID.
+
+-   Client Secret
+
+    Take note off Client Secret.
+
+-   Redirect URIs/Origins (RegEx)
+
+    https://tandoor.company/accounts/authentik/login/callback/
+
+-   Signing Key
+
+    authentik Self-signed Certificate
+
+-   Leave the rest on default
+
+### Application
+
+Create a Application with the following parameters:
+
+-   Name: tandoor
+
+-   Provider: tandoor
+
+-   Leave rest on default
+
+## Tandoor Recipy
+
+-   Add this to your `.env` file (please make sure to insert your `server_url`, `client_id` and `secret`):
+
+```
+SOCIALACCOUNT_PROVIDERS={ "openid_connect": { "SERVERS": [{ "id": "authentik", "name": "Authentik", "server_url": "https://authentik.company/application/o/tandoor/.well-known/openid-configuration", "token_auth_method": "client_secret_basic", "APP": { "client_id": "ClientIdFromProvider", "secret": "SecretFromProvider" } } ] } }
+```
+
+-   Restart Tandoor, you should now see `Sign In Via Authentik` button.
+
+-   If you want to set your authentik user as administrator, log in as an administrator, then you can do so in the https://tandoor.company/admin/auth/user/ click the user you want to make admin, and mark the `Superuser status` and `Staff status`.