diff --git a/packages/brochureware/src/pages/Features.tsx b/packages/brochureware/src/pages/Features.tsx
index bce261ec..098f2036 100644
--- a/packages/brochureware/src/pages/Features.tsx
+++ b/packages/brochureware/src/pages/Features.tsx
@@ -37,7 +37,7 @@ const features: Feature[] = [
title: "TOTP MFA (Users & Admins)",
bullets: [
"Setup and verify with backup codes",
- "Per-group and cohort enforcement with rate limits",
+ "Per-organization enforcement with rate limits",
"AMR includes otp; ACR indicates MFA",
],
tags: ["OTP", "TOTP", "MFA"],
@@ -84,7 +84,7 @@ const features: Feature[] = [
icon: Settings,
title: "Admin: Clients, Settings, RBAC",
bullets: [
- "Manage clients, settings, users, groups, permissions",
+ "Manage clients, settings, users, roles, permissions, and organizations",
"JWKS list and rotate",
"OpenAPI served for Admin APIs",
],
@@ -119,10 +119,10 @@ const features: Feature[] = [
},
{
icon: Hash,
- title: "Claims: Permissions and Groups",
+ title: "Claims: Permissions",
bullets: [
- "ID tokens can include permissions and groups",
- "Computed from direct and group‑derived access",
+ "ID tokens can include permissions",
+ "Computed from direct and organization role-derived access",
],
tags: ["Custom Claims"],
},
diff --git a/packages/brochureware/src/pages/docs/api/Admin.tsx b/packages/brochureware/src/pages/docs/api/Admin.tsx
index 6b749d9d..027279fe 100644
--- a/packages/brochureware/src/pages/docs/api/Admin.tsx
+++ b/packages/brochureware/src/pages/docs/api/Admin.tsx
@@ -13,7 +13,6 @@ POST /admin/users
GET /admin/users/{sub}
PATCH /admin/users/{sub}
DELETE /admin/users/{sub}
-PUT /admin/users/{sub}/groups
GET /admin/users/{sub}/permissions`;
const authzOps = `GET /admin/clients
@@ -21,9 +20,7 @@ POST /admin/clients
GET /admin/roles
POST /admin/roles
GET /admin/permissions
-POST /admin/permissions
-GET /admin/groups
-POST /admin/groups`;
+POST /admin/permissions`;
const adminApiPage = () => {
return (
@@ -67,7 +64,7 @@ const adminApiPage = () => {
{userOps}
- Includes admin user CRUD and user-to-group/permission management.
+ Includes admin user CRUD and direct permission management.
@@ -81,7 +78,7 @@ const adminApiPage = () => {
{authzOps}
- Manage clients, roles, permissions, groups, and org structures.
+ Manage clients, roles, permissions, and org structures.
diff --git a/packages/brochureware/src/pages/docs/api/ApiOverview.tsx b/packages/brochureware/src/pages/docs/api/ApiOverview.tsx
index c1fde5e0..70c5f42b 100644
--- a/packages/brochureware/src/pages/docs/api/ApiOverview.tsx
+++ b/packages/brochureware/src/pages/docs/api/ApiOverview.tsx
@@ -47,7 +47,7 @@ const ApiOverviewPage = () => {
- Tenant bootstrapping and identity providers.
- - Full RBAC management: clients, users, roles, permissions, groups, orgs.
+ - Full RBAC management: clients, users, roles, permissions, and orgs.
- Audit trail and settings surfaces.
- Admin-only OTP and security tooling.
diff --git a/packages/brochureware/src/pages/docs/developers/client-apis/UsersApi.tsx b/packages/brochureware/src/pages/docs/developers/client-apis/UsersApi.tsx
index 297c64a4..ae88418a 100644
--- a/packages/brochureware/src/pages/docs/developers/client-apis/UsersApi.tsx
+++ b/packages/brochureware/src/pages/docs/developers/client-apis/UsersApi.tsx
@@ -69,7 +69,6 @@ const managementResponseExample = `{
"email": "target@example.com",
"name": "Directory Target",
"createdAt": "2026-01-24T19:17:27.000Z",
- "groups": ["support", "ops"],
"permissions": ["darkauth.users:read"]
}
]
diff --git a/packages/brochureware/src/pages/docs/guides/OtpPolicy.tsx b/packages/brochureware/src/pages/docs/guides/OtpPolicy.tsx
index 25c24ac3..d6581ef0 100644
--- a/packages/brochureware/src/pages/docs/guides/OtpPolicy.tsx
+++ b/packages/brochureware/src/pages/docs/guides/OtpPolicy.tsx
@@ -23,8 +23,8 @@ const OtpPolicyPage = () => {
- OTP in DarkAuth is implemented as an explicit policy layer. It can be enabled for users, users
- in groups, or role-based scenarios where step-up authentication is required.
+ OTP in DarkAuth is implemented as an explicit policy layer. It can be enabled for users,
+ organizations, or role-based scenarios where step-up authentication is required.
diff --git a/packages/test-suite/tests/admin/groups/groups-default.spec.ts b/packages/test-suite/tests/admin/organizations/default-organization.spec.ts
similarity index 96%
rename from packages/test-suite/tests/admin/groups/groups-default.spec.ts
rename to packages/test-suite/tests/admin/organizations/default-organization.spec.ts
index 6c20ea42..475f0f13 100644
--- a/packages/test-suite/tests/admin/groups/groups-default.spec.ts
+++ b/packages/test-suite/tests/admin/organizations/default-organization.spec.ts
@@ -11,7 +11,7 @@ test.describe('Admin - Organizations Default', () => {
let adminCred = { email: FIXED_TEST_ADMIN.email, password: FIXED_TEST_ADMIN.password };
test.beforeAll(async () => {
- servers = await createTestServers({ testName: 'admin-groups-default' });
+ servers = await createTestServers({ testName: 'admin-organizations-default' });
await installDarkAuth({
adminUrl: servers.adminUrl,
adminEmail: FIXED_TEST_ADMIN.email,
diff --git a/packages/test-suite/tests/admin/users/default-group-assignment.spec.ts b/packages/test-suite/tests/admin/users/default-organization-membership.spec.ts
similarity index 98%
rename from packages/test-suite/tests/admin/users/default-group-assignment.spec.ts
rename to packages/test-suite/tests/admin/users/default-organization-membership.spec.ts
index 48cbd8dd..da154554 100644
--- a/packages/test-suite/tests/admin/users/default-group-assignment.spec.ts
+++ b/packages/test-suite/tests/admin/users/default-organization-membership.spec.ts
@@ -9,7 +9,7 @@ test.describe('Admin - Default organization membership', () => {
let servers: TestServers;
test.beforeAll(async () => {
- servers = await createTestServers({ testName: 'admin-default-group-assignment' });
+ servers = await createTestServers({ testName: 'admin-default-organization-membership' });
await installDarkAuth({
adminUrl: servers.adminUrl,
adminEmail: FIXED_TEST_ADMIN.email,
diff --git a/packages/user-ui/src/pages/Authorize.tsx b/packages/user-ui/src/pages/Authorize.tsx
index 905b4748..e4e98cfd 100644
--- a/packages/user-ui/src/pages/Authorize.tsx
+++ b/packages/user-ui/src/pages/Authorize.tsx
@@ -166,8 +166,6 @@ function getScopeDescription(scope: string): string {
return "Access your basic profile information";
case "email":
return "Access your email address";
- case "groups":
- return "Access your group memberships";
case "permissions":
return "Access your permissions";
default: