From 34dcb87e204037211ca837c533e244f5f3cfc1cb Mon Sep 17 00:00:00 2001 From: Daniel Rivers Date: Thu, 24 Jul 2025 02:32:48 +0100 Subject: [PATCH 1/3] feat: add user org pooling --- .../organization-user-pools/user-pools.mdx | 82 +++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 src/content/docs/authenticate/organization-user-pools/user-pools.mdx diff --git a/src/content/docs/authenticate/organization-user-pools/user-pools.mdx b/src/content/docs/authenticate/organization-user-pools/user-pools.mdx new file mode 100644 index 000000000..28c301040 --- /dev/null +++ b/src/content/docs/authenticate/organization-user-pools/user-pools.mdx @@ -0,0 +1,82 @@ +--- +page_id: 7e2b8c3a-4f1a-4e2a-9c6b-2d8f7a1b5c3d +title: Organization User Pools +sidebar: + order: 3 +relatedArticles: + - 38e9186d-cca5-44a6-86ab-dde9f21167ff + - 318ccfa9-c7f0-40d9-a2ad-814e4e400af7 +app_context: + - m: user + s: orgs + - m: settings + s: environment + - m: organization + s: users +description: Learn how Organization User Pools enable multi-tenant user management by isolating identities within organizations, supporting identity uniqueness, authentication scoping, and secure access control for B2B environments. +metadata: + topics: [authenticate] + sdk: [] + languages: [] + audience: [developer, enterprise-admin, security-engineer] + complexity: advanced + keywords: [organization user pools, multi-tenant, identity isolation, B2B authentication, user management, organization scoping] + updated: 2025-07-24 +featured: false +deprecated: false +ai-summary: > + Comprehensive guide to Organization User Pools - a multi-tenant user management feature that isolates user identities within organizations for secure B2B environments. +--- + +# Organization User Pools + +Organization User Pools is a powerful multi-tenant user management feature that isolates user identities within specific organizations. This feature is essential for B2B applications where you need to maintain separate user pools across different client organizations while allowing the same email addresses or usernames to exist across organizations. + +## What are Organization User Pools? + +Organization User Pools create isolated user identity spaces within your Kinde environment. Each organization maintains its own pool of user identities, preventing cross-organization identity conflicts and ensuring data isolation. + +### Key Benefits + +- **Identity Isolation**: Users from different organizations cannot access each other's accounts +- **Email Reuse**: The same email address can exist across multiple organizations +- **Secure Multi-tenancy**: Complete data and identity separation between organizations +- **Scalable B2B**: Support unlimited organizations with isolated user management +- **Backward Compatibility**: Works with existing authentication flows + +## Use Cases + +### B2B SaaS Applications +- **Multi-tenant platforms** where each client organization has isolated users +- **Enterprise applications** requiring strict data separation +- **Partner portals** with organization-specific access + +### Enterprise Organizations +- **Internal departments** with separate user management +- **Subsidiary companies** requiring isolated user pools +- **Client-specific deployments** with unique user spaces + +### Example Scenario + +Consider a project management SaaS serving multiple companies: + +``` +Company A (org_company_a): +- john.doe@companya.com +- jane.smith@companya.com + +Company B (org_company_b): +- john.doe@companyb.com (same email, different organization, different password) +- mike.wilson@companyb.com +``` + +Without Organization User Pools, the second `john.doe@companyb.com` would conflict with the first. With Organization User Pools enabled, both can coexist safely. + +## How to Enable Organization User Pools + +This is disabled by default. This can be enabled by updating the environment settings when the account has no users. + +1. Visit "Settings > Environment Details" +2. Click the "Enable Organization User Pools" toggle +3. Click "Save" + From 0b891aae11f4995d393df36c1255cc371db5659b Mon Sep 17 00:00:00 2001 From: Daniel Rivers Date: Thu, 24 Jul 2025 02:49:06 +0100 Subject: [PATCH 2/3] chore: move file --- .../user-pools.mdx | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/content/docs/authenticate/{organization-user-pools => manage-authentication}/user-pools.mdx (100%) diff --git a/src/content/docs/authenticate/organization-user-pools/user-pools.mdx b/src/content/docs/authenticate/manage-authentication/user-pools.mdx similarity index 100% rename from src/content/docs/authenticate/organization-user-pools/user-pools.mdx rename to src/content/docs/authenticate/manage-authentication/user-pools.mdx From 57b5e02c6375e98c8f10269ebb3adb69faad27ff Mon Sep 17 00:00:00 2001 From: Daniel Rivers Date: Thu, 24 Jul 2025 02:53:13 +0100 Subject: [PATCH 3/3] chore: remove double header --- .../docs/authenticate/manage-authentication/user-pools.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/content/docs/authenticate/manage-authentication/user-pools.mdx b/src/content/docs/authenticate/manage-authentication/user-pools.mdx index 28c301040..a9774fec1 100644 --- a/src/content/docs/authenticate/manage-authentication/user-pools.mdx +++ b/src/content/docs/authenticate/manage-authentication/user-pools.mdx @@ -28,8 +28,6 @@ ai-summary: > Comprehensive guide to Organization User Pools - a multi-tenant user management feature that isolates user identities within organizations for secure B2B environments. --- -# Organization User Pools - Organization User Pools is a powerful multi-tenant user management feature that isolates user identities within specific organizations. This feature is essential for B2B applications where you need to maintain separate user pools across different client organizations while allowing the same email addresses or usernames to exist across organizations. ## What are Organization User Pools?