High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.
JavaScript campaigncampaign-managementemail-marketingemail-subscriptionlistmonkmailing-listnewsletternewsletter-managementnewsletter-softwareself-hostedsms-gatewaysmtptransactional-emails
Docs update to OIDC - adds Google Workspace / Google Cloud (#2866)
TychoCeltCastcd1bb1bc2045
diff --git a/docs/docs/content/oidc.md b/docs/docs/content/oidc.mdindex 9f68d1af..73f358a8 100644--- a/docs/docs/content/oidc.md+++ b/docs/docs/content/oidc.md@@ -78,3 +78,39 @@ In listmonk Admin → Settings → Security → OIDC:- **Client Secret**: Client Secret copied from Authentik- **Auto-create users from SSO**: (Optional) Enable to automatically create users who don't exist- **Default user role**: (Required if auto-create enabled) Select role for new users++## Google Workspace+Google Workspace (Google Cloud) configuration for listmonk SSO integration.++### 1. Create a new OIDC provider in Google Cloud Console / Google Workspace+In the Google Cloud Console interface, create a new Project.++- **Project Settings**:+ - **Project name**: `Listmonk` (or any preferred name)+- **Branding Settings**:+ - **App name**: `Listmonk` (or any preferred name, this will be visible to the users.)+ - **Authorised domains**: `listmonk.example.com` (or domains that your instance is available on.)++After creating the project, goto **Clients**.++### 2. Create an client in project.+Create a new client and configure it.++- **Application Settings**:+ - **Application type**: `Web application`+ - **Name**: `listmonk` (or any preferred name)+ - **Authorised JavaScript origins**: `https://listmonk.example.com` (or domains that your instance is available on.)+ - **Authorised redirect URIs**: `https://listmonk.example.com/auth/oidc` (or domains that your instance is available on, value is also available in the Settings mentioned above. (Redirect URL for oAuth provider))++Hit save and note the Client ID and Client Secret++### 3. Configure listmonk+In listmonk Admin → Settings → Security → OIDC:++- **Enable OIDC SSO**: Turn on+- **Provider URL**: `https://accounts.google.com` (select Google to Auto-Fill)+- **Provider Name**: Set a name to show on the login form (e.g., `Login with OrgName`)+- **Client ID**: Client ID copied from Console (e.g., `XXXX.apps.googleusercontent.com`)+- **Client Secret**: Client Secret copied from Console+- **Auto-create users from SSO**: (Optional) Enable to automatically create users who don't exist+- **Default user role**: (Required if auto-create enabled) Select role for new users\ No newline at end of file