feat(xugu): add visual user and privilege management

This commit is contained in:
Elias authored and GitHub committed 2026-09-29 14:13:38 +08:00
1 parent 4949cce746
commit ad221eeb88
14 files changed
+2500 -3

No files matched your search

@@ -0,0 +1,902 @@
<script setup lang="ts">
import { computed, onBeforeUnmount, onMounted, ref, watch } from "vue";
import { useI18n } from "vue-i18n";
import { AlertTriangle, KeyRound, Loader2, Plus, RefreshCw, ShieldCheck, Trash2, Unlock, UserRound, UsersRound } from "@lucide/vue";
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from "@/components/ui/dialog";
import { Input } from "@/components/ui/input";
import { useToast } from "@/composables/useToast";
import { useConnectionStore } from "@/stores/connectionStore";
import type { ConnectionConfig, QueryResult } from "@/types/database";
import * as api from "@/lib/backend/api";
import { executeWithProductionSqlGuard } from "@/lib/database/productionExecutionGuard";
import {
xuguAclAuthorityLabels,
parseXuguAclRows,
parseXuguMemberships,
parseXuguPrincipals,
xuguAclRowsFallbackSql,
xuguAclRowsSql,
xuguAclColumnTargetsSql,
xuguAlterLockSql,
xuguAlterAccountSql,
xuguAlterPasswordSql,
xuguCreatePrincipalSql,
xuguEnrichAclColumnTargets,
xuguDatabaseOptions,
xuguDropPrincipalSql,
xuguFallbackListRolesSql,
xuguFallbackListUsersSql,
xuguGrantSql,
xuguInheritedRoleIds,
xuguListRolesSql,
xuguListUsersSql,
xuguListSchemasSql,
xuguListObjectNamesSql,
xuguListColumnNamesSql,
xuguRevokeSql,
xuguRoleMembershipsFallbackSql,
xuguRoleMembershipsSql,
xuguPrivilegesForScope,
xuguPrincipalIsProtected,
XUGU_OBJECT_TYPES,
type XuguAclRow,
type XuguAdminAuthority,
type XuguPrincipal,
type XuguPrivilegeScope,
} from "@/lib/database/xuguUserPermissions";
const props = defineProps<{ connection: ConnectionConfig }>();
const { t } = useI18n();
const { toast } = useToast();
const connectionStore = useConnectionStore();
const users = ref<XuguPrincipal[]>([]);
const roles = ref<XuguPrincipal[]>([]);
const databaseNames = ref<string[]>([]);
const selectedDatabase = ref(props.connection.database?.trim() ?? "");
const databaseListLimited = ref(false);
const databaseContextUnknown = ref(false);
const schemas = ref<string[]>([]);
const objectNames = ref<string[]>([]);
const columnNames = ref<string[]>([]);
const targetLookupIncomplete = ref(false);
const targetLookupFailed = ref(false);
const memberships = ref<Array<{ userId: string; roleId: string }>>([]);
const aclRows = ref<XuguAclRow[]>([]);
const kind = ref<"user" | "role">("user");
const selectedId = ref("");
const search = ref("");
const loading = ref(false);
const loadingAcl = ref(false);
const mutating = ref(false);
const loadError = ref("");
const aclError = ref("");
const dbaCatalogAvailable = ref(false);
const aclCatalogAvailable = ref(false);
const roleMembershipsAvailable = ref(false);
const currentDatabaseIsSystem = ref(false);
const createDialogOpen = ref(false);
const passwordDialogOpen = ref(false);
const accountDialogOpen = ref(false);
const principalName = ref("");
const principalPassword = ref("");
const defaultRoleNames = ref<string[]>([]);
const createValidUntil = ref("");
const createLocked = ref(false);
const createPasswordExpired = ref(false);
const passwordToSet = ref("");
const validUntilToSet = ref("");
const expirePassword = ref(false);
const grantScope = ref<XuguPrivilegeScope>("database");
const objectType = ref("TABLE");
const schemaName = ref("");
const objectName = ref("");
const columnName = ref("");
const roleName = ref("");
const adminAuthority = ref<XuguAdminAuthority>("DBA");
const selectedPrivileges = ref<string[]>([]);
const grantOption = ref(false);
const revokeGrantOptionOnly = ref(false);
const pendingSql = ref("");
const pendingLabel = ref("");
const pendingSystemWide = ref(false);
const sqlDialogOpen = ref(false);
let targetLookupTimer: ReturnType<typeof setTimeout> | undefined;
let targetLookupRequestId = 0;
let permissionsRequestId = 0;
let principalsRequestId = 0;
let databaseContextReady = false;
let pauseDatabaseWatcher = false;
const principals = computed(() => (kind.value === "user" ? users.value : roles.value));
const selectedPrincipal = computed(() => principals.value.find((principal) => principal.id === selectedId.value));
const selectedPrincipalProtected = computed(() => (selectedPrincipal.value ? xuguPrincipalIsProtected(selectedPrincipal.value) : true));
const visiblePrincipals = computed(() => {
const query = search.value.trim().toLocaleLowerCase();
return query ? principals.value.filter((principal) => principal.name.toLocaleLowerCase().includes(query)) : principals.value;
});
const canMutate = computed(() => !props.connection.read_only && !!selectedDatabase.value && dbaCatalogAvailable.value && aclCatalogAvailable.value && roleMembershipsAvailable.value);
const availablePrivileges = computed(() => xuguPrivilegesForScope(grantScope.value, objectType.value, currentDatabaseIsSystem.value));
const selectedPrivilegeSet = computed(() => new Set(selectedPrivileges.value));
const rolePrincipalMap = computed(() => new Map([...users.value, ...roles.value].map((principal) => [principal.id, principal])));
const inheritedRoleIds = computed(() => (selectedPrincipal.value ? xuguInheritedRoleIds(selectedPrincipal.value.id, memberships.value) : []));
const effectiveRoleNames = computed(() => inheritedRoleIds.value.map((id) => rolePrincipalMap.value.get(id)?.name ?? `#${id}`));
const permissionRows = computed(() =>
aclRows.value.flatMap((row) => {
const names = xuguAclAuthorityLabels(row.authority, row.objectType, row.scope, t("xuguUserPermissions.unmappedAuthority"));
return names.map((name) => ({ ...row, name }));
}),
);
const previewSql = computed(() => pendingSql.value.replace(/(IDENTIFIED BY\s+)('(?:''|[^'])*')/i, "$1'••••••'"));
const scopeOptions = computed(() => {
const options: Array<{ value: XuguPrivilegeScope; label: string }> = [
{ value: "database", label: "xuguUserPermissions.scopeDatabase" },
{ value: "schema", label: "xuguUserPermissions.scopeSchema" },
{ value: "object", label: "xuguUserPermissions.scopeObject" },
{ value: "column", label: "xuguUserPermissions.scopeColumn" },
{ value: "role", label: "xuguUserPermissions.scopeRole" },
{ value: "admin", label: "xuguUserPermissions.scopeAdmin" },
];
if (currentDatabaseIsSystem.value) options.unshift({ value: "system", label: "xuguUserPermissions.scopeSystem" });
return options;
});
function resultError(result: QueryResult): Error | undefined {
if (!result.execution_error) return undefined;
return new Error(String(result.rows[0]?.[0] ?? "Query failed"));
}
function requireColumns(result: QueryResult, required: string[], catalogName: string) {
const columns = new Set(result.columns.map((column) => column.toLowerCase()));
const missing = required.filter((column) => !columns.has(column.toLowerCase()));
if (missing.length) throw new Error(`${catalogName} returned an unexpected shape (missing ${missing.join(", ")}).`);
}
async function query(sql: string, maxRows = 5000): Promise<QueryResult> {
const result = await api.executeQuery(props.connection.id, selectedDatabase.value, sql, undefined, undefined, { maxRows });
const error = resultError(result);
if (error) throw error;
return result;
}
async function queryEither(primary: string, fallback: string): Promise<{ result: QueryResult; privileged: boolean }> {
try {
return { result: await query(primary), privileged: true };
} catch (primaryError) {
try {
return { result: await query(fallback), privileged: false };
} catch {
throw primaryError;
}
}
}
async function ensureConnection() {
await connectionStore.ensureConnected(props.connection.id);
}
async function loadDatabaseContext() {
await ensureConnection();
let currentDatabase = selectedDatabase.value.trim() || props.connection.database?.trim() || "";
let names: string[] = [];
databaseListLimited.value = false;
try {
names = (await api.listDatabases(props.connection.id)).map((database) => database.name);
} catch {
databaseListLimited.value = true;
}
if (!currentDatabase) {
try {
const result = await api.executeQuery(props.connection.id, "", "SELECT DATABASE() AS DATABASE_NAME;");
const error = resultError(result);
if (error) throw error;
const index = result.columns.findIndex((column) => column.toLowerCase() === "database_name");
currentDatabase = index < 0 ? "" : String(result.rows[0]?.[index] ?? "").trim();
} catch {
// Keep the database unknown and disable mutations rather than guess which
// database-scoped user catalog an empty connection context will address.
}
}
const options = xuguDatabaseOptions(names, currentDatabase);
pauseDatabaseWatcher = true;
databaseNames.value = options;
selectedDatabase.value = currentDatabase;
databaseContextUnknown.value = !currentDatabase;
pauseDatabaseWatcher = false;
databaseContextReady = true;
}
async function loadPrincipals() {
const requestId = ++principalsRequestId;
loading.value = true;
loadError.value = "";
dbaCatalogAvailable.value = false;
aclCatalogAvailable.value = false;
roleMembershipsAvailable.value = false;
try {
await ensureConnection();
if (!databaseContextReady) await loadDatabaseContext();
if (requestId !== principalsRequestId) return;
currentDatabaseIsSystem.value = false;
try {
const databaseResult = await query("SELECT DATABASE() AS DATABASE_NAME;");
const databaseIndex = databaseResult.columns.findIndex((column) => column.toLowerCase() === "database_name");
currentDatabaseIsSystem.value =
databaseIndex >= 0 &&
String(databaseResult.rows[0]?.[databaseIndex] ?? "")
.trim()
.toUpperCase() === "SYSTEM";
} catch {
// Fail closed: system-wide database lifecycle grants stay unavailable
// when the current database cannot be identified.
}
if (!currentDatabaseIsSystem.value && grantScope.value === "system") grantScope.value = "database";
const [userResult, roleResult] = await Promise.all([queryEither(xuguListUsersSql(), xuguFallbackListUsersSql()), queryEither(xuguListRolesSql(), xuguFallbackListRolesSql())]);
if (requestId !== principalsRequestId) return;
requireColumns(userResult.result, ["USER_ID", "USER_NAME"], "User catalog");
requireColumns(roleResult.result, ["USER_ID", "USER_NAME"], "Role catalog");
users.value = parseXuguPrincipals(userResult.result, false);
roles.value = parseXuguPrincipals(roleResult.result, true);
dbaCatalogAvailable.value = userResult.privileged && roleResult.privileged;
try {
const schemaResult = await query(xuguListSchemasSql(dbaCatalogAvailable.value));
requireColumns(schemaResult, ["SCHEMA_NAME"], "Schema catalog");
const schemaIndex = schemaResult.columns.findIndex((column) => column.toLowerCase() === "schema_name");
schemas.value = schemaIndex < 0 ? [] : schemaResult.rows.map((row) => String(row[schemaIndex] ?? "")).filter(Boolean);
} catch {
schemas.value = [];
}
roleMembershipsAvailable.value = false;
try {
const result = await query(xuguRoleMembershipsSql());
requireColumns(result, ["USER_ID", "ROLE_ID"], "Role membership catalog");
memberships.value = parseXuguMemberships(result);
roleMembershipsAvailable.value = true;
} catch {
try {
const result = await query(xuguRoleMembershipsFallbackSql());
requireColumns(result, ["USER_ID", "ROLE_ID"], "Role membership catalog");
memberships.value = parseXuguMemberships(result);
roleMembershipsAvailable.value = false;
} catch {
memberships.value = [];
roleMembershipsAvailable.value = false;
}
}
const nextList = kind.value === "user" ? users.value : roles.value;
const nextSelectedId = nextList.some((principal) => principal.id === selectedId.value) ? selectedId.value : (nextList[0]?.id ?? "");
if (nextSelectedId === selectedId.value) {
if (selectedId.value) await loadPermissions();
} else {
selectedId.value = nextSelectedId;
}
} catch (error: any) {
users.value = [];
roles.value = [];
memberships.value = [];
aclRows.value = [];
loadError.value = error?.message || String(error);
} finally {
if (requestId === principalsRequestId) loading.value = false;
}
}
async function refreshPermissions() {
if (loading.value || mutating.value) return;
loading.value = true;
try {
await loadDatabaseContext();
await loadPrincipals();
} catch (error: any) {
loadError.value = error?.message || String(error);
} finally {
loading.value = false;
}
}
async function loadPermissions() {
const requestId = ++permissionsRequestId;
const principal = selectedPrincipal.value;
if (!principal) {
aclRows.value = [];
aclCatalogAvailable.value = false;
loadingAcl.value = false;
aclError.value = "";
return;
}
loadingAcl.value = true;
aclCatalogAvailable.value = false;
aclError.value = "";
try {
const ids = [principal.id, ...xuguInheritedRoleIds(principal.id, memberships.value)];
let useDbaCatalog = true;
try {
const result = await query(xuguAclRowsSql(ids));
if (requestId !== permissionsRequestId) return;
requireColumns(result, ["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "TARGET_NAME"], "ACL catalog");
aclRows.value = parseXuguAclRows(result, [...users.value, ...roles.value], principal.id, currentDatabaseIsSystem.value);
aclCatalogAvailable.value = true;
} catch (primaryError: any) {
try {
useDbaCatalog = false;
const result = await query(xuguAclRowsFallbackSql(ids));
if (requestId !== permissionsRequestId) return;
requireColumns(result, ["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "TARGET_NAME"], "ACL catalog");
aclRows.value = parseXuguAclRows(result, [...users.value, ...roles.value], principal.id, currentDatabaseIsSystem.value);
aclCatalogAvailable.value = false;
} catch {
if (requestId !== permissionsRequestId) return;
throw primaryError;
}
}
if (aclRows.value.some((row) => row.scope === "column")) {
try {
const result = await query(xuguAclColumnTargetsSql(ids, useDbaCatalog));
if (requestId !== permissionsRequestId) return;
requireColumns(result, ["GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "TARGET_NAME"], "Column ACL target catalog");
aclRows.value = xuguEnrichAclColumnTargets(aclRows.value, result);
} catch {
// Keep the base ACL rows visible with their explicit object-ID fallback
// when a server version or restricted catalog cannot resolve columns.
}
}
} catch (error: any) {
if (requestId !== permissionsRequestId) return;
aclRows.value = [];
aclError.value = error?.message || String(error);
} finally {
if (requestId === permissionsRequestId) loadingAcl.value = false;
}
}
async function loadTargetOptions(requestId: number) {
objectNames.value = [];
columnNames.value = [];
targetLookupIncomplete.value = false;
targetLookupFailed.value = false;
if (!schemaName.value.trim()) return;
try {
if (grantScope.value === "object") {
const result = await query(xuguListObjectNamesSql(schemaName.value, objectType.value, dbaCatalogAvailable.value), 1000);
if (requestId !== targetLookupRequestId) return;
const nameIndex = result.columns.findIndex((column) => column.toLowerCase() === "obj_name");
objectNames.value = nameIndex < 0 ? [] : result.rows.map((row) => String(row[nameIndex] ?? "")).filter(Boolean);
targetLookupIncomplete.value = result.truncated === true || result.rows.length >= 1000;
} else if (grantScope.value === "column" && objectName.value.trim() && ["TABLE", "VIEW"].includes(objectType.value)) {
const result = await query(xuguListColumnNamesSql(schemaName.value, objectName.value, objectType.value, dbaCatalogAvailable.value), 1000);
if (requestId !== targetLookupRequestId) return;
const nameIndex = result.columns.findIndex((column) => column.toLowerCase() === "col_name");
columnNames.value = nameIndex < 0 ? [] : result.rows.map((row) => String(row[nameIndex] ?? "")).filter(Boolean);
targetLookupIncomplete.value = result.truncated === true || result.rows.length >= 1000;
}
} catch {
if (requestId === targetLookupRequestId) targetLookupFailed.value = true;
}
}
function scheduleTargetLookup() {
const requestId = ++targetLookupRequestId;
if (targetLookupTimer) clearTimeout(targetLookupTimer);
objectNames.value = [];
columnNames.value = [];
targetLookupIncomplete.value = false;
targetLookupFailed.value = false;
targetLookupTimer = setTimeout(() => void loadTargetOptions(requestId), 250);
}
function selectKind(nextKind: "user" | "role") {
const previousId = selectedId.value;
kind.value = nextKind;
selectedId.value = (nextKind === "user" ? users.value : roles.value)[0]?.id ?? "";
if (selectedId.value && selectedId.value === previousId) {
aclCatalogAvailable.value = false;
void loadPermissions();
}
}
function togglePrivilege(privilege: string) {
if (grantScope.value === "column") {
selectedPrivileges.value = selectedPrivilegeSet.value.has(privilege) ? [] : [privilege];
return;
}
if (grantScope.value === "object" && privilege === "ALL PRIVILEGES") {
selectedPrivileges.value = selectedPrivilegeSet.value.has(privilege) ? [] : [privilege];
return;
}
const next = new Set(selectedPrivileges.value);
if (grantScope.value === "object") next.delete("ALL PRIVILEGES");
if (next.has(privilege)) next.delete(privilege);
else next.add(privilege);
selectedPrivileges.value = [...next];
}
function preview(sql: string, label: string, systemWide = false) {
pendingSql.value = sql;
pendingLabel.value = label;
pendingSystemWide.value = systemWide;
sqlDialogOpen.value = true;
}
function buildPermissionSql(revoke: boolean): string {
const principal = selectedPrincipal.value;
if (!principal) throw new Error("Select a user or role first.");
const input = {
principal,
scope: grantScope.value,
privileges: selectedPrivileges.value,
schema: schemaName.value,
objectType: objectType.value,
object: objectName.value,
column: columnName.value,
role: roleName.value,
adminAuthority: adminAuthority.value,
grantOption: grantOption.value,
revokeGrantOptionOnly: revokeGrantOptionOnly.value,
systemDatabase: currentDatabaseIsSystem.value,
};
return revoke ? xuguRevokeSql(input) : xuguGrantSql(input);
}
function previewPermission(revoke: boolean) {
if (!canMutate.value || selectedPrincipalProtected.value) return;
try {
preview(buildPermissionSql(revoke), revoke ? t("xuguUserPermissions.revoke") : t("xuguUserPermissions.grant"), grantScope.value === "system");
} catch (error: any) {
toast(error?.message || String(error), 5000);
}
}
function createPrincipal(): boolean {
try {
const isRole = kind.value === "role";
const sql = xuguCreatePrincipalSql(principalName.value, isRole, principalPassword.value, {
defaultRoles: defaultRoleNames.value,
validUntil: createValidUntil.value,
locked: createLocked.value,
passwordExpired: createPasswordExpired.value,
});
preview(sql, t(isRole ? "xuguUserPermissions.createRole" : "xuguUserPermissions.createUser"));
principalPassword.value = "";
return true;
} catch (error: any) {
toast(error?.message || String(error), 5000);
return false;
}
}
function changePassword(): boolean {
const principal = selectedPrincipal.value;
if (!principal) return false;
try {
preview(xuguAlterPasswordSql(principal, passwordToSet.value), t("xuguUserPermissions.changePassword"));
passwordToSet.value = "";
return true;
} catch (error: any) {
toast(error?.message || String(error), 5000);
return false;
}
}
function previewNewPrincipal() {
if (createPrincipal()) createDialogOpen.value = false;
}
function previewPasswordChange() {
if (changePassword()) passwordDialogOpen.value = false;
}
function previewAccountChanges(): boolean {
const principal = selectedPrincipal.value;
if (!principal) return false;
try {
preview(xuguAlterAccountSql(principal, { validUntil: validUntilToSet.value, passwordExpired: expirePassword.value }), t("xuguUserPermissions.accountSettings"));
accountDialogOpen.value = false;
return true;
} catch (error: any) {
toast(error?.message || String(error), 5000);
return false;
}
}
function openAccountSettings() {
validUntilToSet.value = "";
expirePassword.value = false;
accountDialogOpen.value = true;
}
async function applyPendingSql() {
if (!pendingSql.value || !canMutate.value) return;
mutating.value = true;
try {
const result = await executeWithProductionSqlGuard({
connection: props.connection,
database: selectedDatabase.value,
sql: pendingSql.value,
source: t("production.sourceAdmin"),
execute: async () => {
const results = await api.executeMulti(props.connection.id, selectedDatabase.value, pendingSql.value, undefined, undefined, { maxRows: 1000 });
const failed = results.find((item) => item.execution_error === true);
if (failed) throw new Error(String(failed.rows[0]?.[0] ?? t("xuguUserPermissions.operationFailed")));
return true;
},
});
if (!result) return;
sqlDialogOpen.value = false;
principalName.value = "";
principalPassword.value = "";
defaultRoleNames.value = [];
createValidUntil.value = "";
createLocked.value = false;
createPasswordExpired.value = false;
passwordToSet.value = "";
validUntilToSet.value = "";
expirePassword.value = false;
toast(t("xuguUserPermissions.operationSuccess"), 2500);
await loadPrincipals();
} catch (error: any) {
toast(t("xuguUserPermissions.operationFailedWithMessage", { message: error?.message || String(error) }), 6000);
} finally {
mutating.value = false;
}
}
function lockPrincipal(locked: boolean) {
const principal = selectedPrincipal.value;
if (!principal) return;
try {
preview(xuguAlterLockSql(principal, locked), t(locked ? "xuguUserPermissions.lock" : "xuguUserPermissions.unlock"));
} catch (error: any) {
toast(error?.message || String(error), 5000);
}
}
function dropPrincipal() {
const principal = selectedPrincipal.value;
if (!principal) return;
try {
preview(xuguDropPrincipalSql(principal), t(principal.isRole ? "xuguUserPermissions.dropRole" : "xuguUserPermissions.dropUser"));
} catch (error: any) {
toast(error?.message || String(error), 5000);
}
}
watch(selectedId, () => {
aclCatalogAvailable.value = false;
void loadPermissions();
});
watch(
selectedDatabase,
(database, previousDatabase) => {
if (!databaseContextReady || pauseDatabaseWatcher || database === previousDatabase) return;
databaseContextUnknown.value = !database;
users.value = [];
roles.value = [];
memberships.value = [];
aclRows.value = [];
selectedId.value = "";
currentDatabaseIsSystem.value = false;
void loadPrincipals();
},
{ flush: "sync" },
);
watch(sqlDialogOpen, (open) => {
if (!open) {
pendingSql.value = "";
pendingLabel.value = "";
pendingSystemWide.value = false;
principalPassword.value = "";
passwordToSet.value = "";
}
});
watch(grantScope, () => {
selectedPrivileges.value = [];
grantOption.value = false;
revokeGrantOptionOnly.value = false;
});
watch(objectType, () => {
selectedPrivileges.value = [];
});
watch([grantScope, schemaName, objectType, objectName], scheduleTargetLookup);
onMounted(() => void loadPrincipals());
onBeforeUnmount(() => {
targetLookupRequestId += 1;
if (targetLookupTimer) clearTimeout(targetLookupTimer);
});
</script>
<template>
<div class="flex h-full min-h-0 flex-col gap-3 p-4">
<header class="flex flex-wrap items-center justify-between gap-3">
<div class="flex items-center gap-2">
<ShieldCheck class="size-5 text-primary" />
<h1 class="text-lg font-semibold">{{ t("xuguUserPermissions.title") }}</h1>
<Badge variant="outline">XuguDB</Badge>
</div>
<div class="flex items-center gap-2">
<Badge v-if="connection.read_only" variant="secondary">{{ t("xuguUserPermissions.readOnly") }}</Badge>
<label v-if="databaseNames.length" class="flex items-center gap-2 text-xs text-muted-foreground">
{{ t("xuguUserPermissions.databaseContext") }}
<select v-model="selectedDatabase" class="h-8 max-w-56 rounded-md border bg-background px-2 text-sm text-foreground" :disabled="loading || mutating || sqlDialogOpen">
<option v-if="databaseContextUnknown" value="" disabled>{{ t("xuguUserPermissions.chooseDatabase") }}</option>
<option v-for="database in databaseNames" :key="database" :value="database">{{ database }}</option>
</select>
</label>
<Button variant="outline" size="sm" :disabled="loading || mutating" @click="refreshPermissions">
<Loader2 v-if="loading" class="mr-2 size-4 animate-spin" />
<RefreshCw v-else class="mr-2 size-4" />{{ t("xuguUserPermissions.refresh") }}
</Button>
<Button
size="sm"
:disabled="!canMutate"
@click="
principalName = '';
principalPassword = '';
defaultRoleNames = [];
createValidUntil = '';
createLocked = false;
createPasswordExpired = false;
sqlDialogOpen = false;
createDialogOpen = true;
"
>
<Plus class="mr-2 size-4" />{{ t("xuguUserPermissions.newPrincipal") }}
</Button>
</div>
</header>
<div v-if="loadError" class="rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive">{{ loadError }}</div>
<div v-else-if="databaseContextUnknown" class="rounded-md border border-amber-500/40 bg-amber-500/5 p-3 text-sm text-amber-800 dark:text-amber-200">{{ t("xuguUserPermissions.databaseContextUnknown") }}</div>
<div v-else-if="databaseListLimited" class="rounded-md border border-amber-500/40 bg-amber-500/5 p-3 text-sm text-amber-800 dark:text-amber-200">{{ t("xuguUserPermissions.databaseListLimited") }}</div>
<div v-else-if="!dbaCatalogAvailable" class="flex items-start gap-2 rounded-md border border-amber-500/40 bg-amber-500/5 p-3 text-sm">
<AlertTriangle class="mt-0.5 size-4 shrink-0 text-amber-600" />
<span>{{ t("xuguUserPermissions.limitedCatalog") }}</span>
</div>
<div class="grid min-h-0 flex-1 grid-cols-[minmax(15rem,22rem)_minmax(0,1fr)] gap-3">
<aside class="flex min-h-0 flex-col overflow-hidden rounded-lg border bg-card">
<div class="flex gap-1 border-b p-2">
<Button class="flex-1" size="sm" :variant="kind === 'user' ? 'secondary' : 'ghost'" @click="selectKind('user')"
><UserRound class="mr-2 size-4" />{{ t("xuguUserPermissions.users") }} <span class="ml-1 text-muted-foreground">{{ users.length }}</span></Button
>
<Button class="flex-1" size="sm" :variant="kind === 'role' ? 'secondary' : 'ghost'" @click="selectKind('role')"
><UsersRound class="mr-2 size-4" />{{ t("xuguUserPermissions.roles") }} <span class="ml-1 text-muted-foreground">{{ roles.length }}</span></Button
>
</div>
<div class="border-b p-2"><Input v-model="search" :placeholder="t('xuguUserPermissions.search')" /></div>
<div class="min-h-0 flex-1 overflow-auto p-1">
<button v-for="principal in visiblePrincipals" :key="principal.id" class="flex w-full items-center justify-between rounded-md px-3 py-2 text-left text-sm hover:bg-muted" :class="selectedId === principal.id ? 'bg-muted font-medium' : ''" @click="selectedId = principal.id">
<span class="flex min-w-0 items-center gap-2"
><UserRound v-if="!principal.isRole" class="size-4 shrink-0 text-muted-foreground" /><UsersRound v-else class="size-4 shrink-0 text-muted-foreground" /><span class="truncate">{{ principal.name }}</span></span
>
<span class="flex gap-1"
><Badge v-if="principal.isSystem" variant="outline" class="px-1.5 py-0 text-[10px]">{{ t("xuguUserPermissions.system") }}</Badge
><Badge v-else-if="!principal.isRole && principal.locked" variant="destructive" class="px-1.5 py-0 text-[10px]">{{ t("xuguUserPermissions.locked") }}</Badge></span
>
</button>
<div v-if="!loading && visiblePrincipals.length === 0" class="p-4 text-sm text-muted-foreground">{{ t("xuguUserPermissions.empty") }}</div>
</div>
</aside>
<main class="flex min-h-0 flex-col gap-3 overflow-auto">
<section v-if="selectedPrincipal" class="rounded-lg border bg-card p-4">
<div class="flex flex-wrap items-start justify-between gap-3">
<div class="min-w-0">
<div class="flex flex-wrap items-center gap-2">
<h2 class="text-base font-semibold">{{ selectedPrincipal.name }}</h2>
<Badge variant="outline">{{ selectedPrincipal.isRole ? t("xuguUserPermissions.role") : t("xuguUserPermissions.user") }}</Badge
><Badge v-if="selectedPrincipal.isSystem" variant="secondary">{{ t("xuguUserPermissions.systemPrincipal") }}</Badge
><Badge v-else-if="!selectedPrincipal.isRole" :variant="selectedPrincipal.locked ? 'destructive' : 'outline'">{{ selectedPrincipal.locked ? t("xuguUserPermissions.locked") : t("xuguUserPermissions.active") }}</Badge
><Badge v-if="selectedPrincipal.expired" variant="destructive">{{ t("xuguUserPermissions.expired") }}</Badge>
</div>
<p v-if="selectedPrincipal.validUntil" class="mt-1 text-xs text-muted-foreground">{{ t("xuguUserPermissions.validUntil", { value: selectedPrincipal.validUntil }) }}</p>
<p v-if="effectiveRoleNames.length" class="mt-2 text-xs text-muted-foreground">{{ t("xuguUserPermissions.inheritedRoles", { roles: effectiveRoleNames.join(", ") }) }}</p>
</div>
<div class="flex flex-wrap gap-2">
<Button
v-if="!selectedPrincipal.isRole"
size="sm"
variant="outline"
:disabled="!canMutate || selectedPrincipalProtected"
@click="
passwordToSet = '';
passwordDialogOpen = true;
"
><KeyRound class="mr-1.5 size-4" />{{ t("xuguUserPermissions.changePassword") }}</Button
>
<Button v-if="!selectedPrincipal.isRole" size="sm" variant="outline" :disabled="!canMutate || selectedPrincipalProtected" @click="openAccountSettings">{{ t("xuguUserPermissions.accountSettings") }}</Button>
<Button v-if="!selectedPrincipal.isRole" size="sm" variant="outline" :disabled="!canMutate || selectedPrincipalProtected" @click="lockPrincipal(!selectedPrincipal.locked)"
><Unlock class="mr-1.5 size-4" />{{ selectedPrincipal.locked ? t("xuguUserPermissions.unlock") : t("xuguUserPermissions.lock") }}</Button
>
<Button size="sm" variant="destructive" :disabled="!canMutate || selectedPrincipalProtected" @click="dropPrincipal"><Trash2 class="mr-1.5 size-4" />{{ t(selectedPrincipal.isRole ? "xuguUserPermissions.dropRole" : "xuguUserPermissions.dropUser") }}</Button>
</div>
</div>
<p v-if="!canMutate" class="mt-3 text-xs text-muted-foreground">{{ connection.read_only ? t("xuguUserPermissions.readOnlyHint") : t("xuguUserPermissions.managementRequiresDba") }}</p>
</section>
<section class="rounded-lg border bg-card">
<div class="flex items-center justify-between border-b px-4 py-3">
<div>
<h2 class="font-medium">{{ t("xuguUserPermissions.grantsTitle") }}</h2>
<p class="mt-0.5 text-xs text-muted-foreground">{{ t("xuguUserPermissions.grantsHint") }}</p>
</div>
<Badge variant="outline">{{ permissionRows.length }}</Badge>
</div>
<div v-if="aclError" class="p-4 text-sm text-destructive">{{ aclError }}</div>
<div v-else-if="loadingAcl" class="flex items-center gap-2 p-4 text-sm text-muted-foreground"><Loader2 class="size-4 animate-spin" />{{ t("xuguUserPermissions.loading") }}</div>
<div v-else-if="!aclCatalogAvailable" class="border-b px-4 py-2 text-xs text-amber-700 dark:text-amber-300">{{ t("xuguUserPermissions.limitedAcl") }}</div>
<div v-else-if="permissionRows.length === 0" class="p-4 text-sm text-muted-foreground">{{ t("xuguUserPermissions.noGrants") }}</div>
<div v-else class="max-h-72 overflow-auto">
<table class="w-full text-left text-sm">
<thead class="sticky top-0 bg-muted/80 text-xs text-muted-foreground">
<tr>
<th class="px-4 py-2">{{ t("xuguUserPermissions.privilege") }}</th>
<th class="px-4 py-2">{{ t("xuguUserPermissions.scope") }}</th>
<th class="px-4 py-2">{{ t("xuguUserPermissions.target") }}</th>
<th class="px-4 py-2">{{ t("xuguUserPermissions.source") }}</th>
<th class="px-4 py-2">{{ t("xuguUserPermissions.grantable") }}</th>
</tr>
</thead>
<tbody>
<tr v-for="(row, index) in permissionRows" :key="`${row.granteeId}:${row.objectId}:${row.objectType}:${row.name}:${index}`" class="border-t">
<td class="px-4 py-2 font-medium">{{ row.name }}</td>
<td class="px-4 py-2 text-muted-foreground">{{ t(`xuguUserPermissions.scope${row.scope.charAt(0).toUpperCase()}${row.scope.slice(1)}`) }}</td>
<td class="px-4 py-2 font-mono text-xs">{{ row.target }}</td>
<td class="px-4 py-2">{{ row.inheritedFrom ? t("xuguUserPermissions.viaRole", { role: row.inheritedFrom }) : t("xuguUserPermissions.direct") }}</td>
<td class="px-4 py-2">{{ row.regrant ? t("xuguUserPermissions.yes") : t("xuguUserPermissions.no") }}</td>
</tr>
</tbody>
</table>
</div>
</section>
<section class="rounded-lg border bg-card p-4">
<div class="mb-3">
<h2 class="font-medium">{{ t("xuguUserPermissions.editorTitle") }}</h2>
<p class="mt-0.5 text-xs text-muted-foreground">{{ t("xuguUserPermissions.editorHint") }}</p>
</div>
<div class="grid gap-3 sm:grid-cols-2 xl:grid-cols-3">
<label class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.scope")
}}<select v-model="grantScope" class="h-9 w-full rounded-md border bg-background px-2 text-sm text-foreground">
<option v-for="option in scopeOptions" :key="option.value" :value="option.value">{{ t(option.label) }}</option>
</select></label
>
<label v-if="grantScope === 'schema' || grantScope === 'object' || grantScope === 'column'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.schema") }}<Input v-model="schemaName" list="xugu-permission-schemas" /><datalist id="xugu-permission-schemas"><option v-for="schema in schemas" :key="schema" :value="schema" /></datalist
></label>
<label v-if="grantScope === 'object' || grantScope === 'column'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.objectType")
}}<select v-model="objectType" class="h-9 w-full rounded-md border bg-background px-2 text-sm text-foreground">
<template v-if="grantScope === 'column'"
><option value="TABLE">{{ t("xuguUserPermissions.tableColumn") }}</option>
<option value="VIEW">{{ t("xuguUserPermissions.viewColumn") }}</option></template
><template v-else
><option v-for="item in XUGU_OBJECT_TYPES" :key="item.sql" :value="item.sql">{{ item.label }}</option></template
>
</select></label
>
<label v-if="grantScope === 'object' || grantScope === 'column'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.object") }}<Input v-model="objectName" list="xugu-permission-objects" /><datalist id="xugu-permission-objects"><option v-for="name in objectNames" :key="name" :value="name" /></datalist
></label>
<label v-if="grantScope === 'column'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.column") }}<Input v-model="columnName" list="xugu-permission-columns" /><datalist id="xugu-permission-columns"><option v-for="name in columnNames" :key="name" :value="name" /></datalist
></label>
<label v-if="grantScope === 'role'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.roleToGrant") }}<Input v-model="roleName" list="xugu-permission-roles" /><datalist id="xugu-permission-roles"><option v-for="role in roles" :key="role.id" :value="role.name" /></datalist
></label>
<label v-if="grantScope === 'admin'" class="space-y-1 text-xs text-muted-foreground"
>{{ t("xuguUserPermissions.adminAuthority")
}}<select v-model="adminAuthority" class="h-9 w-full rounded-md border bg-background px-2 text-sm text-foreground">
<option value="DBA">DBA</option>
<option value="AUDITOR">AUDITOR</option>
<option value="SSO">SSO</option>
</select></label
>
</div>
<p v-if="targetLookupFailed" class="mt-2 text-xs text-muted-foreground">{{ t("xuguUserPermissions.targetLookupFailed") }}</p>
<p v-else-if="targetLookupIncomplete" class="mt-2 text-xs text-muted-foreground">{{ t("xuguUserPermissions.targetLookupIncomplete") }}</p>
<p v-if="grantScope === 'system'" class="mt-2 text-xs text-muted-foreground">{{ t("xuguUserPermissions.systemScopeHint") }}</p>
<div v-if="availablePrivileges.length" class="mt-3 grid gap-2 sm:grid-cols-2 xl:grid-cols-3">
<label v-for="privilege in availablePrivileges" :key="privilege.name" class="flex items-center gap-2 rounded-md border px-3 py-2 text-sm"><input type="checkbox" :checked="selectedPrivilegeSet.has(privilege.name)" @change="togglePrivilege(privilege.name)" />{{ privilege.name }}</label>
</div>
<div class="mt-3 flex flex-wrap items-center justify-between gap-3">
<div v-if="grantScope === 'object'" class="flex flex-wrap gap-4">
<label class="flex items-center gap-2 text-sm"><input v-model="grantOption" type="checkbox" />{{ t("xuguUserPermissions.grantOption") }}</label>
<label class="flex items-center gap-2 text-sm"><input v-model="revokeGrantOptionOnly" type="checkbox" />{{ t("xuguUserPermissions.revokeGrantOptionOnly") }}</label>
</div>
<div v-else-if="grantScope === 'column'" class="text-xs text-muted-foreground">
{{ t("xuguUserPermissions.columnGrantOptionUnsupported") }}
</div>
<span v-else class="text-xs text-muted-foreground">{{ t("xuguUserPermissions.grantOptionScope") }}</span>
<div class="ml-auto flex gap-2">
<Button variant="outline" :disabled="!canMutate || !selectedPrincipal || selectedPrincipalProtected" @click="previewPermission(true)">{{ t("xuguUserPermissions.revoke") }}</Button
><Button :disabled="!canMutate || !selectedPrincipal || selectedPrincipalProtected" @click="previewPermission(false)">{{ t("xuguUserPermissions.grant") }}</Button>
</div>
</div>
</section>
</main>
</div>
<Dialog v-model:open="createDialogOpen">
<DialogContent>
<DialogHeader
><DialogTitle>{{ t("xuguUserPermissions.newPrincipal") }}</DialogTitle></DialogHeader
>
<div class="space-y-3">
<div class="flex gap-2">
<Button size="sm" :variant="kind === 'user' ? 'secondary' : 'outline'" @click="kind = 'user'">{{ t("xuguUserPermissions.createUser") }}</Button
><Button size="sm" :variant="kind === 'role' ? 'secondary' : 'outline'" @click="kind = 'role'">{{ t("xuguUserPermissions.createRole") }}</Button>
</div>
<label class="block space-y-1 text-sm">{{ t("xuguUserPermissions.name") }}<Input v-model="principalName" autocomplete="off" /></label>
<label v-if="kind === 'user'" class="block space-y-1 text-sm">{{ t("xuguUserPermissions.initialPassword") }}<Input v-model="principalPassword" type="password" autocomplete="new-password" /></label>
<template v-if="kind === 'user'">
<label class="block space-y-1 text-sm"
>{{ t("xuguUserPermissions.defaultRoles") }}
<select v-model="defaultRoleNames" multiple size="4" class="w-full rounded-md border bg-background px-2 py-1 text-sm text-foreground">
<option v-for="role in roles" :key="role.id" :value="role.name">{{ role.name }}</option>
</select>
</label>
<label class="block space-y-1 text-sm">{{ t("xuguUserPermissions.validUntil") }}<Input v-model="createValidUntil" type="datetime-local" step="1" /></label>
<label class="flex items-center gap-2 text-sm"><input v-model="createLocked" type="checkbox" />{{ t("xuguUserPermissions.createLocked") }}</label>
<label class="flex items-center gap-2 text-sm"><input v-model="createPasswordExpired" type="checkbox" />{{ t("xuguUserPermissions.createPasswordExpired") }}</label>
<p class="text-xs text-muted-foreground">{{ t("xuguUserPermissions.accountCreateHint") }}</p>
</template>
</div>
<DialogFooter
><Button variant="outline" @click="createDialogOpen = false">{{ t("common.cancel") }}</Button
><Button :disabled="!principalName.trim() || (kind === 'user' && !principalPassword)" @click="previewNewPrincipal">{{ t("xuguUserPermissions.preview") }}</Button></DialogFooter
>
</DialogContent>
</Dialog>
<Dialog v-model:open="accountDialogOpen">
<DialogContent>
<DialogHeader
><DialogTitle>{{ t("xuguUserPermissions.accountSettings") }}</DialogTitle></DialogHeader
>
<div class="space-y-3">
<label class="block space-y-1 text-sm">{{ t("xuguUserPermissions.setValidUntil") }}<Input v-model="validUntilToSet" type="datetime-local" step="1" /></label>
<label v-if="!selectedPrincipal?.expired" class="flex items-center gap-2 text-sm"><input v-model="expirePassword" type="checkbox" />{{ t("xuguUserPermissions.markPasswordExpired") }}</label>
<p v-else class="text-xs text-muted-foreground">{{ t("xuguUserPermissions.passwordAlreadyExpiredHint") }}</p>
<p class="text-xs text-muted-foreground">{{ t("xuguUserPermissions.accountSettingsHint") }}</p>
</div>
<DialogFooter>
<Button variant="outline" @click="accountDialogOpen = false">{{ t("common.cancel") }}</Button>
<Button :disabled="!validUntilToSet && !expirePassword" @click="previewAccountChanges">{{ t("xuguUserPermissions.preview") }}</Button>
</DialogFooter>
</DialogContent>
</Dialog>
<Dialog v-model:open="passwordDialogOpen">
<DialogContent>
<DialogHeader
><DialogTitle>{{ t("xuguUserPermissions.changePassword") }}</DialogTitle></DialogHeader
>
<Input v-model="passwordToSet" type="password" autocomplete="new-password" :placeholder="t('xuguUserPermissions.newPassword')" />
<DialogFooter
><Button variant="outline" @click="passwordDialogOpen = false">{{ t("common.cancel") }}</Button
><Button :disabled="!passwordToSet" @click="previewPasswordChange">{{ t("xuguUserPermissions.preview") }}</Button></DialogFooter
>
</DialogContent>
</Dialog>
<Dialog v-model:open="sqlDialogOpen">
<DialogContent class="sm:max-w-2xl">
<DialogHeader
><DialogTitle>{{ t("xuguUserPermissions.review", { action: pendingLabel }) }}</DialogTitle></DialogHeader
>
<div class="rounded-md border bg-muted/40 p-3">
<pre class="max-h-72 overflow-auto whitespace-pre-wrap break-all font-mono text-xs">{{ previewSql }}</pre>
</div>
<p class="text-xs text-muted-foreground">{{ t(pendingSystemWide ? "xuguUserPermissions.systemWide" : "xuguUserPermissions.currentDatabaseOnly") }}</p>
<DialogFooter
><Button variant="outline" :disabled="mutating" @click="sqlDialogOpen = false">{{ t("common.cancel") }}</Button
><Button :disabled="mutating || !canMutate" @click="applyPendingSql"><Loader2 v-if="mutating" class="mr-2 size-4 animate-spin" />{{ t("xuguUserPermissions.execute") }}</Button></DialogFooter
>
</DialogContent>
</Dialog>
</div>
</template>
@@ -0,0 +1,316 @@
// @vitest-environment happy-dom
import { createApp, nextTick, type App } from "vue";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
const mocks = vi.hoisted(() => ({
ensureConnected: vi.fn(),
executeQuery: vi.fn(),
executeMulti: vi.fn(),
listDatabases: vi.fn(),
toast: vi.fn(),
guard: vi.fn(async ({ execute }: { execute: () => Promise<unknown> }) => execute()),
}));
vi.mock("vue-i18n", () => ({ useI18n: () => ({ t: (key: string) => key }) }));
vi.mock("@lucide/vue", async () => {
const { defineComponent, h } = await import("vue");
const icon = defineComponent({ setup: () => () => h("i") });
return { AlertTriangle: icon, KeyRound: icon, Loader2: icon, Plus: icon, RefreshCw: icon, ShieldCheck: icon, Trash2: icon, Unlock: icon, UserRound: icon, UsersRound: icon };
});
vi.mock("@/components/ui/badge", async () => {
const { defineComponent, h } = await import("vue");
return {
Badge: defineComponent({
inheritAttrs: false,
setup:
(_, { attrs, slots }) =>
() =>
h("span", attrs, slots.default?.()),
}),
};
});
vi.mock("@/components/ui/button", async () => {
const { defineComponent, h } = await import("vue");
return {
Button: defineComponent({
inheritAttrs: false,
setup:
(_, { attrs, slots }) =>
() =>
h("button", attrs, slots.default?.()),
}),
};
});
vi.mock("@/components/ui/input", async () => {
const { defineComponent, h } = await import("vue");
return {
Input: defineComponent({
inheritAttrs: false,
props: { modelValue: { type: [String, Number], default: "" } },
emits: ["update:modelValue"],
setup(props, { attrs, emit }) {
return () => h("input", { ...attrs, value: props.modelValue, onInput: (event: Event) => emit("update:modelValue", (event.target as HTMLInputElement).value) });
},
}),
};
});
vi.mock("@/components/ui/dialog", async () => {
const { defineComponent, h } = await import("vue");
const passthrough = (tag: string) =>
defineComponent({
inheritAttrs: false,
setup:
(_, { attrs, slots }) =>
() =>
h(tag, attrs, slots.default?.()),
});
return {
Dialog: defineComponent({
props: { open: Boolean },
setup:
(props, { slots }) =>
() =>
props.open ? h("div", { "data-dialog": "" }, slots.default?.()) : null,
}),
DialogContent: passthrough("section"),
DialogFooter: passthrough("footer"),
DialogHeader: passthrough("header"),
DialogTitle: passthrough("h2"),
};
});
vi.mock("@/composables/useToast", () => ({ useToast: () => ({ toast: mocks.toast }) }));
vi.mock("@/stores/connectionStore", () => ({ useConnectionStore: () => ({ ensureConnected: mocks.ensureConnected }) }));
vi.mock("@/lib/backend/api", () => ({ executeQuery: mocks.executeQuery, executeMulti: mocks.executeMulti, listDatabases: mocks.listDatabases }));
vi.mock("@/lib/database/productionExecutionGuard", () => ({
executeWithProductionSqlGuard: mocks.guard,
}));
import XuguUserPermissions from "@/components/admin/XuguUserPermissions.vue";
let app: App<Element> | undefined;
let root: HTMLDivElement | undefined;
function queryResult(columns: string[], rows: unknown[][] = []) {
return { columns, rows, affected_rows: 0, execution_time_ms: 0 };
}
function configureCompleteCatalogs() {
mocks.executeQuery.mockImplementation(async (_connectionId: string, database: string, sql: string) => {
if (database !== "SYSTEM") throw new Error(`Unexpected database context: ${database}`);
if (sql.includes("SELECT DATABASE()")) return queryResult(["DATABASE_NAME"], [["SYSTEM"]]);
if (sql.includes("FROM DBA_USERS")) return queryResult(["USER_ID", "USER_NAME", "LOCKED", "EXPIRED", "IS_SYS", "UNTIL_TIME", "ALIAS"], [[101, "APP_READER", false, false, false, null, null]]);
if (sql.includes("FROM DBA_ROLES")) return queryResult(["USER_ID", "USER_NAME", "IS_SYS"], [[201, "APP_READ_ROLE", false]]);
if (sql.includes("FROM DBA_SCHEMAS")) return queryResult(["SCHEMA_ID", "SCHEMA_NAME"], [[1, "APP_SCHEMA"]]);
if (sql.includes("FROM DBA_ROLE_MEMBERS")) return queryResult(["USER_ID", "ROLE_ID"], []);
if (sql.includes("FROM DBA_ACLS")) return queryResult(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "SCOPE", "TARGET_NAME"], []);
throw new Error(`Unexpected catalog request: ${sql}`);
});
}
async function mountPage(readOnly = false) {
root = document.createElement("div");
document.body.append(root);
app = createApp(XuguUserPermissions, {
connection: { id: "xugu-connection", name: "Xugu test", db_type: "xugu", database: "SYSTEM", read_only: readOnly } as never,
});
app.mount(root);
await vi.waitFor(() => expect(mocks.executeQuery).toHaveBeenCalled());
await vi.waitFor(() => expect(root?.textContent).toContain("APP_READER"));
await nextTick();
return root;
}
function buttonByText(container: HTMLElement, text: string): HTMLButtonElement {
const found = Array.from(container.querySelectorAll("button")).find((candidate) => candidate.textContent?.trim().includes(text));
if (!found) throw new Error(`Could not find button: ${text}`);
return found as HTMLButtonElement;
}
beforeEach(() => {
mocks.ensureConnected.mockReset().mockResolvedValue(undefined);
mocks.executeQuery.mockReset();
mocks.executeMulti.mockReset().mockResolvedValue([queryResult([])]);
mocks.listDatabases.mockReset().mockResolvedValue([{ name: "SYSTEM" }, { name: "APP_DB" }]);
mocks.toast.mockReset();
mocks.guard.mockClear();
root = undefined;
app = undefined;
});
afterEach(() => {
app?.unmount();
root?.remove();
app = undefined;
root = undefined;
document.body.innerHTML = "";
});
describe("XuguUserPermissions", () => {
it("keeps catalog reads in the confirmed database and shows SQL for review without executing it", async () => {
configureCompleteCatalogs();
const container = await mountPage();
expect(mocks.ensureConnected).toHaveBeenCalledWith("xugu-connection");
expect(mocks.executeQuery.mock.calls.every(([, database]) => database === "SYSTEM")).toBe(true);
expect(container.textContent).toContain("xuguUserPermissions.scopeSystem");
const privilegeCheckbox = container.querySelector('input[type="checkbox"]') as HTMLInputElement | null;
expect(privilegeCheckbox).not.toBeNull();
privilegeCheckbox!.click();
await nextTick();
buttonByText(container, "xuguUserPermissions.grant").click();
await nextTick();
expect(container.querySelector("[data-dialog]")?.textContent).toContain("GRANT");
expect(mocks.executeMulti).not.toHaveBeenCalled();
buttonByText(container, "xuguUserPermissions.execute").click();
await vi.waitFor(() => expect(mocks.executeMulti).toHaveBeenCalledTimes(1));
expect(mocks.guard).toHaveBeenCalledWith(expect.objectContaining({ database: "SYSTEM", connection: expect.objectContaining({ db_type: "xugu" }) }));
expect(mocks.executeMulti.mock.calls[0]?.[2]).toContain("GRANT");
});
it("does not expose management actions on read-only connections", async () => {
configureCompleteCatalogs();
const container = await mountPage(true);
expect(buttonByText(container, "xuguUserPermissions.newPrincipal").disabled).toBe(true);
expect(buttonByText(container, "xuguUserPermissions.grant").disabled).toBe(true);
expect(buttonByText(container, "xuguUserPermissions.revoke").disabled).toBe(true);
expect(mocks.executeMulti).not.toHaveBeenCalled();
});
it("keeps account creation confirmation database-local even after selecting an instance-wide grant scope", async () => {
configureCompleteCatalogs();
const container = await mountPage();
await vi.waitFor(() => expect(buttonByText(container, "xuguUserPermissions.newPrincipal").disabled).toBe(false));
const systemScope = Array.from(container.querySelectorAll("select")).find((select) => Array.from(select.options).some((option) => option.value === "system"));
expect(systemScope).toBeDefined();
systemScope!.value = "system";
systemScope!.dispatchEvent(new Event("change", { bubbles: true }));
await nextTick();
buttonByText(container, "xuguUserPermissions.newPrincipal").click();
await nextTick();
buttonByText(container, "xuguUserPermissions.createRole").click();
await nextTick();
const nameInput = Array.from(container.querySelectorAll("label"))
.find((label) => label.textContent?.includes("xuguUserPermissions.name"))
?.querySelector("input");
expect(nameInput).toBeDefined();
nameInput!.value = "APP_TEST_ROLE";
nameInput!.dispatchEvent(new Event("input", { bubbles: true }));
await nextTick();
buttonByText(container, "xuguUserPermissions.preview").click();
await nextTick();
const dialogText = container.querySelector("[data-dialog]")?.textContent ?? "";
expect(dialogText).toContain("xuguUserPermissions.currentDatabaseOnly");
expect(dialogText).not.toContain("xuguUserPermissions.systemWide");
expect(mocks.executeMulti).not.toHaveBeenCalled();
});
it("previews user creation with default roles and account lifecycle settings before execution", async () => {
configureCompleteCatalogs();
const container = await mountPage();
buttonByText(container, "xuguUserPermissions.newPrincipal").click();
await nextTick();
const inputForLabel = (key: string) => {
const label = Array.from(container.querySelectorAll("label")).find((candidate) => candidate.textContent?.includes(key));
const input = label?.querySelector("input");
if (!input) throw new Error(`Could not find input for ${key}`);
return input;
};
const setInput = (key: string, value: string) => {
const input = inputForLabel(key);
input.value = value;
input.dispatchEvent(new Event("input", { bubbles: true }));
};
setInput("xuguUserPermissions.name", "APP_NEW_USER");
setInput("xuguUserPermissions.initialPassword", "Secret_123!");
setInput("xuguUserPermissions.validUntil", "2035-06-07T08:09");
const rolesLabel = Array.from(container.querySelectorAll("label")).find((candidate) => candidate.textContent?.includes("xuguUserPermissions.defaultRoles"));
const roleSelect = rolesLabel?.querySelector("select");
expect(roleSelect?.multiple).toBe(true);
const roleOption = Array.from(roleSelect?.options ?? []).find((option) => option.value === "APP_READ_ROLE");
expect(roleOption).toBeDefined();
roleOption!.selected = true;
roleSelect!.dispatchEvent(new Event("change", { bubbles: true }));
for (const key of ["xuguUserPermissions.createLocked", "xuguUserPermissions.createPasswordExpired"]) {
const input = inputForLabel(key);
input.checked = true;
input.dispatchEvent(new Event("change", { bubbles: true }));
}
await nextTick();
buttonByText(container, "xuguUserPermissions.preview").click();
await nextTick();
const preview = container.querySelector("pre")?.textContent ?? "";
expect(preview).toContain('DEFAULT ROLE "APP_READ_ROLE"');
expect(preview).toContain("VALID UNTIL '2035-06-07 08:09'");
expect(preview).toContain("ACCOUNT LOCK");
expect(preview).toContain("PASSWORD EXPIRE");
expect(preview).not.toContain("Secret_123!");
expect(mocks.executeMulti).not.toHaveBeenCalled();
});
it("previews account expiration changes and exposes table-level trigger privileges", async () => {
configureCompleteCatalogs();
const container = await mountPage();
const objectScope = Array.from(container.querySelectorAll("select")).find((select) => Array.from(select.options).some((option) => option.value === "object"));
objectScope!.value = "object";
objectScope!.dispatchEvent(new Event("change", { bubbles: true }));
await nextTick();
const objectType = Array.from(container.querySelectorAll("select")).find((select) => Array.from(select.options).some((option) => option.value === "TABLE"));
expect(objectType).toBeDefined();
expect(Array.from(objectType!.options).some((option) => option.value === "TRIGGER")).toBe(false);
expect(Array.from(container.querySelectorAll("label")).some((label) => label.textContent?.trim() === "TRIGGER")).toBe(true);
buttonByText(container, "xuguUserPermissions.accountSettings").click();
await nextTick();
const validUntilLabel = Array.from(container.querySelectorAll("label")).find((candidate) => candidate.textContent?.includes("xuguUserPermissions.setValidUntil"));
const validUntil = validUntilLabel?.querySelector("input");
expect(validUntil).toBeDefined();
validUntil!.value = "2035-06-07T08:09";
validUntil!.dispatchEvent(new Event("input", { bubbles: true }));
const expiredLabel = Array.from(container.querySelectorAll("label")).find((candidate) => candidate.textContent?.includes("xuguUserPermissions.markPasswordExpired"));
const expired = expiredLabel?.querySelector("input");
expect(expired).toBeDefined();
expired!.checked = true;
expired!.dispatchEvent(new Event("change", { bubbles: true }));
await nextTick();
buttonByText(container, "xuguUserPermissions.preview").click();
await nextTick();
const preview = container.querySelector("pre")?.textContent ?? "";
expect(preview).toContain("VALID UNTIL '2035-06-07 08:09'");
expect(preview).toContain("PASSWORD EXPIRE");
expect(mocks.executeMulti).not.toHaveBeenCalled();
});
it("fails closed when only limited visibility catalogs can be read", async () => {
mocks.executeQuery.mockImplementation(async (_connectionId: string, database: string, sql: string) => {
if (database !== "SYSTEM") throw new Error(`Unexpected database context: ${database}`);
if (sql.includes("SELECT DATABASE()")) return queryResult(["DATABASE_NAME"], [["SYSTEM"]]);
if (sql.includes("FROM DBA_USERS") || sql.includes("FROM DBA_ROLES") || sql.includes("FROM DBA_ROLE_MEMBERS") || sql.includes("FROM DBA_ACLS")) {
return { ...queryResult([], []), execution_error: true, rows: [["insufficient privilege"]] };
}
if (sql.includes("FROM ALL_USERS")) return queryResult(["USER_ID", "USER_NAME", "LOCKED", "EXPIRED", "IS_SYS", "UNTIL_TIME", "ALIAS"], [[101, "APP_READER", false, false, false, null, null]]);
if (sql.includes("FROM ALL_ROLE_MEMBERS")) return queryResult(["USER_ID", "ROLE_ID"], []);
if (sql.includes("FROM ALL_SCHEMAS")) return queryResult(["SCHEMA_ID", "SCHEMA_NAME"], []);
if (sql.includes("FROM ALL_ACLS")) return queryResult(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "SCOPE", "TARGET_NAME"], []);
throw new Error(`Unexpected catalog request: ${sql}`);
});
const container = await mountPage();
expect(container.textContent).toContain("xuguUserPermissions.limitedCatalog");
expect(buttonByText(container, "xuguUserPermissions.newPrincipal").disabled).toBe(true);
expect(buttonByText(container, "xuguUserPermissions.grant").disabled).toBe(true);
expect(mocks.executeMulti).not.toHaveBeenCalled();
});
});
@@ -123,6 +123,7 @@ const DatabaseBrowser = defineAsyncComponent(() => import("@/components/objects/
const ObjectBrowser = defineAsyncComponent(() => import("@/components/objects/ObjectBrowser.vue")); const ObjectBrowser = defineAsyncComponent(() => import("@/components/objects/ObjectBrowser.vue"));
const TableStructureEditor = defineAsyncComponent(() => import("@/components/structure/TableStructureEditor.vue")); const TableStructureEditor = defineAsyncComponent(() => import("@/components/structure/TableStructureEditor.vue"));
const DatabaseUserAdmin = defineAsyncComponent(() => import("@/components/admin/DatabaseUserAdmin.vue")); const DatabaseUserAdmin = defineAsyncComponent(() => import("@/components/admin/DatabaseUserAdmin.vue"));
const XuguUserPermissions = defineAsyncComponent(() => import("@/components/admin/XuguUserPermissions.vue"));
const ProcessListPanel = defineAsyncComponent(() => import("@/components/admin/ProcessListPanel.vue")); const ProcessListPanel = defineAsyncComponent(() => import("@/components/admin/ProcessListPanel.vue"));
const SqlServerActivityTracePanel = defineAsyncComponent(() => import("@/components/admin/SqlServerActivityTracePanel.vue")); const SqlServerActivityTracePanel = defineAsyncComponent(() => import("@/components/admin/SqlServerActivityTracePanel.vue"));
const MySqlDashboard = defineAsyncComponent(() => import("@/components/admin/MySqlDashboard.vue")); const MySqlDashboard = defineAsyncComponent(() => import("@/components/admin/MySqlDashboard.vue"));
@@ -3084,6 +3085,10 @@ defineExpose({
<DatabaseUserAdmin :key="activeTab.id" :connection="activeConnection" /> <DatabaseUserAdmin :key="activeTab.id" :connection="activeConnection" />
</template> </template>
<template v-else-if="activeTab.mode === 'xugu-users' && activeConnection">
<XuguUserPermissions :key="activeTab.id" :connection="activeConnection" />
</template>
<template v-else-if="activeTab.mode === 'processlist' && activeConnection"> <template v-else-if="activeTab.mode === 'processlist' && activeConnection">
<ProcessListPanel :key="activeTab.id" :connection="activeConnection" /> <ProcessListPanel :key="activeTab.id" :connection="activeConnection" />
</template> </template>
@@ -1036,6 +1036,9 @@ async function toggle(requestId = beginNavigationRequest()) {
} else if (node.type === "user-admin" && node.connectionId) { } else if (node.type === "user-admin" && node.connectionId) {
await connectionStore.ensureConnected(node.connectionId); await connectionStore.ensureConnected(node.connectionId);
queryStore.openUserAdmin(node.connectionId); queryStore.openUserAdmin(node.connectionId);
} else if (node.type === "xugu-user-admin" && node.connectionId) {
await connectionStore.ensureConnected(node.connectionId);
queryStore.openXuguUserAdmin(node.connectionId);
} else if (node.type === "dameng-users" && node.connectionId) { } else if (node.type === "dameng-users" && node.connectionId) {
await connectionStore.ensureConnected(node.connectionId); await connectionStore.ensureConnected(node.connectionId);
queryStore.openDamengUsers(node.connectionId); queryStore.openDamengUsers(node.connectionId);
@@ -1844,6 +1847,18 @@ async function openUserAdmin() {
} }
} }
async function openXuguUserPermissions() {
const node = activeNode.value;
if (!node.connectionId) return;
try {
await connectionStore.ensureConnected(node.connectionId);
connectionStore.activeConnectionId = node.connectionId;
queryStore.openXuguUserAdmin(node.connectionId);
} catch (e: any) {
toast(t("connection.connectFailed", { message: translateBackendError(t, e?.message || String(e)) }), 5000);
}
}
async function openProcessList() { async function openProcessList() {
const node = activeNode.value; const node = activeNode.value;
if (!node.connectionId) return; if (!node.connectionId) return;
@@ -6060,6 +6075,11 @@ function buildSpecialSidebarMenu(context: SidebarMenuFactoryContext): boolean {
return true; return true;
} }
if (node.type === "xugu-user-admin") {
items.push({ label: t("contextMenu.openXuguUserPermissions"), action: openXuguUserPermissions, icon: ShieldCheck });
return true;
}
if (node.type === "dameng-job-admin") { if (node.type === "dameng-job-admin") {
items.push({ label: t("contextMenu.openDamengJobAdmin"), action: openDamengJobAdmin, icon: CalendarClock }); items.push({ label: t("contextMenu.openDamengJobAdmin"), action: openDamengJobAdmin, icon: CalendarClock });
return true; return true;
@@ -309,6 +309,8 @@ function getIconInfo(node: TreeNode): { icon: any; colorClass: string } | null {
return { icon: TableProperties, colorClass: "text-primary" }; return { icon: TableProperties, colorClass: "text-primary" };
case "user-admin": case "user-admin":
return { icon: UsersRound, colorClass: "text-primary" }; return { icon: UsersRound, colorClass: "text-primary" };
case "xugu-user-admin":
return { icon: ShieldCheck, colorClass: "text-primary" };
case "dameng-users": case "dameng-users":
return { icon: UsersRound, colorClass: "text-primary" }; return { icon: UsersRound, colorClass: "text-primary" };
case "dameng-roles": case "dameng-roles":
@@ -447,7 +449,7 @@ function displayLabel(node: TreeNode): string {
// Use the canonical key for persisted trees created before this label was // Use the canonical key for persisted trees created before this label was
// internationalized; those nodes may still contain the old Chinese text. // internationalized; those nodes may still contain the old Chinese text.
if (node.type === "nacos-access-control") return t("nacos.accessControlSidebarLabel"); if (node.type === "nacos-access-control") return t("nacos.accessControlSidebarLabel");
if (node.type === "user-admin" || node.type === "dameng-users" || node.type === "dameng-roles" || node.type === "dameng-job-admin" || node.type === "meilisearch-system") return t(node.label); if (node.type === "user-admin" || node.type === "xugu-user-admin" || node.type === "dameng-users" || node.type === "dameng-roles" || node.type === "dameng-job-admin" || node.type === "meilisearch-system") return t(node.label);
if (node.type === "oracle-db-links" || node.type === "linked-server-root") return t(node.label); if (node.type === "oracle-db-links" || node.type === "linked-server-root") return t(node.label);
if (node.type === "saved-sql-root") return t(node.label); if (node.type === "saved-sql-root") return t(node.label);
if (node.type === "mqtt-topic" && node.id.endsWith(":mqtt-topic:__console__")) return t(node.label); if (node.type === "mqtt-topic" && node.id.endsWith(":mqtt-topic:__console__")) return t(node.label);
+98
View File
@@ -3806,6 +3806,8 @@ export default {
configureVisibleObjects: "Visible Object Filter", configureVisibleObjects: "Visible Object Filter",
userAdmin: "Users & Privileges", userAdmin: "Users & Privileges",
openUserAdmin: "Open Users & Privileges", openUserAdmin: "Open Users & Privileges",
xuguUserPermissions: "Xugu Users & Privileges",
openXuguUserPermissions: "Open Xugu Users & Privileges",
processList: "Process List", processList: "Process List",
sqlServerTrace: "Activity Trace", sqlServerTrace: "Activity Trace",
serverDashboard: "Server Dashboard", serverDashboard: "Server Dashboard",
@@ -4308,6 +4310,7 @@ export default {
savedSql: "SQL Library", savedSql: "SQL Library",
queries: "Queries", queries: "Queries",
userAdmin: "Users & Privileges", userAdmin: "Users & Privileges",
xuguUserPermissions: "Xugu Users & Privileges",
damengUsers: "Users", damengUsers: "Users",
damengRoles: "Roles", damengRoles: "Roles",
damengJobAdmin: "Agent Jobs", damengJobAdmin: "Agent Jobs",
@@ -4810,6 +4813,101 @@ export default {
scopeFunctions: "functions", scopeFunctions: "functions",
stepSkipped: "Skipped because a required previous step failed.", stepSkipped: "Skipped because a required previous step failed.",
}, },
xuguUserPermissions: {
title: "Xugu Users & Privileges",
refresh: "Refresh",
databaseContext: "Manage database",
chooseDatabase: "Choose a database",
databaseContextUnknown: "The active database could not be identified. Select one from the list above if available; otherwise verify the connection's default database and refresh. Changes remain disabled until the context is explicit.",
databaseListLimited: "The database list could not be fully loaded; this page is limited to the confirmed database context.",
newPrincipal: "New User / Role",
users: "Users",
roles: "Roles",
search: "Search users or roles",
system: "System",
locked: "Locked",
active: "Active",
expired: "Expired",
validUntil: "Valid until: {value}",
inheritedRoles: "Inherited roles: {roles}",
role: "Role",
user: "User",
systemPrincipal: "System principal",
readOnly: "Read-only connection",
readOnlyHint: "This connection is read-only; management actions are disabled.",
limitedCatalog: "This account cannot read the complete user and role catalogs, so only visible principals are listed. Management actions are disabled to prevent mistakes from incomplete information.",
limitedAcl: "Only ACL rows visible to the current account are available; grants for other users or roles may be missing.",
managementRequiresDba: "Full management requires access to DBA_USERS, DBA_ROLES, DBA_ROLE_MEMBERS, and DBA_ACLS. Otherwise, only visible information is shown and changes are disabled.",
targetLookupFailed: "Could not load object/column names. You may enter an exact name manually; review it carefully before execution.",
targetLookupIncomplete: "The candidate list is capped at 1,000 items. Enter the exact name manually if the target is not listed.",
columnGrantOptionUnsupported: "Xugu does not support WITH GRANT OPTION for column-level privileges.",
empty: "No visible users or roles.",
grantsTitle: "Privilege Details",
grantsHint: "Direct grants and grants inherited through roles are listed separately. This is not a complete database-computed effective-privilege report.",
loading: "Loading...",
noGrants: "No visible grant rows were found.",
unmappedAuthority: "Unmapped authority",
privilege: "Privilege",
scope: "Scope",
scopeDatabase: "Current database",
scopeSystem: "Instance-level",
scopeSchema: "Schema",
scopeObject: "Object",
scopeColumn: "Column",
scopeRole: "Role membership",
scopeAdmin: "Administrative authority",
target: "Target",
source: "Source",
grantable: "Grantable",
viaRole: "Via role {role}",
direct: "Direct grant",
yes: "Yes",
no: "No",
editorTitle: "Grant / Revoke",
editorHint: "Catalog queries use the database selected above. Grant SQL is shown for review first; instance-level privileges affect the whole instance.",
systemScopeHint: "Available only while connected to SYSTEM. Creating, altering, or dropping a database affects the current instance.",
systemWide: "This grants or revokes an instance-level privilege and affects the whole instance, not only the current database.",
schema: "Schema name",
objectType: "Object type",
tableColumn: "Table column",
viewColumn: "View column",
object: "Object name",
column: "Column name",
roleToGrant: "Role name to grant",
adminAuthority: "Administrative authority",
grantOption: "Allow further object grants (WITH GRANT OPTION)",
revokeGrantOptionOnly: "Revoke grant option only",
grantOptionScope: "WITH GRANT OPTION is available only for object-level grants; Xugu does not support column-level grant option.",
grant: "Grant",
revoke: "Revoke",
newUser: "New User",
createUser: "User",
createRole: "Role",
name: "Name",
initialPassword: "Initial password",
defaultRoles: "Default roles (select multiple)",
createLocked: "Lock account after creation",
createPasswordExpired: "Require a password reset after creation",
accountCreateHint: "New account attributes are shown as SQL for review first; a locked or password-expired account cannot sign in normally.",
accountSettings: "Account settings",
setValidUntil: "Set account expiration date",
markPasswordExpired: "Mark password as expired",
passwordAlreadyExpiredHint: "The password is already expired. Use Change Password to clear the expired state.",
accountSettingsHint: "Leave the expiration date blank to keep the current value. Clearing an existing expiration is not available here; use the account card to lock or unlock the user.",
changePassword: "Change password",
newPassword: "Enter new password",
lock: "Lock",
unlock: "Unlock",
dropUser: "Drop user",
dropRole: "Drop role",
preview: "Preview SQL",
review: "Review action: {action}",
currentDatabaseOnly: "SQL runs against the database selected above. User drop uses RESTRICT, never CASCADE. Built-in and system principals cannot be dropped here.",
execute: "Confirm and execute",
operationSuccess: "Operation completed; privilege data refreshed.",
operationFailed: "Operation failed",
operationFailedWithMessage: "Operation failed: {message}",
},
damengJobAdmin: { damengJobAdmin: {
title: "Dameng Agent Jobs", title: "Dameng Agent Jobs",
unsupported: "This page only supports Dameng connections.", unsupported: "This page only supports Dameng connections.",
+98
View File
@@ -3720,6 +3720,8 @@ export default withEnglishFallback({
duplicateSelectedConnections: "复制选中的 {count} 个连接", duplicateSelectedConnections: "复制选中的 {count} 个连接",
userAdmin: "用户与权限", userAdmin: "用户与权限",
openUserAdmin: "打开用户与权限", openUserAdmin: "打开用户与权限",
xuguUserPermissions: "虚谷用户与权限",
openXuguUserPermissions: "打开虚谷用户与权限",
processList: "进程列表", processList: "进程列表",
sqlServerTrace: "活动跟踪", sqlServerTrace: "活动跟踪",
serverDashboard: "服务器仪表盘", serverDashboard: "服务器仪表盘",
@@ -4218,6 +4220,7 @@ export default withEnglishFallback({
savedSql: "SQL 库", savedSql: "SQL 库",
queries: "查询", queries: "查询",
userAdmin: "用户与权限", userAdmin: "用户与权限",
xuguUserPermissions: "虚谷用户与权限",
damengUsers: "用户", damengUsers: "用户",
damengRoles: "角色", damengRoles: "角色",
damengJobAdmin: "代理作业", damengJobAdmin: "代理作业",
@@ -4785,6 +4788,101 @@ export default withEnglishFallback({
scopeFunctions: "函数", scopeFunctions: "函数",
stepSkipped: "因依赖的前置步骤失败而跳过。", stepSkipped: "因依赖的前置步骤失败而跳过。",
}, },
xuguUserPermissions: {
title: "虚谷用户与权限",
refresh: "刷新",
databaseContext: "管理数据库",
chooseDatabase: "选择数据库",
databaseContextUnknown: "无法确认当前数据库。若上方有可选数据库,请选择一个;否则请检查连接默认数据库后刷新。上下文明确前,所有授权和账号修改操作都会禁用。",
databaseListLimited: "无法完整读取数据库列表;当前页面仅针对已确认的数据库操作。",
newPrincipal: "新建用户 / 角色",
users: "用户",
roles: "角色",
search: "搜索用户或角色",
system: "系统",
locked: "已锁定",
active: "正常",
expired: "已过期",
validUntil: "有效期至:{value}",
inheritedRoles: "继承角色:{roles}",
role: "角色",
user: "用户",
systemPrincipal: "系统主体",
readOnly: "只读连接",
readOnlyHint: "当前连接为只读,管理操作已禁用。",
limitedCatalog: "当前账号无法读取完整的用户和角色字典,因此只显示可见范围;为避免不完整信息导致误操作,所有管理操作已禁用。",
limitedAcl: "仅能读取当前账号可见的权限记录,未必包含数据库内所有用户/角色的授权。",
managementRequiresDba: "完整管理需要有权读取 DBA_USERS、DBA_ROLES、DBA_ROLE_MEMBERS 和 DBA_ACLS;否则仅显示可见信息且不能修改。",
targetLookupFailed: "对象/列目录读取失败;可以手动填写准确名称,执行前请仔细核对。",
targetLookupIncomplete: "候选列表最多显示 1000 项;若未列出目标,请手动填写准确名称。",
columnGrantOptionUnsupported: "虚谷列级权限不支持 WITH GRANT OPTION。",
empty: "没有可显示的用户或角色。",
grantsTitle: "权限明细",
grantsHint: "直接授权与通过角色继承的授权分开展示;这不是数据库计算后的完整有效权限报告。",
loading: "正在加载...",
noGrants: "当前未发现可见的授权记录。",
unmappedAuthority: "未映射权限值",
privilege: "权限",
scope: "授权范围",
scopeDatabase: "当前数据库",
scopeSystem: "实例级",
scopeSchema: "模式",
scopeObject: "对象",
scopeColumn: "列",
scopeRole: "角色成员",
scopeAdmin: "管理权限",
target: "目标",
source: "来源",
grantable: "可继续授权",
viaRole: "通过角色 {role}",
direct: "直接授权",
yes: "是",
no: "否",
editorTitle: "授权 / 撤权",
editorHint: "目录查询针对上方选择的数据库;授权 SQL 会先展示供确认,实例级权限除外,它会作用于整个实例。",
systemScopeHint: "仅在 SYSTEM 库连接下可授予;创建、修改或删除数据库会影响当前实例。",
systemWide: "此操作授予或回收实例级权限,将影响整个实例,而不只是当前数据库。",
schema: "模式名",
objectType: "对象类型",
tableColumn: "表列",
viewColumn: "视图列",
object: "对象名",
column: "列名",
roleToGrant: "授予的角色名",
adminAuthority: "管理权限类型",
grantOption: "允许继续授予对象权限(WITH GRANT OPTION)",
revokeGrantOptionOnly: "只撤销继续授权选项",
grantOptionScope: "WITH GRANT OPTION 仅用于对象级授权;虚谷不支持列级转授权。",
grant: "授权",
revoke: "撤权",
newUser: "新建用户",
createUser: "用户",
createRole: "角色",
name: "名称",
initialPassword: "初始密码",
defaultRoles: "默认角色(可多选)",
createLocked: "创建后锁定账号",
createPasswordExpired: "创建后要求重置密码",
accountCreateHint: "新账号属性会先展示为 SQL 供确认;锁定或密码过期会阻止该用户正常登录。",
accountSettings: "账号状态设置",
setValidUntil: "设置有效期截止时间",
markPasswordExpired: "将密码标记为过期",
passwordAlreadyExpiredHint: "密码已过期;如需解除,请使用“修改密码”。",
accountSettingsHint: "有效期留空表示不修改现有值;目前不提供清除有效期的操作。锁定状态可通过账号卡片上的锁定/解锁按钮管理。",
changePassword: "修改密码",
newPassword: "输入新密码",
lock: "锁定",
unlock: "解锁",
dropUser: "删除用户",
dropRole: "删除角色",
preview: "预览 SQL",
review: "确认操作:{action}",
currentDatabaseOnly: "SQL 通过上方选择的数据库执行。删除用户使用 RESTRICT,不会级联删除对象;内置/系统主体不可从此界面删除。",
execute: "确认执行",
operationSuccess: "操作已执行,权限信息已刷新。",
operationFailed: "操作执行失败",
operationFailedWithMessage: "操作执行失败:{message}",
},
damengJobAdmin: { damengJobAdmin: {
title: "达梦代理作业", title: "达梦代理作业",
unsupported: "当前页面仅支持达梦数据库连接。", unsupported: "当前页面仅支持达梦数据库连接。",
@@ -0,0 +1,290 @@
import { describe, expect, it } from "vitest";
import type { QueryResult } from "@/types/database";
import {
XUGU_OBJECT_TYPES,
decodeXuguAuthority,
xuguAclAuthorityLabels,
parseXuguAclRows,
parseXuguMemberships,
parseXuguPrincipals,
xuguAclRowsFallbackSql,
xuguAclRowsSql,
xuguAclColumnTargetsSql,
xuguAlterLockSql,
xuguAlterAccountSql,
xuguAlterPasswordSql,
xuguCreatePrincipalSql,
xuguEnrichAclColumnTargets,
xuguDropPrincipalSql,
xuguDatabaseOptions,
xuguGrantSql,
xuguInheritedRoleIds,
xuguListRolesSql,
xuguListSchemasSql,
xuguListUsersSql,
xuguListObjectNamesSql,
xuguListColumnNamesSql,
xuguPrivilegesForScope,
xuguQuoteIdentifier,
xuguQuoteLiteral,
xuguRevokeSql,
xuguRoleMembershipsSql,
type XuguPrincipal,
} from "../xuguUserPermissions";
function result(columns: string[], rows: unknown[][]): QueryResult {
return { columns, rows } as QueryResult;
}
const user: XuguPrincipal = {
id: "42",
name: "APP_USER",
isRole: false,
locked: false,
expired: false,
isSystem: false,
};
describe("Xugu user and privilege helpers", () => {
it("quotes identifiers and literals without allowing statement injection", () => {
expect(xuguQuoteIdentifier('user"; DROP USER X')).toBe('"user""; DROP USER X"');
expect(xuguQuoteLiteral("p'ass;word")).toBe("'p''ass;word'");
expect(() => xuguQuoteIdentifier(" ")).toThrow("An identifier is required.");
expect(() => xuguQuoteIdentifier("bad\nvalue")).toThrow("An identifier is required.");
expect(() => xuguQuoteLiteral("bad\0value")).toThrow("Invalid string value.");
});
it("keeps database selection explicit and includes the confirmed current context", () => {
expect(xuguDatabaseOptions([" DB_B ", "DB_A", "DB_A", ""], "DB_C")).toEqual(["DB_A", "DB_B", "DB_C"]);
expect(xuguDatabaseOptions([], "DB_CURRENT")).toEqual(["DB_CURRENT"]);
expect(xuguDatabaseOptions(["DB_A"], "")).toEqual(["DB_A"]);
});
it("scopes all catalog enumeration to the currently connected Xugu database", () => {
expect(xuguListUsersSql()).toContain("DB_ID = CURRENT_DB_ID");
expect(xuguListRolesSql()).toContain("DB_ID = CURRENT_DB_ID");
expect(xuguRoleMembershipsSql()).toContain("DB_ID = CURRENT_DB_ID");
expect(xuguListSchemasSql()).toContain("DB_ID = CURRENT_DB_ID");
expect(xuguListObjectNamesSql("APP' SCHEMA", "TABLE")).toContain("S.SCHEMA_NAME = 'APP'' SCHEMA'");
expect(xuguListObjectNamesSql("APP", "TABLE")).toContain("FROM DBA_OBJECTS O JOIN DBA_SCHEMAS S");
expect(xuguListObjectNamesSql("APP", "TABLE")).toContain("O.OBJ_TYPE = 5");
expect(xuguListObjectNamesSql("APP", "TABLE", false)).toContain("FROM ALL_OBJECTS O JOIN ALL_SCHEMAS S");
expect(() => xuguListObjectNamesSql("APP", "TRIGGER")).toThrow("Choose a supported object type.");
expect(xuguListColumnNamesSql("APP", "ORDERS", "TABLE")).toContain("FROM DBA_COLUMNS C JOIN DBA_TABLES T");
expect(xuguListColumnNamesSql("APP", "ORDERS", "TABLE")).toContain("T.TABLE_NAME = 'ORDERS'");
expect(xuguListColumnNamesSql("APP", "ORDER_VIEW", "VIEW")).toContain("FROM DBA_VIEW_COLUMNS C JOIN DBA_VIEWS V");
expect(xuguListColumnNamesSql("APP", "ORDER_VIEW", "VIEW")).toContain("V.VIEW_NAME = 'ORDER_VIEW'");
expect(xuguListColumnNamesSql("APP", "ORDER_VIEW", "VIEW", false)).toContain("FROM ALL_VIEW_COLUMNS C JOIN ALL_VIEWS V");
expect(() => xuguListObjectNamesSql("APP", "DATABASE")).toThrow("Choose a supported object type.");
expect(() => xuguListColumnNamesSql("APP", "SEQ", "SEQUENCE")).toThrow("Column grants are supported only for tables and views.");
});
it("filters ACL lookup to numeric principal IDs and provides a visibility fallback", () => {
const sql = xuguAclRowsSql(["42", "7", "42", "1); DROP USER X"]);
expect(sql).toContain("A.DB_ID = CURRENT_DB_ID");
expect(sql).toContain("A.GRANTEE_ID IN (42, 7)");
expect(sql).not.toContain("DROP USER");
expect(xuguAclRowsSql(["42"])).toContain("FROM DBA_ACLS A");
expect(xuguAclRowsSql(["42"])).toContain("A.OBJECT_ID = O.OBJ_ID AND A.OBJECT_TYPE = O.OBJ_TYPE AND A.DB_ID = O.DB_ID");
expect(xuguAclRowsSql(["42"])).toContain("A.OBJECT_ID < 0 OR A.OBJECT_TYPE = 4");
expect(xuguAclRowsSql(["42"])).toContain("S.SCHEMA_ID = CASE WHEN A.OBJECT_ID < 0 THEN -A.OBJECT_ID ELSE A.OBJECT_ID END AND A.DB_ID = S.DB_ID");
expect(xuguAclRowsSql(["42"])).toContain("WHEN SO.SCHEMA_NAME IS NOT NULL AND O.OBJ_NAME IS NOT NULL");
expect(xuguAclRowsSql(["42"])).not.toMatch(/\b(SHR|BIT_AND)\s*\(/i);
expect(xuguAclRowsFallbackSql(["42"])).toContain("FROM ALL_ACLS A");
expect(xuguAclRowsFallbackSql(["42"])).toContain("ALL_SCHEMAS");
});
it("resolves table and view column ACL targets in a separate optional catalog query", () => {
const sql = xuguAclColumnTargetsSql(["42", "7", "42", "1); DROP USER X"]);
expect(sql).toContain("A.GRANTEE_ID IN (42, 7)");
expect(sql).toContain("A.OBJECT_TYPE = 6");
expect(sql).toContain("T.TABLE_ID = SHR(A.OBJECT_ID, 10)");
expect(sql).toContain("C.COL_NO = BIT_AND(A.OBJECT_ID, 1023)");
expect(sql).toContain("V.VIEW_ID = SHR(A.OBJECT_ID, 10)");
expect(sql).toContain("VC.COL_NO = BIT_AND(A.OBJECT_ID, 1023)");
expect(sql).toContain("A.DB_ID = CURRENT_DB_ID");
expect(sql).not.toContain("DROP USER");
expect(xuguAclColumnTargetsSql(["42"], false)).toContain("FROM ALL_ACLS A");
expect(xuguAclColumnTargetsSql([])).toContain("WHERE 1 = 0");
const aclRows = [
{ grantorId: "1", granteeId: "42", objectId: "1076", objectType: 6, authority: "1", regrant: false, target: "Column object ID 1076", scope: "column" as const },
{ grantorId: "1", granteeId: "42", objectId: "2084", objectType: 28, authority: "2", regrant: false, target: "Column object ID 2084", scope: "column" as const },
{ grantorId: "1", granteeId: "42", objectId: "9999", objectType: 6, authority: "1", regrant: false, target: "Column object ID 9999", scope: "column" as const },
];
const targets = result(
["GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "TARGET_NAME"],
[
[42, 1076, 6, "APP_SCHEMA.ORDERS.ORDER_ID"],
[42, 2084, 28, "APP_SCHEMA.ORDER_VIEW.ORDER_ID"],
[42, 9999, 6, "Column object ID 9999"],
],
);
expect(xuguEnrichAclColumnTargets(aclRows, targets).map((row) => row.target)).toEqual(["APP_SCHEMA.ORDERS.ORDER_ID", "APP_SCHEMA.ORDER_VIEW.ORDER_ID", "Column object ID 9999"]);
});
it("parses user status and roles from database catalog result rows", () => {
const principals = parseXuguPrincipals(result(["USER_ID", "USER_NAME", "LOCKED", "EXPIRED", "IS_SYS", "UNTIL_TIME", "ALIAS"], [[42, "APP_USER", true, false, false, "2030-01-01", "Application account"]]), false);
expect(principals).toEqual([
{
id: "42",
name: "APP_USER",
isRole: false,
locked: true,
expired: false,
isSystem: false,
validUntil: "2030-01-01",
alias: "Application account",
},
]);
expect(parseXuguPrincipals(result(["USER_ID", "USER_NAME", "IS_SYS"], [[7, "APP_ROLE", false]]), true)[0]?.isRole).toBe(true);
expect(parseXuguMemberships(result(["USER_ID", "ROLE_ID"], [[42, 7]]))).toEqual([{ userId: "42", roleId: "7" }]);
});
it("walks nested role membership without looping on corrupt or cyclic catalog rows", () => {
expect(
xuguInheritedRoleIds("42", [
{ userId: "42", roleId: "7" },
{ userId: "7", roleId: "8" },
{ userId: "8", roleId: "7" },
{ userId: "8", roleId: "42" },
]),
).toEqual(expect.arrayContaining(["7", "8"]));
expect(xuguInheritedRoleIds("42", [{ userId: "42", roleId: "42" }])).toEqual([]);
});
it("decodes database, schema, object, and column authority masks", () => {
expect(decodeXuguAuthority(0x7fffff, 0, "database")).toEqual(["DBA"]);
expect(decodeXuguAuthority(0x80, 0, "database")).toEqual(["CREATE"]);
expect(decodeXuguAuthority(0x80, 1, "database")).toEqual(["CREATE"]);
expect(decodeXuguAuthority(0x80, 9, "database")).toEqual(["CREATE VIEW"]);
expect(decodeXuguAuthority(0x100, 9, "database")).toEqual(["CREATE ANY VIEW"]);
expect(decodeXuguAuthority(1 | 4, 5, "database")).toEqual(["SELECT ANY TABLE", "INSERT ANY TABLE"]);
expect(decodeXuguAuthority(1 | 4, 5, "schema")).toEqual(["SELECT ANY TABLE", "INSERT ANY TABLE"]);
expect(decodeXuguAuthority(1 | 4, 5, "object")).toEqual(["SELECT", "INSERT"]);
expect(decodeXuguAuthority(3, 6, "column")).toEqual(["SELECT", "UPDATE"]);
expect(decodeXuguAuthority("not-a-mask", 5, "object")).toEqual([]);
expect(xuguAclAuthorityLabels(4096, 5, "object", "Unmapped authority")).toEqual(["Unmapped authority (4096)"]);
});
it("maps ACL rows to targets and labels inherited role grants separately", () => {
const role: XuguPrincipal = { id: "7", name: "APP_READ_ROLE", isRole: true, locked: false, expired: false, isSystem: false };
const parsed = parseXuguAclRows(result(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "TARGET_NAME"], [[1, 7, 0, 5, 1, "F", "Current database"]]), [user, role], user.id);
expect(parsed[0]).toMatchObject({ target: "Current database", scope: "database", regrant: false, inheritedFrom: "APP_READ_ROLE" });
});
it("identifies schema grants encoded as negative schema IDs by the live Xugu catalog", () => {
const rows = result(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "TARGET_NAME"], [[1, 42, -129, 5, 1, "F", "DBX_PERMISSION_SCHEMA_260929"]]);
const grant = parseXuguAclRows(rows, [user], user.id)[0];
expect(grant).toMatchObject({ scope: "schema", target: "DBX_PERMISSION_SCHEMA_260929", objectId: "-129", objectType: 5 });
expect(decodeXuguAuthority(grant!.authority, grant!.objectType, grant!.scope)).toEqual(["SELECT ANY TABLE"]);
const missingTarget = result(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT"], [[1, 42, -129, 5, 1, "F"]]);
expect(parseXuguAclRows(missingTarget, [user], user.id)[0]).toMatchObject({ scope: "schema", target: "Schema ID 129" });
const typeFour = result(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT"], [[1, 42, 12, 4, 1, "F"]]);
expect(parseXuguAclRows(typeFour, [user], user.id)[0]).toMatchObject({ scope: "schema", target: "Schema ID 12" });
});
it("identifies instance-wide database lifecycle grants only in the system database", () => {
const rows = result(["GRANTOR_ID", "GRANTEE_ID", "OBJECT_ID", "OBJECT_TYPE", "AUTHORITY", "REGRANT", "TARGET_NAME"], [[1, 42, 0, 1, 0x100, "F", "Current database"]]);
const systemGrant = parseXuguAclRows(rows, [user], user.id, true)[0];
const databaseGrant = parseXuguAclRows(rows, [user], user.id, false)[0];
expect(systemGrant).toMatchObject({ scope: "system", target: "All databases" });
expect(decodeXuguAuthority(systemGrant!.authority, systemGrant!.objectType, systemGrant!.scope)).toEqual(["CREATE ANY DATABASE"]);
expect(databaseGrant).toMatchObject({ scope: "database", target: "Current database" });
});
it("builds scope-correct grant and revoke statements with identifier quoting", () => {
expect(xuguGrantSql({ principal: user, scope: "database", privileges: ["CREATE ANY TABLE"] })).toBe('GRANT CREATE ANY TABLE TO "APP_USER";');
expect(xuguGrantSql({ principal: user, scope: "schema", privileges: ["SELECT ANY TABLE"], schema: "APP SCHEMA" })).toBe('GRANT SELECT ANY TABLE IN SCHEMA "APP SCHEMA" TO "APP_USER";');
expect(xuguGrantSql({ principal: user, scope: "object", privileges: ["SELECT", "UPDATE"], schema: "APP", object: "ORDERS", objectType: "TABLE", grantOption: true })).toBe('GRANT SELECT, UPDATE ON TABLE "APP"."ORDERS" TO "APP_USER" WITH GRANT OPTION;');
expect(xuguGrantSql({ principal: user, scope: "object", privileges: ["EXECUTE"], schema: "APP", object: "DBX_PACKAGE", objectType: "PACKAGE" })).toBe('GRANT EXECUTE ON "APP"."DBX_PACKAGE" TO "APP_USER";');
expect(xuguGrantSql({ principal: user, scope: "column", privileges: ["SELECT"], schema: "APP", object: "ORDERS", column: "ORDER_ID", objectType: "TABLE" })).toBe('GRANT SELECT ("ORDER_ID") ON "APP"."ORDERS" TO "APP_USER";');
expect(xuguRevokeSql({ principal: user, scope: "object", privileges: ["SELECT"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toBe('REVOKE SELECT ON TABLE "APP"."ORDERS" FROM "APP_USER";');
expect(xuguRevokeSql({ principal: user, scope: "column", privileges: ["UPDATE"], schema: "APP", object: "ORDERS", column: "STATUS", objectType: "TABLE" })).toBe('REVOKE UPDATE ("STATUS") ON "APP"."ORDERS" FROM "APP_USER";');
expect(xuguGrantSql({ principal: user, scope: "role", role: "APP_READ_ROLE" })).toBe('GRANT ROLE "APP_READ_ROLE" TO "APP_USER";');
expect(xuguRevokeSql({ principal: user, scope: "role", role: "APP_READ_ROLE" })).toBe('REVOKE ROLE "APP_READ_ROLE" FROM "APP_USER";');
expect(() => xuguGrantSql({ principal: { ...user, isRole: true }, scope: "role", role: "APP_READ_ROLE" })).toThrow(/only be granted to users/);
expect(() => xuguRevokeSql({ principal: { ...user, isRole: true }, scope: "role", role: "APP_READ_ROLE" })).toThrow(/only be revoked from users/);
expect(xuguGrantSql({ principal: user, scope: "object", privileges: ["ALL PRIVILEGES"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toBe('GRANT ALL PRIVILEGES ON TABLE "APP"."ORDERS" TO "APP_USER";');
expect(xuguRevokeSql({ principal: user, scope: "object", privileges: ["ALL PRIVILEGES"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toBe('REVOKE ALL PRIVILEGES ON TABLE "APP"."ORDERS" FROM "APP_USER";');
});
it("limits direct-object grant choices to documented target forms", () => {
expect(XUGU_OBJECT_TYPES.map((item) => item.sql)).toEqual(["TABLE", "VIEW", "PROCEDURE", "SEQUENCE", "PACKAGE", "OBJECT"]);
expect(xuguPrivilegesForScope("object", "TABLE").map((item) => item.name)).toContain("TRIGGER");
expect(xuguPrivilegesForScope("database").map((item) => item.name)).toContain("CREATE ANY TRIGGER");
expect(xuguPrivilegesForScope("schema").map((item) => item.name)).toContain("CREATE ANY TRIGGER");
expect(xuguGrantSql({ principal: user, scope: "object", privileges: ["TRIGGER"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toBe('GRANT TRIGGER ON TABLE "APP"."ORDERS" TO "APP_USER";');
});
it("keeps generic job creation separate from CREATE ANY JOB", () => {
const jobPrivileges = xuguPrivilegesForScope("database").filter((privilege) => privilege.name.endsWith("JOB"));
expect(jobPrivileges).toEqual([
{ name: "CREATE ANY JOB", authorityType: 22, authorityBit: 0x100 },
{ name: "ALTER ANY JOB", authorityType: 22, authorityBit: 0x200 },
{ name: "DROP ANY JOB", authorityType: 22, authorityBit: 0x400 },
{ name: "CREATE JOB", authorityType: 0, authorityBit: 0x40000 },
]);
const allPrivileges = xuguPrivilegesForScope("database");
expect(new Set(allPrivileges.map((privilege) => privilege.name)).size).toBe(allPrivileges.length);
expect(xuguGrantSql({ principal: user, scope: "database", privileges: ["CREATE ANY JOB"] })).toBe('GRANT CREATE ANY JOB TO "APP_USER";');
expect(xuguGrantSql({ principal: user, scope: "database", privileges: ["CREATE JOB"] })).toBe('GRANT CREATE JOB TO "APP_USER";');
});
it("rejects unsupported scope/privilege combinations and database grant option", () => {
expect(xuguPrivilegesForScope("schema").some((item) => item.name === "CREATE TABLE")).toBe(false);
expect(xuguPrivilegesForScope("database").some((item) => item.name === "CREATE ANY DATABASE")).toBe(false);
expect(xuguPrivilegesForScope("system")).toEqual([]);
expect(xuguPrivilegesForScope("object", "TABLE").find((item) => item.name === "ALL PRIVILEGES")?.authorityBit).toBe(0x7df);
expect(xuguPrivilegesForScope("object", "PROCEDURE").find((item) => item.name === "ALL PRIVILEGES")?.authorityBit).toBe(0x1a0);
expect(xuguPrivilegesForScope("object", "SEQUENCE").find((item) => item.name === "ALL PRIVILEGES")?.authorityBit).toBe(0x183);
expect(xuguPrivilegesForScope("system", undefined, true).map((item) => item.name)).toEqual(["CREATE ANY DATABASE", "ALTER ANY DATABASE", "DROP ANY DATABASE"]);
expect(xuguGrantSql({ principal: user, scope: "system", privileges: ["CREATE ANY DATABASE"], systemDatabase: true })).toBe('GRANT CREATE ANY DATABASE TO "APP_USER";');
expect(() => xuguGrantSql({ principal: user, scope: "system", privileges: ["CREATE ANY DATABASE"] })).toThrow("System database privileges can only be managed from the SYSTEM database.");
expect(xuguRevokeSql({ principal: user, scope: "system", privileges: ["DROP ANY DATABASE"], systemDatabase: true })).toBe('REVOKE DROP ANY DATABASE FROM "APP_USER";');
expect(() => xuguRevokeSql({ principal: user, scope: "system", privileges: ["DROP ANY DATABASE"] })).toThrow("System database privileges can only be managed from the SYSTEM database.");
expect(() => xuguGrantSql({ principal: user, scope: "database", privileges: ["DROP USER"] })).toThrow("One or more privileges are not valid for this scope.");
expect(() => xuguGrantSql({ principal: user, scope: "database", privileges: ["CREATE ANY TABLE"], grantOption: true })).toThrow("WITH GRANT OPTION is supported only for object-level privileges.");
expect(() => xuguGrantSql({ principal: user, scope: "schema", privileges: ["SELECT ANY TABLE"], schema: "APP", grantOption: true })).toThrow("WITH GRANT OPTION is supported only for object-level privileges.");
expect(() => xuguGrantSql({ principal: user, scope: "column", privileges: ["SELECT"], schema: "APP", object: "ORDERS", column: "ID", objectType: "TABLE", grantOption: true })).toThrow(/object-level/);
expect(() => xuguGrantSql({ principal: user, scope: "column", privileges: ["SELECT"], schema: "APP", object: "ORDERS", column: "ID", objectType: "PROCEDURE" })).toThrow(/tables and views/);
expect(() => xuguRevokeSql({ principal: user, scope: "column", privileges: ["SELECT"], schema: "APP", object: "ORDERS", column: "ID", objectType: "PROCEDURE" })).toThrow(/tables and views/);
expect(() => xuguRevokeSql({ principal: user, scope: "column", privileges: ["SELECT"], schema: "APP", object: "ORDERS", column: "ID", objectType: "TABLE", revokeGrantOptionOnly: true })).toThrow(/object-level/);
expect(() => xuguGrantSql({ principal: user, scope: "object", privileges: ["ALL PRIVILEGES", "SELECT"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toThrow(/cannot be combined/);
expect(() => xuguRevokeSql({ principal: user, scope: "object", privileges: ["ALL PRIVILEGES", "SELECT"], schema: "APP", object: "ORDERS", objectType: "TABLE" })).toThrow(/cannot be combined/);
});
it("builds account lifecycle SQL and blocks built-in/system principal mutations", () => {
expect(xuguCreatePrincipalSql("APP USER", false, "secret")).toBe("CREATE USER \"APP USER\" IDENTIFIED BY 'secret';");
expect(
xuguCreatePrincipalSql("APP USER", false, "p'ass", {
defaultRoles: ["APP_READ_ROLE", "app_read_role", "APP_WRITE_ROLE; DROP USER X"],
validUntil: "2035-06-07T08:09",
locked: true,
passwordExpired: true,
}),
).toBe("CREATE USER \"APP USER\" IDENTIFIED BY 'p''ass'\n DEFAULT ROLE \"APP_READ_ROLE\", \"APP_WRITE_ROLE; DROP USER X\"\n VALID UNTIL '2035-06-07 08:09'\n ACCOUNT LOCK\n PASSWORD EXPIRE;");
expect(xuguCreatePrincipalSql("APP ROLE", true)).toBe('CREATE ROLE "APP ROLE";');
expect(() => xuguCreatePrincipalSql("APP USER", false, "secret", { validUntil: "2035-02-31" })).toThrow("Enter a valid date or date and time.");
expect(xuguAlterAccountSql(user, { validUntil: "2035-06-07T08:09:10", passwordExpired: true })).toBe("ALTER USER \"APP_USER\"\n VALID UNTIL '2035-06-07 08:09:10'\n PASSWORD EXPIRE;");
expect(() => xuguAlterAccountSql(user, {})).toThrow("Set a validity date or mark the password as expired.");
expect(() => xuguAlterAccountSql({ ...user, isRole: true }, { validUntil: "2035-06-07" })).toThrow("Only non-system users can have account settings changed here.");
expect(() => xuguAlterAccountSql({ ...user, isSystem: true }, { validUntil: "2035-06-07" })).toThrow("Only non-system users can have account settings changed here.");
expect(xuguAlterPasswordSql(user, "next'password")).toBe("ALTER USER \"APP_USER\" IDENTIFIED BY 'next''password';");
expect(xuguAlterLockSql(user, true)).toBe('ALTER USER "APP_USER" ACCOUNT LOCK;');
expect(xuguDropPrincipalSql(user)).toBe('DROP USER "APP_USER" RESTRICT;');
expect(() => xuguDropPrincipalSql({ ...user, isSystem: true })).toThrow("Built-in or system principals cannot be dropped from this screen.");
expect(() => xuguDropPrincipalSql({ ...user, isRole: true, name: "PUBLIC" })).toThrow("Built-in or system principals cannot be dropped from this screen.");
expect(() => xuguAlterLockSql({ ...user, name: "SYSDBA" }, false)).toThrow("Only non-system users can be locked or unlocked here.");
expect(() => xuguAlterPasswordSql({ ...user, name: "SYSTEM" }, "x")).toThrow("Password changes are only allowed for non-system users.");
expect(() => xuguAlterLockSql({ ...user, isSystem: true }, false)).toThrow("Only non-system users can be locked or unlocked here.");
expect(() => xuguAlterPasswordSql({ ...user, isRole: true }, "x")).toThrow("Password changes are only allowed for non-system users.");
});
it("blocks direct grant changes to built-in principals while allowing ordinary principals", () => {
const systemRole = { ...user, name: "DB_ADMIN", isRole: true, isSystem: true };
expect(() => xuguGrantSql({ principal: systemRole, scope: "database", privileges: ["CREATE ANY TABLE"] })).toThrow("Built-in or system principals cannot be modified from this screen.");
expect(() => xuguRevokeSql({ principal: systemRole, scope: "database", privileges: ["CREATE ANY TABLE"] })).toThrow("Built-in or system principals cannot be modified from this screen.");
expect(xuguGrantSql({ principal: user, scope: "database", privileges: ["CREATE ANY TABLE"] })).toBe('GRANT CREATE ANY TABLE TO "APP_USER";');
});
});
@@ -0,0 +1,684 @@
import type { QueryResult } from "@/types/database";
export type XuguPrivilegeScope = "system" | "database" | "schema" | "object" | "column" | "role" | "admin";
export type XuguAdminAuthority = "DBA" | "AUDITOR" | "SSO";
export interface XuguPrincipal {
id: string;
name: string;
isRole: boolean;
locked: boolean;
expired: boolean;
isSystem: boolean;
validUntil?: string;
alias?: string;
}
export interface XuguAclRow {
grantorId: string;
granteeId: string;
objectId: string;
objectType: number;
authority: string;
regrant: boolean;
target: string;
scope: "system" | "database" | "schema" | "object" | "column";
inheritedFrom?: string;
}
export interface XuguPrivilege {
name: string;
authorityType: number;
authorityBit: number;
}
export interface XuguGrantInput {
principal: XuguPrincipal;
scope: XuguPrivilegeScope;
privileges?: string[];
schema?: string;
objectType?: string;
object?: string;
column?: string;
role?: string;
adminAuthority?: XuguAdminAuthority;
grantOption?: boolean;
revokeGrantOptionOnly?: boolean;
systemDatabase?: boolean;
}
export interface XuguCreateUserOptions {
defaultRoles?: string[];
validUntil?: string;
locked?: boolean;
passwordExpired?: boolean;
}
export interface XuguAlterAccountOptions {
validUntil?: string;
passwordExpired?: boolean;
}
const DB_ACL = {
READ_ANY: 0x1,
UPDATE_ANY: 0x2,
INSERT_ANY: 0x4,
DELETE_ANY: 0x8,
REF_ANY: 0x10,
EXECUTE_ANY: 0x20,
INDEX_ANY: 0x40,
CREATE: 0x80,
CREATE_ANY: 0x100,
ALTER_ANY: 0x200,
DROP_ANY: 0x400,
BACKUP_ANY: 0x800,
RESTORE_ANY: 0x1000,
VACUUM_ANY: 0x2000,
REPLICATION_ANY: 0x4000,
REFRESH_ANY: 0x8000,
GRANT_ANY: 0x10000,
ENCRYPT_ANY: 0x20000,
CREATE_JOB: 0x40000,
TRACE: 0x80000,
DBA: 0x7fffff,
DBO: 0xffffff,
AUDITOR: 0x10000000,
AUDIT_ADMIN: 0x30000000,
SSO: 0x40000000,
SS_ADMIN: 0xc0000000,
} as const;
const OBJECT_ACL = {
READ: 0x1,
UPDATE: 0x2,
INSERT: 0x4,
DELETE: 0x8,
REFERENCES: 0x10,
EXECUTE: 0x20,
INDEX: 0x40,
ALTER: 0x80,
DROP: 0x100,
TRIGGER: 0x200,
VACUUM: 0x400,
} as const;
export const XUGU_OBJECT_TYPES = [
{ label: "Table", sql: "TABLE", type: 5 },
{ label: "View", sql: "VIEW", type: 9 },
{ label: "Procedure / Function", sql: "PROCEDURE", type: 7 },
{ label: "Sequence", sql: "SEQUENCE", type: 8 },
{ label: "Package", sql: "PACKAGE", type: 18 },
{ label: "User-defined type", sql: "OBJECT", type: 19 },
] as const;
const DATABASE_PRIVILEGES: XuguPrivilege[] = [
{ name: "CREATE ANY SCHEMA", authorityType: 4, authorityBit: DB_ACL.CREATE_ANY },
{ name: "ALTER ANY SCHEMA", authorityType: 4, authorityBit: DB_ACL.ALTER_ANY },
{ name: "DROP ANY SCHEMA", authorityType: 4, authorityBit: DB_ACL.DROP_ANY },
...(
[
[
"TABLE",
5,
["CREATE", DB_ACL.CREATE],
["CREATE ANY", DB_ACL.CREATE_ANY],
["ALTER ANY", DB_ACL.ALTER_ANY],
["DROP ANY", DB_ACL.DROP_ANY],
["SELECT ANY", DB_ACL.READ_ANY],
["INSERT ANY", DB_ACL.INSERT_ANY],
["UPDATE ANY", DB_ACL.UPDATE_ANY],
["DELETE ANY", DB_ACL.DELETE_ANY],
["REFERENCES ANY", DB_ACL.REF_ANY],
],
["VIEW", 9, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY], ["SELECT ANY", DB_ACL.READ_ANY], ["INSERT ANY", DB_ACL.INSERT_ANY], ["UPDATE ANY", DB_ACL.UPDATE_ANY], ["DELETE ANY", DB_ACL.DELETE_ANY]],
["SEQUENCE", 8, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY], ["SELECT ANY", DB_ACL.READ_ANY], ["UPDATE ANY", DB_ACL.UPDATE_ANY], ["REFERENCES ANY", DB_ACL.REF_ANY]],
["PACKAGE", 18, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY], ["EXECUTE ANY", DB_ACL.EXECUTE_ANY]],
["PROCEDURE", 7, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY], ["EXECUTE ANY", DB_ACL.EXECUTE_ANY]],
["TRIGGER", 11, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["INDEX", 10, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["SYNONYM", 15, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["DATABASE LINK", 12, ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["USER", 16, ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["ROLE", 17, ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["JOB", 22, ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
["OBJECT", 19, ["CREATE", DB_ACL.CREATE], ["CREATE ANY", DB_ACL.CREATE_ANY], ["ALTER ANY", DB_ACL.ALTER_ANY], ["DROP ANY", DB_ACL.DROP_ANY]],
] as Array<[string, number, ...Array<[string, number]>]>
).flatMap(([type, objectType, ...items]) => items.map(([verb, authorityBit]) => ({ name: `${verb} ${type}`, authorityType: objectType, authorityBit }))),
...(
[
["BACKUP", DB_ACL.BACKUP_ANY],
["RESTORE", DB_ACL.RESTORE_ANY],
["VACUUM ANY", DB_ACL.VACUUM_ANY],
["REPLICATION ANY", DB_ACL.REPLICATION_ANY],
["REFRESH ANY", DB_ACL.REFRESH_ANY],
["GRANT ANY", DB_ACL.GRANT_ANY],
["ENCRYPT ANY", DB_ACL.ENCRYPT_ANY],
// CREATE_JOB is the database-wide job creation bit without an object
// type. Keep it distinct from CREATE ANY JOB (object type JOB), which
// is backed by DB_ACL.CREATE_ANY and authorityType 22 above.
["CREATE JOB", DB_ACL.CREATE_JOB],
["TRACE", DB_ACL.TRACE],
] as Array<[string, number]>
).map(([name, authorityBit]) => ({ name, authorityType: 0, authorityBit })),
];
// Database lifecycle privileges are instance-wide and are only actionable
// from the SYSTEM database. Keep them out of the regular database grant set.
const SYSTEM_DATABASE_PRIVILEGES: XuguPrivilege[] = [
{ name: "CREATE ANY DATABASE", authorityType: 1, authorityBit: DB_ACL.CREATE_ANY },
{ name: "ALTER ANY DATABASE", authorityType: 1, authorityBit: DB_ACL.ALTER_ANY },
{ name: "DROP ANY DATABASE", authorityType: 1, authorityBit: DB_ACL.DROP_ANY },
];
// A schema ACL targets the objects inside one schema, so only the ANY-level
// object privileges are valid here (never database-wide or own-schema CREATE).
const SCHEMA_PRIVILEGE_TYPES = new Set([5, 9, 8, 18, 7, 11, 10, 15, 19]);
const SCHEMA_PRIVILEGES = DATABASE_PRIVILEGES.filter((privilege) => SCHEMA_PRIVILEGE_TYPES.has(privilege.authorityType) && privilege.name.includes(" ANY "));
const OBJECT_PRIVILEGES: Record<number, Array<[string, number]>> = {
5: [
["SELECT", OBJECT_ACL.READ],
["INSERT", OBJECT_ACL.INSERT],
["UPDATE", OBJECT_ACL.UPDATE],
["DELETE", OBJECT_ACL.DELETE],
["REFERENCES", OBJECT_ACL.REFERENCES],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
["INDEX", OBJECT_ACL.INDEX],
["TRIGGER", OBJECT_ACL.TRIGGER],
["VACUUM", OBJECT_ACL.VACUUM],
],
6: [
["SELECT", OBJECT_ACL.READ],
["UPDATE", OBJECT_ACL.UPDATE],
],
7: [
["EXECUTE", OBJECT_ACL.EXECUTE],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
8: [
["SELECT", OBJECT_ACL.READ],
["UPDATE", OBJECT_ACL.UPDATE],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
9: [
["SELECT", OBJECT_ACL.READ],
["INSERT", OBJECT_ACL.INSERT],
["UPDATE", OBJECT_ACL.UPDATE],
["DELETE", OBJECT_ACL.DELETE],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
11: [
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
18: [
["EXECUTE", OBJECT_ACL.EXECUTE],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
19: [
["EXECUTE", OBJECT_ACL.EXECUTE],
["ALTER", OBJECT_ACL.ALTER],
["DROP", OBJECT_ACL.DROP],
],
28: [
["SELECT", OBJECT_ACL.READ],
["UPDATE", OBJECT_ACL.UPDATE],
],
};
const OBJECT_TYPE_LABELS = new Map<number, string>([
[1, "DATABASE"],
[4, "SCHEMA"],
[5, "TABLE"],
[6, "COLUMN"],
[7, "PROCEDURE"],
[8, "SEQUENCE"],
[9, "VIEW"],
[10, "INDEX"],
[11, "TRIGGER"],
[12, "DATABASE LINK"],
[13, "REPLICATION"],
[15, "SYNONYM"],
[16, "USER"],
[17, "ROLE"],
[18, "PACKAGE"],
[19, "OBJECT"],
[22, "JOB"],
[28, "VIEW COLUMN"],
[29, "DOMAIN"],
]);
export function xuguQuoteIdentifier(value: string): string {
const normalized = value.trim();
if (!normalized || [...normalized].some((character) => character.charCodeAt(0) < 32)) throw new Error("An identifier is required.");
return `"${normalized.replace(/"/g, '""')}"`;
}
export function xuguQuoteLiteral(value: string): string {
if (value.includes("\0")) throw new Error("Invalid string value.");
return `'${value.replace(/'/g, "''")}'`;
}
export function xuguDatabaseOptions(names: string[], currentDatabase = ""): string[] {
const options = [...new Set(names.map((name) => name.trim()).filter(Boolean))];
const current = currentDatabase.trim();
if (current && !options.includes(current)) options.push(current);
return options.sort((left, right) => left.localeCompare(right, undefined, { numeric: true, sensitivity: "base" }));
}
export function xuguListUsersSql(): string {
return "SELECT USER_ID, USER_NAME, LOCKED, EXPIRED, IS_SYS, UNTIL_TIME, ALIAS FROM DBA_USERS WHERE DB_ID = CURRENT_DB_ID AND IS_ROLE = FALSE ORDER BY USER_NAME;";
}
export function xuguListRolesSql(): string {
return "SELECT USER_ID, USER_NAME, IS_SYS FROM DBA_ROLES WHERE DB_ID = CURRENT_DB_ID AND IS_ROLE = TRUE ORDER BY USER_NAME;";
}
export function xuguFallbackListRolesSql(): string {
return "SELECT USER_ID, USER_NAME, IS_SYS FROM ALL_USERS WHERE DB_ID = CURRENT_DB_ID AND IS_ROLE = TRUE ORDER BY USER_NAME;";
}
export function xuguListSchemasSql(useDbaCatalog = true): string {
const catalog = useDbaCatalog ? "DBA_SCHEMAS" : "ALL_SCHEMAS";
return `SELECT SCHEMA_ID, SCHEMA_NAME FROM ${catalog} WHERE DB_ID = CURRENT_DB_ID ORDER BY SCHEMA_NAME;`;
}
export function xuguListObjectNamesSql(schema: string, objectType: string, useDbaCatalog = true): string {
const type = XUGU_OBJECT_TYPES.find((item) => item.sql === objectType);
if (!type) throw new Error("Choose a supported object type.");
const catalog = useDbaCatalog ? "DBA" : "ALL";
return `SELECT O.OBJ_NAME FROM ${catalog}_OBJECTS O JOIN ${catalog}_SCHEMAS S ON O.SCHEMA_ID = S.SCHEMA_ID AND O.DB_ID = S.DB_ID WHERE O.DB_ID = CURRENT_DB_ID AND S.DB_ID = CURRENT_DB_ID AND S.SCHEMA_NAME = ${xuguQuoteLiteral(schema)} AND O.OBJ_TYPE = ${type.type} ORDER BY O.OBJ_NAME;`;
}
export function xuguListColumnNamesSql(schema: string, object: string, objectType: string, useDbaCatalog = true): string {
const schemaLiteral = xuguQuoteLiteral(schema);
const objectLiteral = xuguQuoteLiteral(object);
const catalog = useDbaCatalog ? "DBA" : "ALL";
if (objectType === "VIEW") {
return `SELECT C.COL_NAME FROM ${catalog}_VIEW_COLUMNS C JOIN ${catalog}_VIEWS V ON C.VIEW_ID = V.VIEW_ID AND C.DB_ID = V.DB_ID JOIN ${catalog}_SCHEMAS S ON V.SCHEMA_ID = S.SCHEMA_ID AND V.DB_ID = S.DB_ID WHERE C.DB_ID = CURRENT_DB_ID AND S.DB_ID = CURRENT_DB_ID AND S.SCHEMA_NAME = ${schemaLiteral} AND V.VIEW_NAME = ${objectLiteral} ORDER BY C.COL_NO;`;
}
if (objectType !== "TABLE") throw new Error("Column grants are supported only for tables and views.");
return `SELECT C.COL_NAME FROM ${catalog}_COLUMNS C JOIN ${catalog}_TABLES T ON C.TABLE_ID = T.TABLE_ID AND C.DB_ID = T.DB_ID JOIN ${catalog}_SCHEMAS S ON T.SCHEMA_ID = S.SCHEMA_ID AND T.DB_ID = S.DB_ID WHERE C.DB_ID = CURRENT_DB_ID AND S.DB_ID = CURRENT_DB_ID AND S.SCHEMA_NAME = ${schemaLiteral} AND T.TABLE_NAME = ${objectLiteral} ORDER BY C.COL_NO;`;
}
export function xuguFallbackListUsersSql(): string {
return "SELECT USER_ID, USER_NAME, LOCKED, EXPIRED, IS_SYS, UNTIL_TIME, ALIAS FROM ALL_USERS WHERE DB_ID = CURRENT_DB_ID AND IS_ROLE = FALSE ORDER BY USER_NAME;";
}
export function xuguRoleMembershipsSql(): string {
return "SELECT USER_ID, ROLE_ID FROM DBA_ROLE_MEMBERS WHERE DB_ID = CURRENT_DB_ID ORDER BY USER_ID, ROLE_ID;";
}
export function xuguRoleMembershipsFallbackSql(): string {
return "SELECT USER_ID, ROLE_ID FROM ALL_ROLE_MEMBERS WHERE DB_ID = CURRENT_DB_ID ORDER BY USER_ID, ROLE_ID;";
}
export function xuguAclRowsSql(principalIds: string[], useDbaCatalog = true): string {
const catalog = useDbaCatalog ? "DBA" : "ALL";
const ids = [...new Set(principalIds.map((id) => id.trim()).filter((id) => /^\d+$/.test(id)))];
if (ids.length === 0) return `SELECT GRANTOR_ID, GRANTEE_ID, OBJECT_ID, OBJECT_TYPE, AUTHORITY, REGRANT, 'database' AS SCOPE, 'Current database' AS TARGET_NAME FROM ${catalog}_ACLS WHERE 1 = 0;`;
return `SELECT A.GRANTOR_ID, A.GRANTEE_ID, A.OBJECT_ID, A.OBJECT_TYPE, A.AUTHORITY, A.REGRANT,
CASE WHEN A.OBJECT_ID = 0 THEN 'database' WHEN A.OBJECT_ID < 0 OR A.OBJECT_TYPE = 4 THEN 'schema' WHEN A.OBJECT_TYPE IN (6, 28) THEN 'column' ELSE 'object' END AS SCOPE,
CASE WHEN A.OBJECT_ID = 0 THEN 'Current database'
WHEN A.OBJECT_ID < 0 OR A.OBJECT_TYPE = 4 THEN COALESCE(S.SCHEMA_NAME, 'Schema ID ' || CASE WHEN A.OBJECT_ID < 0 THEN -A.OBJECT_ID ELSE A.OBJECT_ID END)
WHEN A.OBJECT_TYPE IN (6, 28) THEN 'Column object ID ' || A.OBJECT_ID
WHEN SO.SCHEMA_NAME IS NOT NULL AND O.OBJ_NAME IS NOT NULL THEN SO.SCHEMA_NAME || '.' || O.OBJ_NAME
ELSE 'Object ID ' || A.OBJECT_ID END AS TARGET_NAME
FROM ${catalog}_ACLS A
LEFT JOIN ${catalog}_SCHEMAS S ON (A.OBJECT_ID < 0 OR A.OBJECT_TYPE = 4) AND S.SCHEMA_ID = CASE WHEN A.OBJECT_ID < 0 THEN -A.OBJECT_ID ELSE A.OBJECT_ID END AND A.DB_ID = S.DB_ID
LEFT JOIN ${catalog}_OBJECTS O ON A.OBJECT_ID > 0 AND A.OBJECT_TYPE NOT IN (4, 6, 28) AND A.OBJECT_ID = O.OBJ_ID AND A.OBJECT_TYPE = O.OBJ_TYPE AND A.DB_ID = O.DB_ID
LEFT JOIN ${catalog}_SCHEMAS SO ON O.SCHEMA_ID = SO.SCHEMA_ID AND O.DB_ID = SO.DB_ID
WHERE A.DB_ID = CURRENT_DB_ID AND A.GRANTEE_ID IN (${ids.join(", ")})
ORDER BY A.GRANTEE_ID, A.OBJECT_ID, A.OBJECT_TYPE;`;
}
export function xuguAclRowsFallbackSql(principalIds: string[]): string {
return xuguAclRowsSql(principalIds, false);
}
/**
* Column ACL object IDs pack the parent object ID and column ordinal. Resolve
* them separately from the base ACL query so an unsupported catalog/function
* on an older server does not hide otherwise readable grants.
*/
export function xuguAclColumnTargetsSql(principalIds: string[], useDbaCatalog = true): string {
const catalog = useDbaCatalog ? "DBA" : "ALL";
const ids = [...new Set(principalIds.map((id) => id.trim()).filter((id) => /^\d+$/.test(id)))];
if (ids.length === 0) {
return `SELECT GRANTEE_ID, OBJECT_ID, OBJECT_TYPE, '' AS TARGET_NAME FROM ${catalog}_ACLS WHERE 1 = 0;`;
}
return `SELECT A.GRANTEE_ID, A.OBJECT_ID, A.OBJECT_TYPE,
CASE WHEN A.OBJECT_TYPE = 6 THEN COALESCE(TS.SCHEMA_NAME || '.' || T.TABLE_NAME || '.' || C.COL_NAME, 'Column object ID ' || A.OBJECT_ID)
WHEN A.OBJECT_TYPE = 28 THEN COALESCE(VS.SCHEMA_NAME || '.' || V.VIEW_NAME || '.' || VC.COL_NAME, 'Column object ID ' || A.OBJECT_ID)
ELSE 'Column object ID ' || A.OBJECT_ID END AS TARGET_NAME
FROM ${catalog}_ACLS A
LEFT JOIN ${catalog}_TABLES T ON A.OBJECT_TYPE = 6 AND A.OBJECT_ID > 0 AND T.TABLE_ID = SHR(A.OBJECT_ID, 10) AND T.DB_ID = A.DB_ID
LEFT JOIN ${catalog}_COLUMNS C ON A.OBJECT_TYPE = 6 AND C.TABLE_ID = T.TABLE_ID AND C.DB_ID = T.DB_ID AND C.COL_NO = BIT_AND(A.OBJECT_ID, 1023)
LEFT JOIN ${catalog}_SCHEMAS TS ON T.SCHEMA_ID = TS.SCHEMA_ID AND T.DB_ID = TS.DB_ID
LEFT JOIN ${catalog}_VIEWS V ON A.OBJECT_TYPE = 28 AND A.OBJECT_ID > 0 AND V.VIEW_ID = SHR(A.OBJECT_ID, 10) AND V.DB_ID = A.DB_ID
LEFT JOIN ${catalog}_VIEW_COLUMNS VC ON A.OBJECT_TYPE = 28 AND VC.VIEW_ID = V.VIEW_ID AND VC.DB_ID = V.DB_ID AND VC.COL_NO = BIT_AND(A.OBJECT_ID, 1023)
LEFT JOIN ${catalog}_SCHEMAS VS ON V.SCHEMA_ID = VS.SCHEMA_ID AND V.DB_ID = VS.DB_ID
WHERE A.DB_ID = CURRENT_DB_ID AND A.GRANTEE_ID IN (${ids.join(", ")}) AND A.OBJECT_TYPE IN (6, 28) AND A.OBJECT_ID > 0
ORDER BY A.GRANTEE_ID, A.OBJECT_ID, A.OBJECT_TYPE;`;
}
export function xuguEnrichAclColumnTargets(aclRows: XuguAclRow[], result: QueryResult): XuguAclRow[] {
const index = findColumns(result.columns);
const granteeIndex = index("GRANTEE_ID");
const objectIndex = index("OBJECT_ID");
const typeIndex = index("OBJECT_TYPE");
const targetIndex = index("TARGET_NAME");
if ([granteeIndex, objectIndex, typeIndex, targetIndex].some((column) => column < 0)) return aclRows;
const targets = new Map<string, string>();
for (const row of result.rows) {
const granteeId = String(row[granteeIndex] ?? "");
const objectId = String(row[objectIndex] ?? "");
const objectType = String(row[typeIndex] ?? "");
const target = String(row[targetIndex] ?? "").trim();
if (granteeId && objectId && (objectType === "6" || objectType === "28") && target && !/^Column object ID\s/i.test(target)) {
targets.set(`${granteeId}:${objectId}:${objectType}`, target);
}
}
return aclRows.map((row) => ({ ...row, target: targets.get(`${row.granteeId}:${row.objectId}:${row.objectType}`) ?? row.target }));
}
export function parseXuguPrincipals(result: QueryResult, isRole: boolean): XuguPrincipal[] {
const index = findColumns(result.columns);
const id = index("USER_ID");
const name = index("USER_NAME");
if (id < 0 || name < 0) return [];
return result.rows.flatMap((row) => {
const principalName = String(row[name] ?? "");
if (!principalName) return [];
const value = (column: string) => (index(column) < 0 ? undefined : row[index(column)]);
return [
{
id: String(row[id] ?? ""),
name: principalName,
isRole,
locked: !isRole && asBoolean(value("LOCKED")),
expired: !isRole && asBoolean(value("EXPIRED")),
isSystem: asBoolean(value("IS_SYS")),
validUntil: optionalString(value("UNTIL_TIME")),
alias: optionalString(value("ALIAS")),
},
];
});
}
export function parseXuguMemberships(result: QueryResult): Array<{ userId: string; roleId: string }> {
const index = findColumns(result.columns);
const userId = index("USER_ID");
const roleId = index("ROLE_ID");
if (userId < 0 || roleId < 0) return [];
return result.rows.map((row) => ({ userId: String(row[userId] ?? ""), roleId: String(row[roleId] ?? "") }));
}
export function parseXuguAclRows(result: QueryResult, principals: XuguPrincipal[], selectedId: string, systemDatabase = false): XuguAclRow[] {
const index = findColumns(result.columns);
const principalById = new Map(principals.map((principal) => [principal.id, principal]));
const field = (row: unknown[], name: string, fallback = "") => (index(name) < 0 ? fallback : String(row[index(name)] ?? fallback));
return result.rows.flatMap((row) => {
const granteeId = field(row, "GRANTEE_ID");
const objectId = field(row, "OBJECT_ID");
const objectType = Number(field(row, "OBJECT_TYPE", "0"));
const authority = field(row, "AUTHORITY", "0");
const regrant = asBoolean(index("REGRANT") < 0 ? "0" : row[index("REGRANT")]);
const targetPrincipal = principalById.get(granteeId);
const systemWideDatabasePrivilege = systemDatabase && objectId === "0" && objectType === 1;
const scope = objectId === "0" ? (systemWideDatabasePrivilege ? "system" : "database") : objectId.startsWith("-") || objectType === 4 ? "schema" : objectType === 6 || objectType === 28 ? "column" : "object";
const schemaId = objectId.startsWith("-") ? objectId.slice(1) : objectId;
const target =
scope === "system"
? "All databases"
: field(row, "TARGET_NAME", scope === "database" ? "Current database" : scope === "schema" ? `Schema ID ${schemaId}` : scope === "object" ? `${OBJECT_TYPE_LABELS.get(objectType) ?? `Object type ${objectType}`} ID ${objectId}` : `Column object ID ${objectId}`);
return [{ grantorId: field(row, "GRANTOR_ID"), granteeId, objectId, objectType, authority, regrant, target, scope, inheritedFrom: granteeId !== selectedId ? targetPrincipal?.name : undefined }];
});
}
export function xuguInheritedRoleIds(principalId: string, memberships: Array<{ userId: string; roleId: string }>): string[] {
const byMember = new Map<string, string[]>();
for (const membership of memberships) {
const current = byMember.get(membership.userId) ?? [];
current.push(membership.roleId);
byMember.set(membership.userId, current);
}
const found = new Set<string>();
const pending = [...(byMember.get(principalId) ?? [])];
while (pending.length > 0) {
const roleId = pending.pop()!;
if (found.has(roleId) || roleId === principalId) continue;
found.add(roleId);
pending.push(...(byMember.get(roleId) ?? []));
}
return [...found];
}
export function xuguPrivilegesForScope(scope: XuguPrivilegeScope, objectType?: string, systemDatabase = false): XuguPrivilege[] {
if (scope === "system") return systemDatabase ? SYSTEM_DATABASE_PRIVILEGES : [];
if (scope === "database") return DATABASE_PRIVILEGES;
if (scope === "schema") return SCHEMA_PRIVILEGES;
if (scope === "object" || scope === "column") {
const type = scope === "column" ? 6 : XUGU_OBJECT_TYPES.find((item) => item.sql === objectType)?.type;
const privileges = (type ? OBJECT_PRIVILEGES[type] : undefined)?.map(([name, authorityBit]) => ({ name, authorityType: type!, authorityBit })) ?? [];
if (scope !== "object" || privileges.length === 0) return privileges;
const allPrivilegesMask = privileges.reduce((mask, privilege) => mask | privilege.authorityBit, 0);
return [...privileges, { name: "ALL PRIVILEGES", authorityType: type!, authorityBit: allPrivilegesMask }];
}
return [];
}
export function decodeXuguAuthority(authority: string | number, objectType: number, scope: XuguAclRow["scope"]): string[] {
let bits: bigint;
try {
bits = BigInt(authority);
} catch {
return [];
}
if (scope === "system" || scope === "database" || scope === "schema") {
bits = BigInt.asUintN(32, bits);
const labels = new Set<string>();
if (objectType === 0) {
if ((bits & BigInt(DB_ACL.DBO)) === BigInt(DB_ACL.DBO)) return ["DBO"];
if ((bits & BigInt(DB_ACL.DBA)) === BigInt(DB_ACL.DBA)) return ["DBA"];
if ((bits & BigInt(DB_ACL.AUDIT_ADMIN)) === BigInt(DB_ACL.AUDIT_ADMIN)) return ["AUDIT_ADMIN"];
if ((bits & BigInt(DB_ACL.AUDITOR)) === BigInt(DB_ACL.AUDITOR)) return ["AUDITOR"];
if ((bits & BigInt(DB_ACL.SS_ADMIN)) === BigInt(DB_ACL.SS_ADMIN)) return ["SS_ADMIN"];
if ((bits & BigInt(DB_ACL.SSO)) === BigInt(DB_ACL.SSO)) return ["SSO"];
}
// ACL_CREATE (0x80) can be stored against either the generic database
// ACL type (0) or the database object type (1). It permits creating
// objects in the principal's own schema and is distinct from the
// typed CREATE ANY privileges below.
if ((objectType === 0 || objectType === 1) && (bits & BigInt(DB_ACL.CREATE)) === BigInt(DB_ACL.CREATE)) labels.add("CREATE");
for (const privilege of [...SYSTEM_DATABASE_PRIVILEGES, ...DATABASE_PRIVILEGES]) {
if (privilege.authorityType === objectType && (bits & BigInt(privilege.authorityBit)) === BigInt(privilege.authorityBit)) labels.add(privilege.name);
}
return [...labels];
}
const privileges = OBJECT_PRIVILEGES[objectType] ?? [];
return privileges.filter(([, mask]) => (bits & BigInt(mask)) === BigInt(mask)).map(([name]) => name);
}
export function xuguAclAuthorityLabels(authority: string | number, objectType: number, scope: XuguAclRow["scope"], unmappedLabel: string): string[] {
const labels = decodeXuguAuthority(authority, objectType, scope);
return labels.length > 0 ? labels : [`${unmappedLabel} (${String(authority)})`];
}
function normalizeValidUntil(value: string): string {
const normalized = value.trim().replace("T", " ");
const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2})(?::(\d{2}))?)?$/);
if (!match) throw new Error("Enter a valid date or date and time.");
const [, yearText, monthText, dayText, hourText = "0", minuteText = "0", secondText = "0"] = match;
const year = Number(yearText);
const month = Number(monthText);
const day = Number(dayText);
const hour = Number(hourText);
const minute = Number(minuteText);
const second = Number(secondText);
const daysInMonth = month >= 1 && month <= 12 ? new Date(year, month, 0).getDate() : 0;
if (day < 1 || day > daysInMonth || hour > 23 || minute > 59 || second > 59) throw new Error("Enter a valid date or date and time.");
return normalized;
}
export function xuguCreatePrincipalSql(name: string, isRole: boolean, password = "", options: XuguCreateUserOptions = {}): string {
const principal = xuguQuoteIdentifier(name);
if (isRole) return `CREATE ROLE ${principal};`;
const clauses = [`CREATE USER ${principal} IDENTIFIED BY ${xuguQuoteLiteral(password)}`];
const roleNames = new Map<string, string>();
for (const role of options.defaultRoles ?? []) {
const normalizedRole = role.trim();
if (normalizedRole && !roleNames.has(normalizedRole.toLocaleUpperCase())) roleNames.set(normalizedRole.toLocaleUpperCase(), normalizedRole);
}
const defaultRoles = [...roleNames.values()];
if (defaultRoles.length) clauses.push(`DEFAULT ROLE ${defaultRoles.map(xuguQuoteIdentifier).join(", ")}`);
if (options.validUntil?.trim()) clauses.push(`VALID UNTIL ${xuguQuoteLiteral(normalizeValidUntil(options.validUntil))}`);
if (options.locked) clauses.push("ACCOUNT LOCK");
if (options.passwordExpired) clauses.push("PASSWORD EXPIRE");
return `${clauses.join("\n ")};`;
}
export function xuguAlterAccountSql(principal: XuguPrincipal, options: XuguAlterAccountOptions): string {
if (principal.isRole || isProtectedPrincipal(principal)) throw new Error("Only non-system users can have account settings changed here.");
const clauses: string[] = [];
if (options.validUntil?.trim()) clauses.push(`VALID UNTIL ${xuguQuoteLiteral(normalizeValidUntil(options.validUntil))}`);
if (options.passwordExpired) clauses.push("PASSWORD EXPIRE");
if (clauses.length === 0) throw new Error("Set a validity date or mark the password as expired.");
return `ALTER USER ${xuguQuoteIdentifier(principal.name)}\n ${clauses.join("\n ")};`;
}
export function xuguAlterPasswordSql(principal: XuguPrincipal, password: string): string {
if (principal.isRole || isProtectedPrincipal(principal)) throw new Error("Password changes are only allowed for non-system users.");
return `ALTER USER ${xuguQuoteIdentifier(principal.name)} IDENTIFIED BY ${xuguQuoteLiteral(password)};`;
}
export function xuguAlterLockSql(principal: XuguPrincipal, locked: boolean): string {
if (principal.isRole || isProtectedPrincipal(principal)) throw new Error("Only non-system users can be locked or unlocked here.");
return `ALTER USER ${xuguQuoteIdentifier(principal.name)} ACCOUNT ${locked ? "LOCK" : "UNLOCK"};`;
}
export function xuguDropPrincipalSql(principal: XuguPrincipal): string {
if (isProtectedPrincipal(principal)) {
throw new Error("Built-in or system principals cannot be dropped from this screen.");
}
return `DROP ${principal.isRole ? "ROLE" : "USER"} ${xuguQuoteIdentifier(principal.name)}${principal.isRole ? "" : " RESTRICT"};`;
}
function isProtectedPrincipal(principal: XuguPrincipal): boolean {
return principal.isSystem || ["SYS", "SYSTEM", "SYSDBA", "SYSAUDITOR", "SYSSSO", "GUEST", "PUBLIC", "DB_ADMIN", "DB_AUDIT_ADMIN", "DB_AUDIT_OPER", "DB_POLICY_ADMIN", "DB_POLICY_OPER"].includes(principal.name.trim().toUpperCase());
}
export function xuguPrincipalIsProtected(principal: XuguPrincipal): boolean {
return isProtectedPrincipal(principal);
}
export function xuguGrantSql(input: XuguGrantInput): string {
if (isProtectedPrincipal(input.principal)) throw new Error("Built-in or system principals cannot be modified from this screen.");
const grantee = xuguQuoteIdentifier(input.principal.name);
if (input.revokeGrantOptionOnly) throw new Error("Use revoke to remove a grant option.");
if (input.scope === "admin") {
const authority = input.adminAuthority;
if (!authority) throw new Error("Choose an administrative authority.");
return `GRANT ${authority} TO ${grantee};`;
}
if (input.scope === "role") {
if (input.principal.isRole) throw new Error("Roles can only be granted to users.");
const role = xuguQuoteIdentifier(input.role ?? "");
return `GRANT ROLE ${role} TO ${grantee};`;
}
if (input.scope === "system" && !input.systemDatabase) throw new Error("System database privileges can only be managed from the SYSTEM database.");
if (input.scope === "object" && !XUGU_OBJECT_TYPES.some((item) => item.sql === input.objectType)) throw new Error("Choose a supported object type.");
if (input.scope === "column" && !["TABLE", "VIEW"].includes(input.objectType ?? "")) throw new Error("Column grants are supported only for tables and views.");
const privileges = [...new Set((input.privileges ?? []).map((value) => value.trim().toUpperCase()).filter(Boolean))];
if (privileges.length === 0) throw new Error("Choose at least one privilege.");
if (input.scope === "object" && privileges.includes("ALL PRIVILEGES") && privileges.length > 1) throw new Error("ALL PRIVILEGES cannot be combined with individual privileges.");
const supportedPrivileges = new Set(xuguPrivilegesForScope(input.scope, input.objectType, input.systemDatabase).map((item) => item.name));
if (privileges.some((privilege) => !supportedPrivileges.has(privilege))) throw new Error("One or more privileges are not valid for this scope.");
if (input.grantOption && input.scope !== "object") {
throw new Error("WITH GRANT OPTION is supported only for object-level privileges.");
}
if (input.scope === "system" || input.scope === "database") {
if (input.grantOption) throw new Error("Xugu does not support grant option for database-level privileges.");
return `GRANT ${privileges.join(", ")} TO ${grantee};`;
}
if (input.scope === "schema") {
const schema = xuguQuoteIdentifier(input.schema ?? "");
return `GRANT ${privileges.join(", ")} IN SCHEMA ${schema} TO ${grantee}${input.grantOption ? " WITH GRANT OPTION" : ""};`;
}
const schema = xuguQuoteIdentifier(input.schema ?? "");
const object = xuguQuoteIdentifier(input.object ?? "");
if (input.scope === "column") {
const column = xuguQuoteIdentifier(input.column ?? "");
const privilege = privileges[0];
if (privileges.length !== 1 || !["SELECT", "UPDATE"].includes(privilege)) throw new Error("Column grants support SELECT or UPDATE, one privilege at a time.");
return `GRANT ${privilege} (${column}) ON ${schema}.${object} TO ${grantee}${input.grantOption ? " WITH GRANT OPTION" : ""};`;
}
const objectType = XUGU_OBJECT_TYPES.find((item) => item.sql === input.objectType);
if (!objectType) throw new Error("Choose a supported object type.");
const objectTypeClause = ["TABLE", "VIEW", "PROCEDURE", "SEQUENCE"].includes(objectType.sql) ? `${objectType.sql} ` : "";
return `GRANT ${privileges.join(", ")} ON ${objectTypeClause}${schema}.${object} TO ${grantee}${input.grantOption ? " WITH GRANT OPTION" : ""};`;
}
export function xuguRevokeSql(input: XuguGrantInput): string {
if (isProtectedPrincipal(input.principal)) throw new Error("Built-in or system principals cannot be modified from this screen.");
const grantee = xuguQuoteIdentifier(input.principal.name);
if (input.scope === "admin") {
if (!input.adminAuthority) throw new Error("Choose an administrative authority.");
return `REVOKE ${input.adminAuthority} FROM ${grantee};`;
}
if (input.scope === "role") {
if (input.principal.isRole) throw new Error("Roles can only be revoked from users.");
return `REVOKE ROLE ${xuguQuoteIdentifier(input.role ?? "")} FROM ${grantee};`;
}
if (input.scope === "system" && !input.systemDatabase) throw new Error("System database privileges can only be managed from the SYSTEM database.");
if (input.scope === "object" && !XUGU_OBJECT_TYPES.some((item) => item.sql === input.objectType)) throw new Error("Choose a supported object type.");
if (input.scope === "column" && !["TABLE", "VIEW"].includes(input.objectType ?? "")) throw new Error("Column grants are supported only for tables and views.");
const privileges = [...new Set((input.privileges ?? []).map((value) => value.trim().toUpperCase()).filter(Boolean))];
if (privileges.length === 0) throw new Error("Choose at least one privilege.");
if (input.scope === "object" && privileges.includes("ALL PRIVILEGES") && privileges.length > 1) throw new Error("ALL PRIVILEGES cannot be combined with individual privileges.");
const supportedPrivileges = new Set(xuguPrivilegesForScope(input.scope, input.objectType, input.systemDatabase).map((item) => item.name));
if (privileges.some((privilege) => !supportedPrivileges.has(privilege))) throw new Error("One or more privileges are not valid for this scope.");
const grantOption = input.revokeGrantOptionOnly ? " GRANT OPTION FOR" : "";
if (input.revokeGrantOptionOnly && input.scope !== "object") {
throw new Error("WITH GRANT OPTION is supported only for object-level privileges.");
}
const suffix = input.scope === "database" || input.scope === "system" ? "" : input.scope === "schema" ? ` IN SCHEMA ${xuguQuoteIdentifier(input.schema ?? "")}` : ` ${xuguQuoteIdentifier(input.schema ?? "")}.${xuguQuoteIdentifier(input.object ?? "")}`;
if (input.scope === "column") {
const column = xuguQuoteIdentifier(input.column ?? "");
const privilege = privileges[0];
if (privileges.length !== 1 || !["SELECT", "UPDATE"].includes(privilege)) throw new Error("Column grants support SELECT or UPDATE, one privilege at a time.");
return `REVOKE${grantOption} ${privilege} (${column}) ON ${xuguQuoteIdentifier(input.schema ?? "")}.${xuguQuoteIdentifier(input.object ?? "")} FROM ${grantee};`;
}
const objectSuffix = input.scope === "object" ? ` ON${suffix}` : suffix;
if (input.scope === "object") {
const objectType = XUGU_OBJECT_TYPES.find((item) => item.sql === input.objectType);
if (!objectType) throw new Error("Choose a supported object type.");
const objectTypeClause = ["TABLE", "VIEW", "PROCEDURE", "SEQUENCE"].includes(objectType.sql) ? ` ${objectType.sql}` : "";
return `REVOKE${grantOption} ${privileges.join(", ")} ON${objectTypeClause}${suffix} FROM ${grantee};`;
}
return `REVOKE${grantOption} ${privileges.join(", ")}${objectSuffix} FROM ${grantee};`;
}
function findColumns(columns: string[]) {
const normalized = columns.map((column) => column.toLowerCase());
return (name: string) => normalized.indexOf(name.toLowerCase());
}
function asBoolean(value: unknown): boolean {
if (typeof value === "boolean") return value;
return ["1", "t", "true", "y", "yes"].includes(
String(value ?? "")
.trim()
.toLowerCase(),
);
}
function optionalString(value: unknown): string | undefined {
if (value == null || String(value).trim() === "" || String(value).toUpperCase() === "NULL") return undefined;
return String(value);
}
@@ -89,6 +89,8 @@ export function getTreeNodeIconInfo(node: TreeNode): TreeNodeIconInfo | null {
return { icon: TableProperties, colorClass: "text-primary" }; return { icon: TableProperties, colorClass: "text-primary" };
case "user-admin": case "user-admin":
return { icon: UsersRound, colorClass: "text-primary" }; return { icon: UsersRound, colorClass: "text-primary" };
case "xugu-user-admin":
return { icon: ShieldCheck, colorClass: "text-primary" };
case "dameng-users": case "dameng-users":
return { icon: UsersRound, colorClass: "text-primary" }; return { icon: UsersRound, colorClass: "text-primary" };
case "dameng-roles": case "dameng-roles":
@@ -2577,6 +2577,45 @@ describe("connectionStore metadata loading", () => {
expect(store.isTreeNodeChildrenLoaded(test1Id)).toBe(true); expect(store.isTreeNodeChildrenLoaded(test1Id)).toBe(true);
}); });
it("adds the Xugu user-permissions utility only to Xugu connection roots", async () => {
const listDatabases = vi.fn().mockResolvedValue([{ name: "testdb", comment: null }]);
vi.doMock("@/lib/backend/tauriRuntime", () => ({ isTauriRuntime: () => false }));
vi.doMock("@/lib/backend/api", () => ({
checkConnectionHealth: vi.fn().mockResolvedValue(undefined),
deleteSchemaCachePrefix: vi.fn().mockResolvedValue(undefined),
listDatabases,
loadSchemaCache: vi.fn().mockResolvedValue(null),
saveSchemaCache: vi.fn().mockResolvedValue(undefined),
saveConnections: vi.fn().mockResolvedValue(undefined),
saveSidebarLayout: vi.fn().mockResolvedValue(undefined),
}));
const { useConnectionStore } = await import("@/stores/connectionStore");
const store = useConnectionStore();
const xugu = xuguConnection();
const mysql = mysqlConnection();
store.connections = [xugu, mysql];
store.connectedIds = new Set([xugu.id, mysql.id]);
store.treeNodes = [xugu, mysql].map((connection) => ({
id: connection.id,
label: connection.name,
type: "connection" as const,
connectionId: connection.id,
isExpanded: false,
children: [],
}));
await store.loadDatabases(xugu.id, { connectedOnly: true });
await store.loadDatabases(mysql.id, { connectedOnly: true });
const xuguRoot = store.treeNodes.find((node) => node.connectionId === xugu.id)!;
const mysqlRoot = store.treeNodes.find((node) => node.connectionId === mysql.id)!;
expect(xuguRoot.children?.filter((node) => node.type === "xugu-user-admin")).toHaveLength(1);
expect(mysqlRoot.children?.some((node) => node.type === "xugu-user-admin")).toBe(false);
expect(mysqlRoot.children?.some((node) => node.type === "user-admin")).toBe(true);
}, 15000);
it("clears connection loading after disconnect even when metadata apply is skipped", async () => { it("clears connection loading after disconnect even when metadata apply is skipped", async () => {
let resolveDatabases!: (value: { name: string; comment: null }[]) => void; let resolveDatabases!: (value: { name: string; comment: null }[]) => void;
const listDatabases = vi.fn( const listDatabases = vi.fn(
+17 -2
View File
@@ -1823,7 +1823,7 @@ export const useConnectionStore = defineStore("connection", () => {
// as metadata children, withConnectionUtilityNodes would keep the old copies // as metadata children, withConnectionUtilityNodes would keep the old copies
// AND append fresh ones on every useCachedChildren pass, duplicating the // AND append fresh ones on every useCachedChildren pass, duplicating the
// 用户/角色 menus once per refresh cycle. // 用户/角色 menus once per refresh cycle.
return node.type === "oracle-db-links" || node.type === "user-admin" || node.type === "dameng-users" || node.type === "dameng-roles" || node.type === "dameng-job-admin" || node.type === "group-tablespaces" || node.type === "saved-sql-root"; return node.type === "oracle-db-links" || node.type === "user-admin" || node.type === "xugu-user-admin" || node.type === "dameng-users" || node.type === "dameng-roles" || node.type === "dameng-job-admin" || node.type === "group-tablespaces" || node.type === "saved-sql-root";
} }
function connectionMetadataChildren(children: TreeNode[] | undefined): TreeNode[] { function connectionMetadataChildren(children: TreeNode[] | undefined): TreeNode[] {
@@ -2091,6 +2091,20 @@ export const useConnectionStore = defineStore("connection", () => {
}; };
} }
function buildXuguUserAdminNode(connectionId: string, existingConnectionNode?: TreeNode): TreeNode | undefined {
const config = getConfig(connectionId);
if (effectiveDatabaseTypeForConnection(config) !== "xugu") return undefined;
const existing = existingConnectionNode?.children?.find((child) => child.type === "xugu-user-admin");
return {
id: `${connectionId}:__xugu_user_admin`,
label: "tree.xuguUserPermissions",
type: "xugu-user-admin",
connectionId,
database: config?.database || "",
isExpanded: existing?.isExpanded ?? false,
};
}
function buildDamengUserNode(connectionId: string, existingConnectionNode?: TreeNode): TreeNode | undefined { function buildDamengUserNode(connectionId: string, existingConnectionNode?: TreeNode): TreeNode | undefined {
const config = getConfig(connectionId); const config = getConfig(connectionId);
if (effectiveDatabaseTypeForConnection(config) !== "dameng") return undefined; if (effectiveDatabaseTypeForConnection(config) !== "dameng") return undefined;
@@ -2199,11 +2213,12 @@ export const useConnectionStore = defineStore("connection", () => {
function withConnectionUtilityNodes(connectionId: string, children: TreeNode[], existingConnectionNode?: TreeNode): TreeNode[] { function withConnectionUtilityNodes(connectionId: string, children: TreeNode[], existingConnectionNode?: TreeNode): TreeNode[] {
const nonUtilityChildren = connectionMetadataChildren(children); const nonUtilityChildren = connectionMetadataChildren(children);
const userAdminNode = buildUserAdminNode(connectionId, existingConnectionNode); const userAdminNode = buildUserAdminNode(connectionId, existingConnectionNode);
const xuguUserAdminNode = buildXuguUserAdminNode(connectionId, existingConnectionNode);
const damengUserNode = buildDamengUserNode(connectionId, existingConnectionNode); const damengUserNode = buildDamengUserNode(connectionId, existingConnectionNode);
const damengRoleNode = buildDamengRoleNode(connectionId, existingConnectionNode); const damengRoleNode = buildDamengRoleNode(connectionId, existingConnectionNode);
const damengJobAdminNode = buildDamengJobAdminNode(connectionId, existingConnectionNode); const damengJobAdminNode = buildDamengJobAdminNode(connectionId, existingConnectionNode);
const xuguTablespacesNode = buildXuguTablespacesNode(connectionId, existingConnectionNode); const xuguTablespacesNode = buildXuguTablespacesNode(connectionId, existingConnectionNode);
return [...nonUtilityChildren, buildOracleDatabaseLinksNode(connectionId, existingConnectionNode), userAdminNode, damengUserNode, damengRoleNode, damengJobAdminNode, xuguTablespacesNode].filter(Boolean) as TreeNode[]; return [...nonUtilityChildren, buildOracleDatabaseLinksNode(connectionId, existingConnectionNode), userAdminNode, xuguUserAdminNode, damengUserNode, damengRoleNode, damengJobAdminNode, xuguTablespacesNode].filter(Boolean) as TreeNode[];
} }
function withSavedSqlRoot(connectionId: string, children: TreeNode[], existingConnectionNode?: TreeNode): TreeNode[] { function withSavedSqlRoot(connectionId: string, children: TreeNode[], existingConnectionNode?: TreeNode): TreeNode[] {
+24
View File
@@ -3370,6 +3370,29 @@ export const useQueryStore = defineStore("query", () => {
return registerOpenTab(tab); return registerOpenTab(tab);
} }
function openXuguUserAdmin(connectionId: string) {
const existing = tabs.value.find((tab) => tab.mode === "xugu-users" && tab.connectionId === connectionId);
if (existing) {
switchTab(existing.id);
return existing.id;
}
const conn = useConnectionStore().getConfig(connectionId);
const id = uuid();
const tab: QueryTab = {
id,
title: t("xuguUserPermissions.title"),
connectionId,
database: conn?.database || "",
sql: "",
isExecuting: false,
isCancelling: false,
isExplaining: false,
mode: "xugu-users",
};
return registerOpenTab(tab);
}
function openProcessList(connectionId: string) { function openProcessList(connectionId: string) {
const existing = tabs.value.find((tab) => tab.mode === "processlist" && tab.connectionId === connectionId); const existing = tabs.value.find((tab) => tab.mode === "processlist" && tab.connectionId === connectionId);
if (existing) { if (existing) {
@@ -9435,6 +9458,7 @@ export const useQueryStore = defineStore("query", () => {
openMongoGridFs, openMongoGridFs,
openMongoBucket, openMongoBucket,
openUserAdmin, openUserAdmin,
openXuguUserAdmin,
openProcessList, openProcessList,
openSqlServerActivityTrace, openSqlServerActivityTrace,
openMysqlDashboard, openMysqlDashboard,
+2
View File
@@ -1571,6 +1571,7 @@ export type TreeNodeType =
| "event-trigger" | "event-trigger"
| "object-browser" | "object-browser"
| "user-admin" | "user-admin"
| "xugu-user-admin"
| "dameng-users" | "dameng-users"
| "dameng-roles" | "dameng-roles"
| "dameng-job-admin" | "dameng-job-admin"
@@ -2000,6 +2001,7 @@ export interface QueryTab {
| "objects" | "objects"
| "structure" | "structure"
| "users" | "users"
| "xugu-users"
| "dameng-users" | "dameng-users"
| "dameng-roles" | "dameng-roles"
| "dameng-jobs" | "dameng-jobs"