"use client"; import ConfirmActionDialog from "@/components/ConfirmActionDialog"; import GuardedPage from "@/components/GuardedPage"; import IssueDetailsSummary from "@/components/IssueDetailsSummary"; import { apiKeys as apiKeysApi, type ApiKeyExpiryOption, type ApiKeyRecord, type CreateApiKeyBody, } from "@/lib/api"; import { Activity, AlertCircle, CheckCircle, Copy, Eye, EyeOff, Key, Loader2, Plus, RefreshCw, Shield, Trash2, X, } from "lucide-react"; import { useEffect, useMemo, useState } from "react"; type GeneratedKeyState = { id: string; name: string; rawKey: string; }; type PendingConfirmAction = { title: string; description: string; confirmLabel: string; tone?: "danger" | "warning" | "info"; note?: string; onConfirm: () => void; }; const permissionOptions: Array<{ id: string; label: string; description: string; defaultChecked?: boolean; }> = [ { id: "read:servers", label: "View servers", description: "Read server identity, health, and status.", defaultChecked: true, }, { id: "write:servers", label: "Manage servers", description: "Create, update, test, reboot, and maintain server resources.", }, { id: "read:containers", label: "View containers", description: "Read container inventory and runtime state.", defaultChecked: true, }, { id: "write:containers", label: "Manage containers", description: "Deploy, restart, stop, or remove containers.", }, { id: "read:logs", label: "View logs", description: "Read audit and runtime logs.", defaultChecked: true, }, { id: "read:metrics", label: "View metrics", description: "Read dashboard and server metrics.", }, { id: "read:domains", label: "View domains and SSL", description: "Read domain inventory, routing, and certificate state.", }, { id: "write:domains", label: "Manage domains and SSL", description: "Create, update, and revoke domain-related resources.", }, { id: "read:security", label: "View server security", description: "Read firewall, fail2ban, and hardening status.", }, { id: "write:security", label: "Manage server security", description: "Change firewall and fail2ban state on managed servers.", }, { id: "write:backups", label: "Manage backups", description: "Create and restore backups from automation.", }, ]; const expiryOptions: Array<{ id: ApiKeyExpiryOption; label: string }> = [ { id: "never", label: "Never expires" }, { id: "30d", label: "30 days" }, { id: "90d", label: "90 days" }, { id: "1y", label: "1 year" }, ]; const initialForm: CreateApiKeyBody = { name: "", permissions: permissionOptions .filter((option) => option.defaultChecked) .map((option) => option.id), expiresIn: "90d", }; function formatRelativeDate(value: string | null) { if (!value) return "Never"; const date = new Date(value); if (Number.isNaN(date.getTime())) return "Never"; const diffSeconds = Math.max( 0, Math.floor((Date.now() - date.getTime()) / 1000), ); if (diffSeconds < 60) return `${diffSeconds}s ago`; if (diffSeconds < 3600) return `${Math.floor(diffSeconds / 60)}m ago`; if (diffSeconds < 86400) return `${Math.floor(diffSeconds / 3600)}h ago`; if (diffSeconds < 604800) return `${Math.floor(diffSeconds / 86400)}d ago`; return date.toLocaleString(); } function formatDate(value: string | null) { if (!value) return "Never"; const date = new Date(value); if (Number.isNaN(date.getTime())) return "Unknown"; return date.toLocaleDateString(); } function maskKey(prefix: string) { return `${prefix}${"•".repeat(24)}`; } export default function ApiKeysPage() { const [keys, setKeys] = useState([]); const [loading, setLoading] = useState(true); const [error, setError] = useState(""); const [showCreate, setShowCreate] = useState(false); const [submitting, setSubmitting] = useState(false); const [form, setForm] = useState(initialForm); const [revealedKeyId, setRevealedKeyId] = useState(null); const [copiedKeyId, setCopiedKeyId] = useState(null); const [generatedKey, setGeneratedKey] = useState( null, ); const [sessionRawKeys, setSessionRawKeys] = useState>( {}, ); const [revokingId, setRevokingId] = useState(null); const [confirmDialog, setConfirmDialog] = useState(null); const stats = useMemo(() => { const now = Date.now(); const active = keys.filter((key) => key.isActive).length; const revoked = keys.length - active; const totalRequests = keys.reduce((sum, key) => sum + key.requestCount, 0); const expiringSoon = keys.filter((key) => { if (!key.isActive || !key.expiresAt) return false; const expiresAt = new Date(key.expiresAt).getTime(); return expiresAt > now && expiresAt - now <= 30 * 86400000; }).length; return { active, revoked, totalRequests, expiringSoon }; }, [keys]); useEffect(() => { void loadKeys(); }, []); async function loadKeys() { setLoading(true); setError(""); try { const response = await apiKeysApi.list(); setKeys(response.data ?? []); } catch (err) { setError(err instanceof Error ? err.message : "Failed to load API keys"); } finally { setLoading(false); } } function resetCreateState() { setForm(initialForm); setGeneratedKey(null); setSubmitting(false); } function closeCreateModal() { setShowCreate(false); resetCreateState(); } function togglePermission(permissionId: string) { setForm((current) => ({ ...current, permissions: current.permissions.includes(permissionId) ? current.permissions.filter((value) => value !== permissionId) : [...current.permissions, permissionId], })); } async function handleCopy(id: string, value: string) { try { await navigator.clipboard.writeText(value); setCopiedKeyId(id); window.setTimeout(() => setCopiedKeyId(null), 2000); } catch { setError("Clipboard access failed. Copy the key manually."); } } async function handleCreate(event: React.FormEvent) { event.preventDefault(); if (!form.name.trim()) { setError("Key name is required."); return; } setSubmitting(true); setError(""); try { const response = await apiKeysApi.create({ ...form, name: form.name.trim(), }); const createdKey = response.data; setKeys((current) => [ { id: createdKey.id, name: createdKey.name, keyPrefix: createdKey.keyPrefix, permissions: createdKey.permissions, lastUsed: createdKey.lastUsed, expiresAt: createdKey.expiresAt, isActive: createdKey.isActive, requestCount: createdKey.requestCount, createdAt: createdKey.createdAt, }, ...current, ]); setSessionRawKeys((current) => ({ ...current, [createdKey.id]: createdKey.rawKey, })); setGeneratedKey({ id: createdKey.id, name: createdKey.name, rawKey: createdKey.rawKey, }); setRevealedKeyId(createdKey.id); setForm(initialForm); } catch (err) { setError(err instanceof Error ? err.message : "Failed to create API key"); } finally { setSubmitting(false); } } async function revokeKey(id: string) { const target = keys.find((key) => key.id === id); if (!target) return; setRevokingId(id); setError(""); try { await apiKeysApi.revoke(id); setKeys((current) => current.map((key) => key.id === id ? { ...key, isActive: false } : key, ), ); if (revealedKeyId === id) { setRevealedKeyId(null); } } catch (err) { setError(err instanceof Error ? err.message : "Failed to revoke API key"); } finally { setRevokingId(null); } } function handleRevoke(id: string) { const target = keys.find((key) => key.id === id); if (!target) return; setConfirmDialog({ title: "Revoke API Key", description: `Revoke API key "${target.name}"? This action cannot be undone.`, confirmLabel: "Revoke Key", tone: "danger", note: "Automation and integrations using this key will stop working immediately.", onConfirm: () => { void revokeKey(id); }, }); } return ( setConfirmDialog(null)} onConfirm={() => { const current = confirmDialog; setConfirmDialog(null); current?.onConfirm(); }} />

API keys are for automation and external integrations.

Use them from scripts, CI/CD, bots, or internal tools through {" "} x-api-key {" "} or {" "} Authorization: Bearer vpk_... . Raw keys are shown only once when created.

{[ { label: "Active Keys", value: stats.active, color: "#10b981", icon: Key, }, { label: "Total Requests", value: stats.totalRequests.toLocaleString(), color: "#3b82f6", icon: Activity, }, { label: "Expiring Soon", value: stats.expiringSoon, color: "#f59e0b", icon: AlertCircle, }, { label: "Revoked", value: stats.revoked, color: "#ef4444", icon: Trash2, }, ].map((item) => { const Icon = item.icon; return (

{item.value}

{item.label}

); })}

{keys.length} API keys total

{error && ( )} {loading ? (
Loading API keys...
) : keys.length === 0 ? (

No API keys yet

Create a key to allow scripts, bots, or deployment pipelines to call this panel without logging in through the browser.

) : (
{keys.map((key) => { const canReveal = Boolean(sessionRawKeys[key.id]); const isRevealed = revealedKeyId === key.id && canReveal; const rawValue = sessionRawKeys[key.id]; return (

{key.name}

Created {formatDate(key.createdAt)} · Last used{" "} {formatRelativeDate(key.lastUsed)}

{key.expiresAt && ( Expires {formatDate(key.expiresAt)} )} {key.isActive ? "active" : "revoked"}
{isRevealed && rawValue ? rawValue : maskKey(key.keyPrefix)}

{canReveal ? "Raw key is still available in this browser session. Store it securely now." : "For security, the raw key is permanently hidden after creation. Create a new key if you lost it."}

{key.permissions.length > 0 ? ( key.permissions.map((permission) => ( {permission} )) ) : ( No scoped permissions stored. )}
{key.requestCount.toLocaleString()} requests {key.isActive && ( )}
); })}
)}
{showCreate && (
event.stopPropagation()} >

{generatedKey ? "API Key Created" : "Generate API Key"}

{generatedKey ? "Save the raw key now. It will not be shown again after this session." : "Create a new API key for scripts, bots, and CI/CD jobs."}

{generatedKey ? (

{generatedKey.name} is ready

Store this value in a password manager, secrets vault, or CI variable.

Raw API key

{generatedKey.rawKey}

Example usage

{`curl -H "x-api-key: ${generatedKey.rawKey}" http://localhost:4000/api/v1/servers`}
) : (
void handleCreate(event)} style={{ display: "flex", flexDirection: "column", gap: 12 }} >
setForm((current) => ({ ...current, name: event.target.value, })) } />
{permissionOptions.map((option) => { const checked = form.permissions.includes(option.id); return ( ); })}
)}
)}
); }