Files
Charon/frontend/src/pages/SystemSettings.tsx

624 lines
24 KiB
TypeScript

import { useState, useEffect, useMemo } from 'react'
import { useTranslation } from 'react-i18next'
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
import { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from '../components/ui/Card'
import { Button } from '../components/ui/Button'
import { Input } from '../components/ui/Input'
import { Switch } from '../components/ui/Switch'
import { Label } from '../components/ui/Label'
import { Alert, AlertDescription } from '../components/ui/Alert'
import { Badge } from '../components/ui/Badge'
import { Skeleton } from '../components/ui/Skeleton'
import { Select, SelectTrigger, SelectContent, SelectItem, SelectValue } from '../components/ui/Select'
import { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from '../components/ui/Tooltip'
import { toast } from '../utils/toast'
import { getSettings, updateSetting, testPublicURL } from '../api/settings'
import { getFeatureFlags, updateFeatureFlags } from '../api/featureFlags'
import client from '../api/client'
import { Server, RefreshCw, Save, Activity, Info, ExternalLink, CheckCircle2, XCircle, AlertTriangle } from 'lucide-react'
import { ConfigReloadOverlay } from '../components/LoadingStates'
import { WebSocketStatusCard } from '../components/WebSocketStatusCard'
import { LanguageSelector } from '../components/LanguageSelector'
import { cn } from '../utils/cn'
interface HealthResponse {
status: string
service: string
version: string
git_commit: string
build_time: string
}
interface UpdateInfo {
current_version: string
latest_version: string
update_available: boolean
release_url?: string
}
export default function SystemSettings() {
const { t } = useTranslation()
const queryClient = useQueryClient()
const [caddyAdminAPI, setCaddyAdminAPI] = useState('http://localhost:2019')
const [sslProvider, setSslProvider] = useState('auto')
const [keepaliveIdle, setKeepaliveIdle] = useState('')
const [keepaliveCount, setKeepaliveCount] = useState('')
const [domainLinkBehavior, setDomainLinkBehavior] = useState('new_tab')
const [publicURL, setPublicURL] = useState('')
const [publicURLValid, setPublicURLValid] = useState<boolean | null>(null)
const [publicURLSaving, setPublicURLSaving] = useState(false)
const keepaliveIdlePattern = /^(?:\d+)(?:ns|us|µs|ms|s|m|h)$/
const keepaliveIdleTrimmed = keepaliveIdle.trim()
const keepaliveCountTrimmed = keepaliveCount.trim()
const keepaliveIdleError =
keepaliveIdleTrimmed.length > 0 && !keepaliveIdlePattern.test(keepaliveIdleTrimmed)
? t('systemSettings.general.keepaliveIdleError')
: undefined
const keepaliveCountError = (() => {
if (!keepaliveCountTrimmed) {
return undefined
}
const parsed = Number.parseInt(keepaliveCountTrimmed, 10)
if (!Number.isInteger(parsed) || parsed < 1 || parsed > 1000) {
return t('systemSettings.general.keepaliveCountError')
}
return undefined
})()
const hasKeepaliveValidationError = Boolean(keepaliveIdleError || keepaliveCountError)
// Fetch Settings
const { data: settings } = useQuery({
queryKey: ['settings'],
queryFn: getSettings,
})
// Update local state when settings load
useEffect(() => {
if (settings) {
if (settings['caddy.admin_api']) setCaddyAdminAPI(settings['caddy.admin_api'])
// Default to 'auto' if empty or invalid value
if (settings['caddy.ssl_provider']) {
const validProviders = ['auto', 'letsencrypt-staging', 'letsencrypt-prod', 'zerossl']
const provider = settings['caddy.ssl_provider']
setSslProvider(validProviders.includes(provider) ? provider : 'auto')
}
setKeepaliveIdle(settings['caddy.keepalive_idle'] ?? '')
setKeepaliveCount(settings['caddy.keepalive_count'] ?? '')
if (settings['ui.domain_link_behavior']) setDomainLinkBehavior(settings['ui.domain_link_behavior'])
if (settings['app.public_url']) setPublicURL(settings['app.public_url'])
}
}, [settings])
// Validate Public URL with debouncing
const validatePublicURL = async (url: string) => {
if (!url) {
setPublicURLValid(null)
return
}
try {
const response = await client.post('/settings/validate-url', { url })
setPublicURLValid(response.data.valid)
} catch {
setPublicURLValid(false)
}
}
// Debounce validation
useEffect(() => {
const timer = setTimeout(() => {
if (publicURL) {
validatePublicURL(publicURL)
}
}, 300)
return () => clearTimeout(timer)
}, [publicURL])
// Fetch Health/System Status
const { data: health, isLoading: isLoadingHealth } = useQuery({
queryKey: ['health'],
queryFn: async (): Promise<HealthResponse> => {
const response = await client.get<HealthResponse>('/health')
return response.data
},
})
// Test Public URL - Server-side connectivity test with SSRF protection
const testPublicURLHandler = async () => {
if (!publicURL) {
toast.error(t('systemSettings.applicationUrl.invalidUrl'))
return
}
setPublicURLSaving(true)
try {
const result = await testPublicURL(publicURL)
if (result.reachable) {
toast.success(
result.message || `URL reachable (${result.latency?.toFixed(0)}ms)`
)
} else {
toast.error(result.error || 'URL not reachable')
}
} catch (error) {
toast.error(error instanceof Error ? error.message : 'Test failed')
} finally {
setPublicURLSaving(false)
}
}
// Check for Updates
const {
data: updateInfo,
refetch: checkUpdates,
isFetching: isCheckingUpdates,
} = useQuery({
queryKey: ['updates'],
queryFn: async (): Promise<UpdateInfo> => {
const response = await client.get<UpdateInfo>('/system/updates')
return response.data
},
enabled: false, // Manual trigger
})
const saveSettingsMutation = useMutation({
mutationFn: async () => {
if (hasKeepaliveValidationError) {
throw new Error(t('systemSettings.general.keepaliveValidationFailed'))
}
await updateSetting('caddy.admin_api', caddyAdminAPI, 'caddy', 'string')
await updateSetting('caddy.ssl_provider', sslProvider, 'caddy', 'string')
await updateSetting('caddy.keepalive_idle', keepaliveIdleTrimmed, 'caddy', 'string')
await updateSetting('caddy.keepalive_count', keepaliveCountTrimmed, 'caddy', 'string')
await updateSetting('ui.domain_link_behavior', domainLinkBehavior, 'ui', 'string')
await updateSetting('app.public_url', publicURL, 'general', 'string')
},
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['settings'] })
toast.success(t('systemSettings.settingsSaved'))
},
onError: (error: Error) => {
toast.error(t('systemSettings.settingsFailed', { error: error.message }))
},
})
// Feature Flags
const { data: featureFlags, refetch: refetchFlags } = useQuery({
queryKey: ['feature-flags'],
queryFn: getFeatureFlags,
})
const featureToggles = useMemo(
() => [
{
key: 'feature.cerberus.enabled',
label: t('systemSettings.features.cerberus'),
tooltip: t('systemSettings.features.cerberusTooltip'),
},
{
key: 'feature.crowdsec.console_enrollment',
label: t('systemSettings.features.crowdsecConsole'),
tooltip: t('systemSettings.features.crowdsecConsoleTooltip'),
},
{
key: 'feature.uptime.enabled',
label: t('systemSettings.features.uptimeMonitoring'),
tooltip: t('systemSettings.features.uptimeMonitoringTooltip'),
},
],
[t]
)
const updateFlagMutation = useMutation({
mutationFn: async (payload: Record<string, boolean>) => updateFeatureFlags(payload),
onSuccess: async () => {
await refetchFlags()
toast.success(t('systemSettings.featureFlagUpdated'))
},
onError: (err: unknown) => {
const msg = err instanceof Error ? err.message : String(err)
toast.error(t('systemSettings.featureFlagFailed', { error: msg }))
},
})
// CrowdSec control
// Determine loading message
const { message, submessage } = updateFlagMutation.isPending
? { message: t('systemSettings.updatingFeatures'), submessage: t('systemSettings.applyingChanges') }
: { message: t('common.loading'), submessage: t('systemSettings.pleaseWait') }
// Loading skeleton for settings
const SettingsSkeleton = () => (
<div className="space-y-6">
<div className="flex items-center gap-3">
<Skeleton className="h-8 w-8" />
<Skeleton className="h-8 w-48" />
</div>
{[1, 2, 3].map((i) => (
<Card key={i} className="p-6">
<div className="space-y-4">
<Skeleton className="h-6 w-32" />
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<Skeleton className="h-10 w-full" />
<Skeleton className="h-10 w-full" />
</div>
</div>
</Card>
))}
</div>
)
// Show skeleton while loading initial data
if (!settings && !featureFlags) {
return <SettingsSkeleton />
}
return (
<TooltipProvider>
{updateFlagMutation.isPending && (
<ConfigReloadOverlay
message={message}
submessage={submessage}
type="charon"
/>
)}
<div className="space-y-6">
<div className="flex items-center gap-3">
<div className="p-2 bg-brand-500/10 rounded-lg">
<Server className="h-6 w-6 text-brand-500" />
</div>
<h1 className="text-2xl font-bold text-content-primary">{t('systemSettings.title')}</h1>
</div>
{/* Features */}
<Card>
<CardHeader>
<CardTitle>{t('systemSettings.features.title')}</CardTitle>
<CardDescription>{t('systemSettings.features.description')}</CardDescription>
</CardHeader>
<CardContent>
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{featureFlags ? (
featureToggles.map(({ key, label, tooltip }) => (
<div
key={key}
className="flex items-center justify-between p-4 bg-surface-subtle rounded-lg border border-border"
>
<div className="flex items-center gap-2">
<Label className="text-sm font-medium cursor-default">{label}</Label>
<Tooltip>
<TooltipTrigger asChild>
<button type="button" className="text-content-muted hover:text-content-primary">
<Info className="h-4 w-4" />
</button>
</TooltipTrigger>
<TooltipContent className="max-w-xs">
<p>{tooltip}</p>
</TooltipContent>
</Tooltip>
</div>
<Switch
aria-label={`${label} toggle`}
checked={!!featureFlags[key]}
disabled={updateFlagMutation.isPending}
onChange={(e) => updateFlagMutation.mutate({ [key]: e.target.checked })}
/>
</div>
))
) : (
<div className="col-span-2 space-y-3">
<Skeleton className="h-16 w-full" />
<Skeleton className="h-16 w-full" />
</div>
)}
</div>
</CardContent>
</Card>
{/* General Configuration */}
<Card>
<CardHeader>
<CardTitle>{t('systemSettings.general.title')}</CardTitle>
<CardDescription>{t('systemSettings.general.description')}</CardDescription>
</CardHeader>
<CardContent className="space-y-6">
<div className="space-y-2">
<Label htmlFor="caddy-api">{t('systemSettings.general.caddyAdminApi')}</Label>
<Input
id="caddy-api"
type="text"
value={caddyAdminAPI}
onChange={(e) => setCaddyAdminAPI(e.target.value)}
placeholder="http://localhost:2019"
helperText={t('systemSettings.general.caddyAdminApiHelper')}
/>
</div>
<div className="space-y-2">
<Label htmlFor="ssl-provider">{t('systemSettings.general.sslProvider')}</Label>
<Select value={sslProvider} onValueChange={setSslProvider}>
<SelectTrigger id="ssl-provider">
<SelectValue placeholder={t('systemSettings.general.selectSslProvider')} />
</SelectTrigger>
<SelectContent>
<SelectItem value="auto">{t('systemSettings.general.sslAuto')}</SelectItem>
<SelectItem value="letsencrypt-prod">{t('systemSettings.general.sslLetsEncryptProd')}</SelectItem>
<SelectItem value="letsencrypt-staging">{t('systemSettings.general.sslLetsEncryptStaging')}</SelectItem>
<SelectItem value="zerossl">{t('systemSettings.general.sslZeroSSL')}</SelectItem>
</SelectContent>
</Select>
<p className="text-sm text-content-muted">
{t('systemSettings.general.sslProviderHelper')}
</p>
</div>
<div className="space-y-2">
<Label htmlFor="domain-behavior">{t('systemSettings.general.domainLinkBehavior')}</Label>
<Select value={domainLinkBehavior} onValueChange={setDomainLinkBehavior}>
<SelectTrigger id="domain-behavior">
<SelectValue placeholder={t('systemSettings.general.selectLinkBehavior')} />
</SelectTrigger>
<SelectContent>
<SelectItem value="same_tab">{t('systemSettings.general.sameTab')}</SelectItem>
<SelectItem value="new_tab">{t('systemSettings.general.newTab')}</SelectItem>
<SelectItem value="new_window">{t('systemSettings.general.newWindow')}</SelectItem>
</SelectContent>
</Select>
<p className="text-sm text-content-muted">
{t('systemSettings.general.domainLinkBehaviorHelper')}
</p>
</div>
<div className="space-y-2">
<Label htmlFor="keepalive-idle">{t('systemSettings.general.keepaliveIdle')}</Label>
<Input
id="keepalive-idle"
type="text"
value={keepaliveIdle}
onChange={(e) => setKeepaliveIdle(e.target.value)}
placeholder="2m"
error={keepaliveIdleError}
helperText={t('systemSettings.general.keepaliveIdleHelper')}
aria-invalid={keepaliveIdleError ? 'true' : 'false'}
/>
</div>
<div className="space-y-2">
<Label htmlFor="keepalive-count">{t('systemSettings.general.keepaliveCount')}</Label>
<Input
id="keepalive-count"
type="number"
min={1}
max={1000}
value={keepaliveCount}
onChange={(e) => setKeepaliveCount(e.target.value)}
placeholder="3"
error={keepaliveCountError}
helperText={t('systemSettings.general.keepaliveCountHelper')}
aria-invalid={keepaliveCountError ? 'true' : 'false'}
/>
</div>
<div className="space-y-2">
<Label htmlFor="language">{t('common.language')}</Label>
<LanguageSelector />
<p className="text-sm text-content-muted">
{t('systemSettings.general.languageHelper')}
</p>
</div>
</CardContent>
<CardFooter className="justify-end">
<Button
onClick={() => saveSettingsMutation.mutate()}
isLoading={saveSettingsMutation.isPending}
disabled={hasKeepaliveValidationError}
>
<Save className="h-4 w-4 mr-2" />
{t('systemSettings.saveSettings')}
</Button>
</CardFooter>
</Card>
{/* Application URL */}
<Card>
<CardHeader>
<CardTitle>{t('systemSettings.applicationUrl.title')}</CardTitle>
<CardDescription>{t('systemSettings.applicationUrl.description')}</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
<Alert variant="info">
<Info className="h-4 w-4" />
<AlertDescription>
{t('systemSettings.applicationUrl.infoMessage')}
</AlertDescription>
</Alert>
<div className="space-y-2">
<Label htmlFor="public-url">{t('systemSettings.applicationUrl.label')}</Label>
<div className="flex gap-2">
<Input
id="public-url"
type="url"
value={publicURL}
onChange={(e) => {
setPublicURL(e.target.value)
}}
placeholder="https://charon.example.com"
className={cn(
publicURLValid === false && 'border-red-500',
publicURLValid === true && 'border-green-500'
)}
/>
{publicURLValid !== null && (
publicURLValid ? (
<CheckCircle2 className="h-5 w-5 text-green-500 self-center shrink-0" />
) : (
<XCircle className="h-5 w-5 text-red-500 self-center shrink-0" />
)
)}
</div>
<p className="text-sm text-content-muted">
{t('systemSettings.applicationUrl.helper')}
</p>
{publicURLValid === false && (
<p className="text-sm text-red-500">
{t('systemSettings.applicationUrl.invalidUrl')}
</p>
)}
</div>
{!publicURL && (
<Alert variant="warning">
<AlertTriangle className="h-4 w-4" />
<AlertDescription>
{t('systemSettings.applicationUrl.notConfiguredWarning')}
</AlertDescription>
</Alert>
)}
<div className="flex gap-2">
<Button
variant="secondary"
onClick={testPublicURLHandler}
disabled={!publicURL || publicURLSaving}
>
<ExternalLink className="h-4 w-4 mr-2" />
{t('systemSettings.applicationUrl.testButton')}
</Button>
</div>
</CardContent>
<CardFooter className="justify-end">
<Button
onClick={() => saveSettingsMutation.mutate()}
isLoading={saveSettingsMutation.isPending}
>
<Save className="h-4 w-4 mr-2" />
{t('systemSettings.saveSettings')}
</Button>
</CardFooter>
</Card>
{/* System Status */}
<Card>
<CardHeader>
<div className="flex items-center gap-2">
<Activity className="h-5 w-5 text-success" />
<CardTitle>{t('systemSettings.systemStatus.title')}</CardTitle>
</div>
</CardHeader>
<CardContent>
{isLoadingHealth ? (
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{[1, 2, 3, 4].map((i) => (
<div key={i} className="space-y-2">
<Skeleton className="h-4 w-20" />
<Skeleton className="h-6 w-32" />
</div>
))}
</div>
) : health ? (
<div className="grid grid-cols-1 md:grid-cols-2 gap-6">
<div className="space-y-1">
<Label variant="muted">{t('systemSettings.systemStatus.service')}</Label>
<p className="text-lg font-medium text-content-primary">{health.service}</p>
</div>
<div className="space-y-1">
<Label variant="muted">{t('common.status')}</Label>
<div className="flex items-center gap-2">
<Badge variant={health.status === 'healthy' ? 'success' : 'error'}>
{health.status === 'healthy' ? t('dashboard.healthy') : t('dashboard.unhealthy')}
</Badge>
</div>
</div>
<div className="space-y-1">
<Label variant="muted">{t('systemSettings.systemStatus.version')}</Label>
<p className="text-lg font-medium text-content-primary">{health.version}</p>
</div>
<div className="space-y-1">
<Label variant="muted">{t('systemSettings.systemStatus.buildTime')}</Label>
<p className="text-lg font-medium text-content-primary">
{health.build_time || t('systemSettings.systemStatus.notAvailable')}
</p>
</div>
<div className="md:col-span-2 space-y-1">
<Label variant="muted">{t('systemSettings.systemStatus.gitCommit')}</Label>
<p className="text-sm font-mono text-content-secondary bg-surface-subtle px-3 py-2 rounded-md">
{health.git_commit || t('systemSettings.systemStatus.notAvailable')}
</p>
</div>
</div>
) : (
<Alert variant="error">
{t('systemSettings.systemStatus.fetchError')}
</Alert>
)}
</CardContent>
</Card>
{/* Update Check */}
<Card>
<CardHeader>
<CardTitle>{t('systemSettings.updates.title')}</CardTitle>
<CardDescription>{t('systemSettings.updates.description')}</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
{updateInfo && (
<>
<div className="grid grid-cols-1 md:grid-cols-2 gap-6">
<div className="space-y-1">
<Label variant="muted">{t('systemSettings.updates.currentVersion')}</Label>
<p className="text-lg font-medium text-content-primary">
{updateInfo.current_version}
</p>
</div>
<div className="space-y-1">
<Label variant="muted">{t('systemSettings.updates.latestVersion')}</Label>
<p className="text-lg font-medium text-content-primary">
{updateInfo.latest_version}
</p>
</div>
</div>
{updateInfo.update_available ? (
<Alert variant="info" title={t('systemSettings.updates.updateAvailable')}>
{t('systemSettings.updates.newVersionAvailable')}{' '}
{updateInfo.release_url && (
<a
href={updateInfo.release_url}
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-1 text-brand-500 hover:underline font-medium"
>
{t('systemSettings.updates.viewReleaseNotes')}
<ExternalLink className="h-3 w-3" />
</a>
)}
</Alert>
) : (
<Alert variant="success" title={t('systemSettings.updates.upToDate')}>
{t('systemSettings.updates.runningLatest')}
</Alert>
)}
</>
)}
</CardContent>
<CardFooter>
<Button
onClick={() => checkUpdates()}
isLoading={isCheckingUpdates}
variant="secondary"
>
<RefreshCw className="h-4 w-4 mr-2" />
{t('systemSettings.updates.checkForUpdates')}
</Button>
</CardFooter>
</Card>
{/* WebSocket Connection Status */}
<WebSocketStatusCard showDetails={true} />
</div>
</TooltipProvider>
)
}