From e585ce6df855c7f3e53b2730990143691eb8e41b Mon Sep 17 00:00:00 2001 From: MohamedBassem Date: Sun, 15 Sep 2024 18:00:23 +0000 Subject: [PATCH] docs: Fix docs build and add sso to readme --- README.md | 1 + docs/docs/01-intro.md | 1 + docs/docs/03-configuration.md | 22 +++++++++++++--------- 3 files changed, 15 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 7564fef5..317f6829 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ A self-hostable bookmark-everything app with a touch of AI for the data hoarders - 📱 An [iOS app](https://apps.apple.com/us/app/hoarder-app/id6479258022), and an [Android app](https://play.google.com/store/apps/details?id=app.hoarder.hoardermobile&pcampaignid=web_share). - 🗄️ Full page archival (using [monolith](https://github.com/Y2Z/monolith)) to protect against link rot. - ☑️ Bulk actions support. +- 🔐 SSO support. - 🌙 Dark mode support. - 💾 Self-hosting first. - [Planned] Downloading the content for offline reading. diff --git a/docs/docs/01-intro.md b/docs/docs/01-intro.md index 477dc315..1e9dd263 100644 --- a/docs/docs/01-intro.md +++ b/docs/docs/01-intro.md @@ -20,6 +20,7 @@ Hoarder is an open source "Bookmark Everything" app that uses AI for automatical - 📱 An [iOS app](https://apps.apple.com/us/app/hoarder-app/id6479258022), and an [Android app](https://play.google.com/store/apps/details?id=app.hoarder.hoardermobile&pcampaignid=web_share). - 🗄️ Full page archival (using [monolith](https://github.com/Y2Z/monolith)) to protect against link rot. - ☑️ Bulk actions support. +- 🔐 SSO support. - 🌙 Dark mode support. - 💾 Self-hosting first. - [Planned] Downloading the content for offline reading. diff --git a/docs/docs/03-configuration.md b/docs/docs/03-configuration.md index e7b13e97..f026977e 100644 --- a/docs/docs/03-configuration.md +++ b/docs/docs/03-configuration.md @@ -21,15 +21,19 @@ The flags need to be provided to the `web` container. Only OIDC compliant OAuth providers are supported! For information on how to set it up, consult the documentation of your provider. ::: -| Name | Required | Default | Description | -| ------------------------------------------- | -------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -| DISABLE_SIGNUPS | No | false | If enabled, no new signups will be allowed and the signup button will be disabled in the UI | -| OAUTH_WELLKNOWN_URL | No | Not set | The "wellknown Url" for openid-configuration as provided by the OAuth provider | -| OAUTH_CLIENT_SECRET | No | Not set | The "Client Secret" as provided by the OAuth provider | -| OAUTH_CLIENT_ID | No | Not set | The "Client ID" as provided by the OAuth provider | -| OAUTH_SCOPE | No | "openid email profile" | "Full list of scopes to request (space delimited)" | -| OAUTH_PROVIDER_NAME | No | "Custom Provider" | The name of your provider. Will be shown on the signup page as "Sign in with " | -| OAUTH_ALLOW_DANGEROUS_EMAIL_ACCOUNT_LINKING | No | false | Whether existing accounts in hoarder stored in the database should automatically be linked with your OAuth account. DANGEROUS, but can also be helpful! | +:::info +When setting up OAuth, the allowed redirect URLs configured at the provider should be set to `/api/auth/callback/custom` where `` is the address you configured in `NEXTAUTH_URL` (for example: `https://try.hoarder.app/api/auth/callback/custom`). +::: + +| Name | Required | Default | Description | +| ------------------------------------------- | -------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| DISABLE_SIGNUPS | No | false | If enabled, no new signups will be allowed and the signup button will be disabled in the UI | +| OAUTH_WELLKNOWN_URL | No | Not set | The "wellknown Url" for openid-configuration as provided by the OAuth provider | +| OAUTH_CLIENT_SECRET | No | Not set | The "Client Secret" as provided by the OAuth provider | +| OAUTH_CLIENT_ID | No | Not set | The "Client ID" as provided by the OAuth provider | +| OAUTH_SCOPE | No | "openid email profile" | "Full list of scopes to request (space delimited)" | +| OAUTH_PROVIDER_NAME | No | "Custom Provider" | The name of your provider. Will be shown on the signup page as "Sign in with ``" | +| OAUTH_ALLOW_DANGEROUS_EMAIL_ACCOUNT_LINKING | No | false | Whether existing accounts in hoarder stored in the database should automatically be linked with your OAuth account. Only enable it if you trust the OAuth provider! | For more information on `OAUTH_ALLOW_DANGEROUS_EMAIL_ACCOUNT_LINKING`, check the [next-auth.js documentation](https://next-auth.js.org/configuration/providers/oauth#allowdangerousemailaccountlinking-option).