Argus Dokumentasjon

Om Argus

Argus er et CLI-verktøy som reviderer Bitbucket Server/Data Center-repositories mot beste praksis innen sikkerhet, governance og DevOps-modenhet. Verktøyet kobler til Bitbucket via REST API, kjører et sett med automatiserte sjekker på alle repos i valgte prosjekter, og genererer en detaljert rapport.

Prosjektet består av to deler:

• bitbucket-audit/ — CLI-verktøyet (Node.js) som utfører skanning og produserer rapporter
• frontend/ — Nettleser-dashboard for visuell utforskning av resultater

Dashboardet kjører 100 % i nettleseren — ingen data lastes opp til noen server. Alt forblir lokalt.

Hurtigstart

Krav: Node.js 18 eller nyere.

cd bitbucket-audit
npm install

# Kopier eksempelfilen og fyll inn din Bitbucket-URL:
cp .env.example .env

# Kjør — du blir spurt om token første gang:
node index.js

Rapporten skrives til reports/audit-<tidsstempel>.json og reports/audit-<tidsstempel>.md. Åpne JSON-filen i dashboardet for visuell analyse.

Konfigurasjon

Argus konfigureres via miljøvariabler i .env-filen:

Sjekker

Argus kjører 13 automatiserte sjekker gruppert i fire kategorier. Hver sjekk returnerer bestått, avvik (med anbefaling), eller ikke aktuelt.

Sikkerhet og avhengigheter

Governance og prosess

DevOps-modenhet

Kodekvalitet

Dashboard

Dashboardet er en statisk nettside som leser Argus-rapporter (JSON) i nettleseren. Ingen data sendes over nett — alt prosesseres lokalt. Dra og slipp en rapportfil, eller klikk «Last inn rapport».

Oversikt

Hovedvisningen gir et overblikk over hele porteføljen:

• KPI-kort: Totalt antall repos, repos som trenger tiltak, gjennomsnittlig sjekkdekning, antall sjekker med avvik
• Dekninsdiagram: Horisontale søyler per sjekk, sortert etter lavest dekning, fargekodiert (grønn ≥80 %, gul ≥40 %, rød <40 %)
• Prosjektsammenbrudd: Klikkbare kort per Bitbucket-prosjekt — viser antall repos og avvik, fargekodet etter alvorlighetsgrad
• Sjekksammenbrudd: Kort per sjekk med antall avvik og dekning-%, klikkbart for filtrering
• Prioritert tiltaksliste: Tabell over repoene med flest anbefalte tiltak — start her for størst effekt. Viser prioritetsnivå, reponavn, avvikende sjekker som badges, og tiltakstelling

Sårbarheter

CVE-utforsker inspirert av Datadog Code Security:

• Sidepanel med filtre: Filtrer på alvorlighetsgrad (Critical/High/Medium/Low), økosystem (npm/Maven/PyPI/Go), prosjekt og fiks-tilgjengelighet
• Søkefelt: Søk etter CVE-ID, pakkenavn, reponavn eller CVSS-score
• Sårbarhetskort: Viser severity-badge, CVSS-score, sammendrag, berørt pakke med versjon, fiks-status, og lenker til OSV.dev/NVD/GitHub Advisories
• Detaljpanel: Klikk på en sårbarhet for å se fullstendig informasjon — berørte repos, referanselenker, aliaser, og fiks-versjon
• Eksporter issues: Last ned filtrerte issues som JSON i samme struktur som rapportinnlasting bruker

Repositories

Full matrise over alle repos med status-ikoner per sjekk:

• ✓ = bestått
• ! = avvik med anbefalt tiltak
• ✕ = avvik uten tiltak
• – = ikke aktuelt

Klikk på en rad for å åpne repo-detaljpanelet med fullstendig vurdering per sjekk.

Handlingskort (Remediation)

Når du åpner detaljpanelet for et repo med avvik, vises handlingskort under hver feilet sjekk. Kortene inneholder:

• Alvorlighetsgrad — Fargekodet badge (critical, high, medium, low)
• Begrunnelse — Hvorfor dette avviket er et sikkerhetsproblem
• Steg-for-steg-oppskrift — Konkrete tiltak med kommandoer for å fikse avviket
• Dokumentasjonslenke — Direkte lenke til relevant ekstern ressurs

Klikk på «Slik fikser du dette» for å ekspandere kortet. Kortene er sammenleggbare slik at panelet ikke oversvømmes med informasjon.

Rapportformat

CLI-verktøyet genererer to filer per kjøring:

• JSON (audit-<tidsstempel>.json) — Maskinlesbar rapport for dashboardet og videre prosessering
• Markdown (audit-<tidsstempel>.md) — Menneskelesbar rapport egnet for Confluence, e-post, eller Git

JSON-rapporten inneholder:

{
  "generatedAt": "2026-04-11T10:30:00.000Z",
  "checks": ["renovate", "dep-vulns", ...],
  "summary": {
    "total": 142,
    "byCheck": {
      "renovate": {
        "passed": 37,
        "failed": 105,
        "coveragePercent": 26.1
      }
    }
  },
  "repos": [
    {
      "project": "PLATTFORM",
      "repo": "atlas-api",
      "checks": { "renovate": true, "dep-vulns": false },
      "assessments": { "dep-vulns": "Fant 3 HIGH-sårbarheter..." },
      "vulnerabilities": [...]
    }
  ]
}

Sikkerhet og tokens

Argus bruker et Bitbucket Personal Access Token (PAT) for autentisering. Tokenet håndteres sikkert:

• Windows: Kryptert med DPAPI og lagret i ~/.argus/token.enc
• macOS: Lagret i Keychain via security-kommandoen
• Linux: Lagret via freedesktop Secret Service (secret-tool)

Tokenet sendes kun som Bearer-token i Authorization-headeren — aldri i URL. HTTPS er påkrevd.

Dashboardet laster kun lokale filer — ingen API-kall eller dataoverføring.

Kildekode

Argus er åpen kildekode under MIT-lisensen.

github.com/FrankBurmo/argus