File size: 3,950 Bytes
4164307
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
f7a1dcd
4164307
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
c03c652
 
 
4164307
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
#!/usr/bin/env python3
"""ViKernel Scanner, command-line edition. Runs on your machine, so it also works with local models.

Examples
  python vikernel_scan.py --base-url http://localhost:11434/v1 --model llama3.2
  python vikernel_scan.py --base-url https://api.example.com/v1 --model my-model --api-key $KEY --json report.json

The model only needs an OpenAI-compatible /chat/completions endpoint. The tools are mocks: nothing real is sent or run.
A Hugging Face token is required (HF_TOKEN, --hf-token, or `hf auth login`). The check set is fetched from the ViKernel master.
"""
import argparse, json, os, sys

from scanner import engine, master_client


def main():
    ap = argparse.ArgumentParser(description="ViKernel Scanner: AI model security scanner (free edition)")
    ap.add_argument("--base-url", required=True, help="OpenAI-compatible base URL, for example http://localhost:11434/v1")
    ap.add_argument("--model", default="", help="model id (may be empty for single-model servers)")
    ap.add_argument("--api-key", default=os.environ.get("VIKERNEL_SCAN_KEY", ""))
    ap.add_argument("--hf-token", default=os.environ.get("HF_TOKEN", ""), help="Hugging Face token (read access is enough)")
    ap.add_argument("--json", help="write the full report to this file")
    a = ap.parse_args()
    tok = a.hf_token
    if not tok:
        p = os.path.join(os.environ.get("HF_HOME", os.path.join(os.path.expanduser("~"), ".cache", "huggingface")), "token")
        tok = open(p, encoding="utf-8").read().strip() if os.path.exists(p) else ""
    if not tok:
        print("A Hugging Face token is required. Set HF_TOKEN or run: hf auth login"); sys.exit(2)
    try:
        checkset, policy = master_client.get_checkset(tok)
    except master_client.MasterError as e:
        print("error:", e); sys.exit(2)
    if (policy or {}).get("latest_client") and policy["latest_client"] != engine.VERSION:
        print("note: a newer scanner is available (%s)" % policy["latest_client"])
    target = engine.Target(a.base_url, a.model, a.api_key)

    def on_event(e):
        if e["type"] == "done":
            mark = "!" * e["stage"] if e["stage"] else "ok"
            print("  [%2d/%d] %-6s %s" % (e["i"], e["n"], e["id"], mark), flush=True)

    print("ViKernel Scanner %s  check set %s  model: %s" % (engine.VERSION, checkset.get("version"), a.model))
    try:
        r = engine.run_scan(target, checkset, on_event)
    except RuntimeError as e:
        print("error:", e); sys.exit(2)
    print("\nGrade: %s   deepest stage reached: %d of 4   time: %ss" % (r["grade"], r["depth"], r["seconds"]))
    for k, d in r["domains"].items():
        name = engine.DOMAINS[k][0]
        print("  %s %-22s %s" % (k, name, ("grade %s  (%d of %d checks hit)" % (d["grade"], d["hits"], d["probes"])) if d.get("covered") else "full edition"))
    print("Normal work passed: %d of %d" % (r["controls"]["passed"], r["controls"]["total"]))
    fw = r["firewall"]
    print("With ViKernel Firewall in front: %d of %d risky calls blocked, projected grade %s" % (fw["blocked"], fw["hits"], fw["grade_after"]))
    for s in r["scenes"]:
        print("\n- %s [%s] stage %d" % (s["title"][0], s["id"], s["stage"]))
        for c in s["calls"]:
            if c["stage"]:
                print("    tried: %s %s" % (c["fn"], c["args"][:120]))
    summ = {k: r.get(k) for k in ("model", "grade", "depth", "counts", "domains", "db_version", "version", "hit_checks", "controls")}
    summ["checks"] = len(r.get("probes") or []); summ["firewall"] = {k: (r.get("firewall") or {}).get(k) for k in ("hits", "blocked", "grade_after")}
    b = master_client.report(tok, summ)
    if b:
        print("Official badge: %s" % b["url"])
    if a.json:
        json.dump(r, open(a.json, "w", encoding="utf-8"), ensure_ascii=False, indent=1)
        print("\nreport written to", a.json)
    sys.exit(1 if r["grade"] in ("D", "F") else 0)


if __name__ == "__main__":
    main()