Repository Public
1// Clés API : liste et usage en direct, création, modification des quotas, activation, rotation, révocation.2// Le secret d'une clé n'existe que dans le dialogue qui l'affiche une fois : il n'est écrit dans aucun stockage3// et il est effacé du DOM et de la mémoire à la fermeture.45import { ApiError, errorMessage, get, isSilent, patch, post } from "../api.js";6import { h, icon, mount } from "../dom.js";7import { DASH, compact, date, dateTime, has, num, quota, rel } from "../format.js";8import { timeChart } from "../charts.js";9import { busy, confirmDialog, empty, note, openDialog, toast } from "../ui.js";10import { card, dl, load, meter, pill } from "./common.js";11import { axisFormats, fillSeries, requestsTable } from "./analytics.js";1213const STATUS = { active: ["Active", "ok"], disabled: ["Désactivée", "warn"], expired: ["Expirée", "warn"], revoked: ["Révoquée", "danger"] };14const PRIORITY = {15 admin: ["Administrateur", "Servie en premier"],16 internal: ["Interne", "Services MacLustr"],17 client: ["Client", "Priorité normale"],18 background: ["Arrière-plan", "Servie quand la capacité est libre"],19};20const ENDPOINTS = [["chat.completions", "Chat"], ["completions", "Complétions"], ["models", "Liste des modèles"]];21const APP_HINTS = ["SP Chat", "SP Agent", "SP Browser", "Applications macOS", "Applications iOS", "Services internes MacLustr"];22let showRevoked = false;2324const listOrAll = (list, all) => (!list || !list.length || list.includes("*") ? all : list.join(", "));2526function usageBar(label, used, limit, unit = "") {27 const text = limit ? `${compact(used)} / ${compact(limit)}${unit}` : `${compact(used)}${unit} · illimité`;28 const frac = limit ? used / limit : 0;29 return h("div", { class: "usage" }, h("div", null, h("span", null, label), h("span", null, text)),30 meter(frac, frac >= 1 ? "danger" : frac >= 0.8 ? "warn" : ""));31}3233// --- secret affiché une seule fois ------------------------------------------------------------------34function showSecret(title, key, secretValue) {35 let secret = secretValue;36 const out = h("output", { "aria-label": "Clé API secrète" }, secret);37 const status = h("span", { class: "sr-only", role: "status" });38 const copyBtn = h("button", { class: "btn btn-primary", type: "button" }, icon("copy"), "Copier");39 copyBtn.addEventListener("click", async () => {40 let ok = false;41 try { await navigator.clipboard.writeText(secret); ok = true; } catch {42 const sel = window.getSelection();43 const r = document.createRange();44 r.selectNodeContents(out);45 sel.removeAllRanges();46 sel.addRange(r);47 try { ok = document.execCommand("copy"); } catch { ok = false; }48 }49 copyBtn.replaceChildren(icon(ok ? "check" : "copy"), ok ? "Copiée" : "Copier");50 status.textContent = ok ? "Clé copiée dans le presse-papiers." : "Copie impossible : sélectionnez la clé et copiez-la manuellement.";51 if (ok) setTimeout(() => copyBtn.isConnected && copyBtn.replaceChildren(icon("copy"), "Copier"), 2500);52 });53 return openDialog({54 title,55 dismissable: true,56 onClose: () => { out.textContent = ""; secret = null; },57 render: (close, dlg) => {58 dlg.dataset.sticky = "1"; // un clic à côté ne ferme pas ce dialogue59 return {60 body: [61 note("warn", h("b", null, "Copiez cette clé maintenant. "), "Elle ne sera plus jamais affichée : le serveur n'en conserve qu'une empreinte. En cas de perte, effectuez une rotation."),62 h("div", { class: "secret" }, out, copyBtn),63 status,64 dl([["Nom", key.name], ["Application", key.app || DASH], ["Identifiant", h("span", { class: "mono" }, key.id)], ["Préfixe visible", h("span", { class: "mono" }, `${key.prefix}…`)]]),65 h("p", { class: "faint", style: { "font-size": "var(--text-sm)" } }, "Conservez-la dans un gestionnaire de secrets. Elle s'utilise dans l'en-tête ", h("code", null, "Authorization: Bearer …"), "."),66 ],67 foot: h("button", { class: "btn", type: "button", onclick: () => close() }, "J'ai conservé la clé — fermer"),68 };69 },70 });71}7273// --- formulaire (création / modification) -----------------------------------------------------------74function keyForm(models, key) {75 const edit = !!key;76 const k = key || { name: "", app: "", priority: "client", models: ["*"], endpoints: ["*"], rpm: 60, tpm: 200000, daily_tokens: 0, monthly_tokens: 0, max_concurrency: 4, expires_at: null };77 const input = (id, attrs) => h("input", { class: "input", id, name: id, ...attrs });78 const field = (id, label, control, hint) => h("div", { class: "field" }, h("label", { for: id }, label), control, hint ? h("span", { class: "hint" }, hint) : null);79 const numField = (id, label, value, min, max, hint) => field(id, label, input(id, { type: "number", inputmode: "numeric", min, max, step: 1, value: String(value), required: true }), hint);8081 const name = input("k-name", { type: "text", maxLength: 80, required: true, value: k.name, autocomplete: "off", placeholder: "Ex. SP Chat — production" });82 const app = input("k-app", { type: "text", maxLength: 80, value: k.app || "", autocomplete: "off", list: "k-app-hints", placeholder: "Application ou service" });83 const priority = h("select", { class: "input", id: "k-priority" }, Object.entries(PRIORITY).map(([v, [l, d]]) => h("option", { value: v, selected: v === k.priority }, `${l} — ${d}`)));8485 const group = (legend, allLabel, options, current, hint) => {86 const all = h("input", { type: "checkbox", checked: !current || current.includes("*") });87 const boxes = options.map(([value, label]) => {88 const box = h("input", { type: "checkbox", value, checked: !all.checked && current.includes(value), disabled: all.checked });89 return [box, h("label", { class: "check" }, box, label)];90 });91 all.addEventListener("change", () => { for (const [b] of boxes) { b.disabled = all.checked; if (all.checked) b.checked = false; } });92 const el = h("fieldset", { class: "field span2" }, h("legend", null, legend),93 h("div", { class: "checks" }, h("label", { class: "check" }, all, allLabel), boxes.map(([, l]) => l)),94 hint ? h("span", { class: "hint" }, hint) : null);95 return { el, value: () => (all.checked ? ["*"] : boxes.filter(([b]) => b.checked).map(([b]) => b.value)) };96 };97 const modelGroup = group("Modèles autorisés", "Tous les modèles", models.map((m) => [m, m]), k.models);98 const endpointGroup = group("Endpoints autorisés", "Tous les endpoints", ENDPOINTS, k.endpoints);99100 const pad = (n) => String(n).padStart(2, "0");101 const toDate = (ts) => { const d = new Date(ts * 1000); return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`; };102 const today = new Date();103 const expiry = input("k-expiry", { type: "date", value: k.expires_at ? toDate(k.expires_at) : "", min: toDate(today.getTime() / 1000) });104105 const error = h("div", { "aria-live": "assertive" });106 const form = h("form", { class: "form-grid", novalidate: true, id: "key-form" },107 h("div", { class: "span2" }, field("k-name", "Nom de la clé", name)),108 field("k-app", "Application", [app, h("datalist", { id: "k-app-hints" }, APP_HINTS.map((v) => h("option", { value: v })))], "Sert au regroupement dans Analytics."),109 field("k-priority", "Classe de priorité", priority, "Ordre de service quand la file d'attente est active."),110 modelGroup.el, endpointGroup.el,111 numField("k-rpm", "Requêtes par minute", k.rpm, 0, 100000, "0 = illimité"),112 numField("k-tpm", "Jetons par minute", k.tpm, 0, 100000000, "0 = illimité"),113 numField("k-daily", "Quota quotidien de jetons", k.daily_tokens, 0, 1e12, "0 = illimité"),114 numField("k-monthly", "Quota mensuel de jetons", k.monthly_tokens, 0, 1e13, "0 = illimité"),115 numField("k-conc", "Requêtes simultanées", k.max_concurrency, 1, 64, "De 1 à 64"),116 field("k-expiry", "Date d'expiration", expiry, "Facultative. La clé cesse de fonctionner à la fin de ce jour."),117 h("div", { class: "span2" }, error));118119 function read() {120 mount(error);121 const fail = (el, msg) => { mount(error, note("danger", msg)); if (el) { el.setAttribute("aria-invalid", "true"); el.focus(); } return null; };122 for (const el of form.querySelectorAll("[aria-invalid]")) el.removeAttribute("aria-invalid");123 const n = name.value.trim();124 if (!n) return fail(name, "Donnez un nom à la clé.");125 const ints = {};126 for (const [id, field_, min, max, label] of [["k-rpm", "rpm", 0, 100000, "Requêtes par minute"], ["k-tpm", "tpm", 0, 100000000, "Jetons par minute"],127 ["k-daily", "daily_tokens", 0, 1e12, "Quota quotidien"], ["k-monthly", "monthly_tokens", 0, 1e13, "Quota mensuel"], ["k-conc", "max_concurrency", 1, 64, "Requêtes simultanées"]]) {128 const el = form.querySelector(`#${id}`);129 const v = Number(el.value);130 if (el.value.trim() === "" || !Number.isInteger(v) || v < min || v > max) return fail(el, `${label} : entier entre ${num(min)} et ${num(max)}.`);131 ints[field_] = v;132 }133 const ms_ = modelGroup.value();134 if (!ms_.length) return fail(null, "Sélectionnez au moins un modèle, ou « Tous les modèles ».");135 const es = endpointGroup.value();136 if (!es.length) return fail(null, "Sélectionnez au moins un endpoint, ou « Tous les endpoints ».");137 let expires = null;138 if (expiry.value) {139 const [y, m, d] = expiry.value.split("-").map(Number);140 expires = Math.floor(new Date(y, m - 1, d, 23, 59, 59).getTime() / 1000);141 if (expires <= Date.now() / 1000 && !(edit && key.expires_at && toDate(key.expires_at) === expiry.value)) return fail(expiry, "La date d'expiration doit être dans le futur.");142 }143 const full = { name: n, app: app.value.trim(), priority: priority.value, models: ms_, endpoints: es, ...ints, expires_at: expires };144 if (!edit) return full;145 const diff = {};146 for (const [f, v] of Object.entries(full)) {147 if (f === "expires_at") { if ((key.expires_at ? toDate(key.expires_at) : "") !== expiry.value) diff[f] = v; }148 else if (JSON.stringify(v) !== JSON.stringify(key[f] ?? (f === "app" ? "" : null))) diff[f] = v;149 }150 return diff;151 }152 return { form, read, error };153}154155function openKeyForm(models, key, onDone) {156 const edit = !!key;157 return openDialog({158 title: edit ? `Modifier « ${key.name} »` : "Nouvelle clé API",159 render: (close, dlg) => {160 dlg.dataset.sticky = "1";161 const f = keyForm(models, key);162 const submit = h("button", { class: "btn btn-primary", type: "submit", form: "key-form" }, edit ? "Enregistrer" : "Créer la clé");163 f.form.addEventListener("submit", (e) => {164 e.preventDefault();165 const body = f.read();166 if (!body) return;167 if (edit && !Object.keys(body).length) { close(); return; }168 busy(submit, async () => {169 try {170 const out = edit ? await patch(`/admin/api/keys/${encodeURIComponent(key.id)}`, body) : await post("/admin/api/keys", body);171 close();172 onDone(out);173 } catch (err) {174 if (!isSilent(err)) mount(f.error, note("danger", errorMessage(err)));175 }176 });177 });178 return {179 body: [edit ? null : h("p", null, "La clé secrète sera affichée une seule fois, juste après la création."), f.form],180 foot: [h("button", { class: "btn btn-ghost", type: "button", onclick: () => close() }, "Annuler"), submit],181 };182 },183 });184}185186// --- statistiques d'une clé -------------------------------------------------------------------------187function openDetail(key) {188 let chart = null;189 return openDialog({190 title: `Statistiques — ${key.name}`,191 wide: true,192 onClose: () => chart && chart.destroy(),193 render: () => {194 const host = h("div", { class: "stack tight" });195 load(host, () => get(`/admin/api/keys/${encodeURIComponent(key.id)}`), (d) => {196 const kk = d.key;197 const u = d.usage || {};198 const [sl, sk] = STATUS[kk.status] || [kk.status, ""];199 const since = Math.floor(Date.now() / 1000) - 7 * 86400;200 const pts = fillSeries(d.series || [], since, 3600);201 const { fmtX, fmtTip } = axisFormats(3600);202 const total = (f) => pts.reduce((a, p) => a + (p[f] || 0), 0);203 const chartEl = h("div");204 const reqs = d.requests || [];205 mount(host,206 h("div", { class: "item-title" }, pill(sl, sk), pill(PRIORITY[kk.priority]?.[0] || kk.priority, "", "plain"), h("span", { class: "mono faint" }, `${kk.prefix}…`)),207 h("div", { class: "item-usage" },208 usageBar("Requêtes / min", u.rpm_used ?? 0, kk.rpm),209 usageBar("Jetons / min", u.tpm_used ?? 0, kk.tpm),210 usageBar("Jetons aujourd'hui", u.day_tokens ?? 0, kk.daily_tokens),211 usageBar("Jetons ce mois-ci", u.month_tokens ?? 0, kk.monthly_tokens),212 usageBar("Simultanées", u.active ?? 0, kk.max_concurrency)),213 dl([214 ["Application", kk.app || DASH],215 ["Créée", dateTime(kk.created_at)],216 ["Dernière utilisation", kk.last_used_at ? `${dateTime(kk.last_used_at)} (${rel(kk.last_used_at)})` : "Jamais utilisée"],217 ["Expiration", kk.expires_at ? date(kk.expires_at) : "Aucune"],218 kk.revoked_at ? ["Révoquée", dateTime(kk.revoked_at)] : null,219 kk.rotated_from ? ["Issue de la rotation de", h("span", { class: "mono" }, kk.rotated_from)] : null,220 ["Modèles", listOrAll(kk.models, "Tous")],221 ["Endpoints", listOrAll(kk.endpoints, "Tous")],222 ["7 derniers jours", `${num(total("requests"))} requête(s) · ${num(total("errors"))} erreur(s) · ${compact(total("prompt_tokens"))} jetons en entrée · ${compact(total("completion_tokens"))} en sortie`],223 ]),224 h("div", null, h("h3", { style: { "font-size": "var(--text-base)", "margin-bottom": "8px" } }, "Requêtes par heure, 7 jours"), chartEl),225 h("div", null, h("h3", { style: { "font-size": "var(--text-base)", "margin-bottom": "8px" } }, "Dernières requêtes"),226 reqs.length ? h("div", { class: "card" }, requestsTable(reqs, new Map([[kk.id, kk.name]]))) : empty("Aucune requête", "Cette clé n'a encore servi à aucun appel.", "list")));227 const has_ = total("requests") > 0;228 chart = timeChart(chartEl, { xs: has_ ? pts.map((p) => p.t) : [], type: "bar", integer: true, height: 180, fmtX, fmtTip, fmtY: (v) => compact(v),229 series: [{ name: "Requêtes", color: "var(--c1)", values: pts.map((p) => p.requests) }], label: "Requêtes par heure sur 7 jours",230 emptyText: "Aucune requête avec cette clé sur les 7 derniers jours." });231 });232 return { body: host };233 },234 });235}236237// --- vue --------------------------------------------------------------------------------------------238export default {239 title: "Clés API",240 sub: "Accès des applications à l'API d'inférence",241 mount(ctx) {242 let models = [];243 const host = h("div");244 const createBtn = h("button", { class: "btn btn-primary", type: "button" }, icon("plus"), "Nouvelle clé");245 mount(ctx.actions, createBtn);246 mount(ctx.root, host);247248 const act = async (fn, okMessage) => {249 try {250 const out = await fn();251 if (okMessage) toast(okMessage);252 return out;253 } catch (err) {254 if (err instanceof ApiError && err.code === "reauth_cancelled") toast("Action annulée.", "info");255 else if (!isSilent(err)) toast(errorMessage(err), "danger");256 return null;257 } finally {258 refresh();259 }260 };261262 createBtn.addEventListener("click", () => openKeyForm(models, null, async (out) => {263 refresh();264 await showSecret("Clé API créée", out.key, out.secret);265 out.secret = null;266 }));267268 function item(k) {269 const [sl, sk] = STATUS[k.status] || [k.status, ""];270 const u = k.usage || {};271 const live = k.status === "active";272 const id = encodeURIComponent(k.id);273 const btn = (label, ic, fn, cls = "") => h("button", { class: `btn btn-sm ${cls}`.trim(), type: "button", onclick: fn }, icon(ic, "icon-sm"), label);274 const actions = [btn("Statistiques", "stats", () => openDetail(k), "btn-ghost")];275 if (k.status !== "revoked") {276 actions.push(277 btn("Modifier", "edit", () => openKeyForm(models, k, () => { toast("Clé mise à jour."); refresh(); }), "btn-ghost"),278 k.disabled279 ? btn("Activer", "play", () => act(() => patch(`/admin/api/keys/${id}`, { disabled: false }), "Clé réactivée."), "btn-ghost")280 : btn("Désactiver", "pause", async () => {281 if (await confirmDialog({ title: "Désactiver cette clé ?", message: `Les appels faits avec « ${k.name} » seront refusés (401) jusqu'à sa réactivation. Ses réglages et ses statistiques sont conservés.`, confirmLabel: "Désactiver" })) {282 act(() => patch(`/admin/api/keys/${id}`, { disabled: true }), "Clé désactivée.");283 }284 }, "btn-ghost"),285 btn("Rotation", "refresh", async () => {286 if (!await confirmDialog({ title: "Effectuer la rotation de la clé ?", message: `Une nouvelle clé secrète aux mêmes droits sera créée et « ${k.name} » (${k.prefix}…) sera révoquée immédiatement. Les applications qui l'utilisent cesseront de fonctionner tant qu'elles n'auront pas reçu la nouvelle clé.`, confirmLabel: "Effectuer la rotation", danger: true })) return;287 const out = await act(() => post(`/admin/api/keys/${id}/rotate`));288 if (out) { await showSecret("Nouvelle clé après rotation", out.key, out.secret); out.secret = null; }289 }, "btn-ghost"),290 btn("Révoquer", "trash", async () => {291 if (await confirmDialog({ title: "Révoquer définitivement cette clé ?", message: `« ${k.name} » (${k.prefix}…) cessera de fonctionner immédiatement. Cette action est irréversible : une clé révoquée ne peut pas être réactivée.`, confirmLabel: "Révoquer la clé", danger: true })) {292 act(() => post(`/admin/api/keys/${id}/revoke`), "Clé révoquée.");293 }294 }, "btn-danger"));295 }296 return h("article", { class: `item${live ? "" : " is-off"}`, "aria-label": `Clé ${k.name}` },297 h("div", { class: "item-main" },298 h("div", { class: "item-title" }, h("span", { class: "name" }, k.name), pill(sl, sk), pill(PRIORITY[k.priority]?.[0] || k.priority, "", "plain"),299 has(u.active) && u.active > 0 ? pill(`${num(u.active)} en cours`, "info", "live") : null),300 h("div", { class: "item-meta" },301 k.app ? h("span", null, k.app) : null,302 h("span", { class: "mono" }, `${k.prefix}…`),303 h("span", null, `Créée ${rel(k.created_at)}`),304 h("span", null, k.last_used_at ? `Utilisée ${rel(k.last_used_at)}` : "Jamais utilisée"),305 k.expires_at ? h("span", null, `${k.status === "expired" ? "Expirée le" : "Expire le"} ${date(k.expires_at)}`) : null,306 k.revoked_at ? h("span", null, `Révoquée ${rel(k.revoked_at)}`) : null),307 h("div", { class: "item-meta faint" },308 h("span", null, `Modèles : ${listOrAll(k.models, "tous")}`),309 h("span", null, `Endpoints : ${listOrAll(k.endpoints, "tous")}`),310 h("span", null, `Quota jour : ${quota(k.daily_tokens, "jetons")}`),311 h("span", null, `Quota mois : ${quota(k.monthly_tokens, "jetons")}`)),312 k.status !== "revoked" ? h("div", { class: "item-usage" },313 usageBar("Requêtes / min", u.rpm_used ?? 0, k.rpm),314 usageBar("Jetons / min", u.tpm_used ?? 0, k.tpm),315 k.daily_tokens ? usageBar("Jetons aujourd'hui", u.day_tokens ?? 0, k.daily_tokens) : null,316 k.monthly_tokens ? usageBar("Jetons ce mois-ci", u.month_tokens ?? 0, k.monthly_tokens) : null,317 usageBar("Simultanées", u.active ?? 0, k.max_concurrency)) : null),318 h("div", { class: "row-actions" }, actions));319 }320321 function render(d) {322 models = d.models || [];323 const keys = d.keys || [];324 const live = keys.filter((k) => k.status !== "revoked");325 const revoked = keys.filter((k) => k.status === "revoked");326 const toggle = h("input", { type: "checkbox", checked: showRevoked, onchange: (e) => { showRevoked = e.target.checked; render(d); } });327 mount(host,328 card({329 title: `${num(live.length)} clé${live.length > 1 ? "s" : ""}`,330 sub: "Usage en direct, rafraîchi automatiquement",331 actions: revoked.length ? h("label", { class: "check" }, toggle, `Afficher les ${num(revoked.length)} révoquée${revoked.length > 1 ? "s" : ""}`) : null,332 flush: true,333 body: live.length || (showRevoked && revoked.length)334 ? h("div", { class: "items" }, live.map(item), showRevoked ? revoked.map(item) : null)335 : empty("Aucune clé API active", "Créez une clé pour qu'une application puisse appeler l'API.", "key"),336 }));337 }338339 async function refresh() {340 await load(host, () => get("/admin/api/keys"), render);341 }342 refresh();343 ctx.poll(() => (document.querySelector("dialog[open]") || host.querySelector(":focus-visible") ? null : get("/admin/api/keys").then(render)), 8000);344 },345};346