SPB Git

Repository Public

keys.js 20.9 KB 346 lines javascript

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
Files main
Menu

Theme