Sari la conținut

Pornește și citește scanări WordPress

Pornește o scanare WP PerformanceShield pe un site prin API, așteaptă să se termine și citește scorul, constatările și vulnerabilitățile.

Ghidul arată cum pornești prin API o scanare de securitate WordPress pe un site, cum o aștepți și cum îi citești rezultatul. Folosește aceleași operații ca panoul.

  • O cheie API cu scope-ul wpscan:read pentru a citi rezultatele și wpscan:write pentru a porni o scanare (scope-uri). Cheia nu poate face niciodată mai mult decât utilizatorul ei: un revânzător sau un client ajunge doar la site-urile propriilor conturi.
  • Id-ul site-ului. Listează site-urile unui cont cu GET /api/v1/accounts/{account_id}/sites și ia id-ul site-ului WordPress.
  • Un server al cărui agent poate scana. Dacă nu poate, sumarul arată "supported": false, iar pornirea unei scanări răspunde 409 wpscan_unsupported_agent.
export PLUSPANEL_URL="https://panel.example.com"
export PLUSPANEL_API_KEY="ppk_…"
export SITE_ID="6b6b6b6b-1111-4222-8333-444455556666"

POST /api/v1/sites/{id}/wpscan/scans pune o scanare în coadă și răspunde imediat 202; scanarea rulează mai târziu pe server. Corpul este opțional: mode este full (implicit: verificările de integritate plus cele de malware pe toate fișierele) sau integrity (verificarea zilnică, mai ușoară).

curl -fsS -X POST "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan/scans" \
  -H "Authorization: Bearer $PLUSPANEL_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"mode": "full"}'
{
  "queued": true,
  "scan": {
    "id": "7c7c7c7c-1111-4222-8333-444455556666",
    "site_id": "6b6b6b6b-1111-4222-8333-444455556666",
    "mode": "full",
    "reason": "on_demand",
    "state": "queued",
    "requested_at": "2026-11-14T10:02:11Z"
  }
}

Păstrează scan.id:

export SCAN_ID="7c7c7c7c-1111-4222-8333-444455556666"

Pe un server rulează o singură scanare o dată, deci una în coadă își poate aștepta rândul. Trimite un Idempotency-Key, ca o reîncercare să nu pună în coadă o a doua scanare.

GET /api/v1/wpscan/scans/{id} întoarce scanarea și, după ce s-a terminat, raportul ei. Scanarea trece prin queued, delivering și running până la o stare finală: complete, partial (terminată cu un rezultat parțial), failed sau cancelled. Interoghează la câteva secunde, sau la un minut pentru un site mare.

until state=$(curl -fsS "$PLUSPANEL_URL/api/v1/wpscan/scans/$SCAN_ID" \
  -H "Authorization: Bearer $PLUSPANEL_API_KEY" | jq -r .scan.state) \
  && case "$state" in complete|partial|failed|cancelled) true ;; *) false ;; esac; do
  sleep 10
done
echo "$state"

Câmpurile utile din scan:

  • score (0–100) și grade (de la A la F), completate la sfârșitul scanării; până atunci score este null și grade este gol.
  • findings_total și vulnerabilities_total: ce a găsit scanarea.
  • started_at și finished_at.
  • error și error_code când starea este failed.

Istoricul scanărilor unui site este GET /api/v1/sites/{id}/wpscan/scans (cele mai noi primele; parcurgi paginile cu limit și before, adică requested_at al ultimei scanări primite).

GET /api/v1/sites/{id}/wpscan este imaginea curentă a site-ului: scorul se calculează pe elementele care sunt deschise acum, deci se schimbă când repari sau ignori ceva.

curl -fsS "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan" \
  -H "Authorization: Bearer $PLUSPANEL_API_KEY" \
  | jq '{scored, score, grade, scanned_at, open_findings, open_vulnerabilities, running: .running.state}'
{
  "scored": true,
  "score": 82,
  "grade": "B",
  "scanned_at": "2026-11-14T10:04:40Z",
  "open_findings": { "high": 1, "low": 2 },
  "open_vulnerabilities": { "critical": 1 },
  "running": null
}
  • scored este false, iar score este null, până când o scanare s-a terminat complet.
  • open_findings și open_vulnerabilities numără elementele deschise după severitate (info, low, medium, high, critical).
  • last_scan este ultima scanare terminată, running este cea aflată în coadă sau în desfășurare, dacă există.
  • quarantined și quarantined_bytes descriu carantina site-ului; settings conține cele trei comutatoare de reparare automată.
  • feed.attribution și attribution din răspunsul cu vulnerabilități conțin notificări pe care trebuie să le afișezi lângă înregistrările de vulnerabilități, dacă le afișezi în propriul instrument.

GET /api/v1/sites/{id}/wpscan/findings listează ce a găsit scanarea în fișierele și în baza de date a site-ului, începând cu cele mai severe. Filtre: state (open, resolved, quarantined, ignored), category și severity (severitatea minimă).

curl -fsS -G "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan/findings" \
  -H "Authorization: Bearer $PLUSPANEL_API_KEY" \
  --data-urlencode "state=open" --data-urlencode "severity=medium" \
  | jq '.items[] | {id, severity, category, path, component}'

O constatare are un id, o severity, o category, path (calea fișierului), component (componenta din care face parte: kind core, plugin sau theme, cu slug și version), o state și două marcaje, quarantinable și reinstallable, care arată ce reparații se aplică.

GET /api/v1/sites/{id}/wpscan/vulnerabilities listează vulnerabilitățile cunoscute ale nucleului, plugin-urilor și temelor instalate, cu title, severity, cvss, cve, installed_version, fixed_in și state (open, fixed, ignored). Primește filtrul state.

Același grup de operații și repară: actualizează o componentă, pune în carantină sau reinstalează fișiere, ignoră un element și schimbă setările de reparare automată. Acestea cer wpscan:write; vezi referința API, secțiunea wpscan.

Status Cod Ce înseamnă
401 invalid_api_key Cheia lipsește, a expirat sau a fost revocată.
403 Cheia nu are scope wpscan, sau utilizatorul nu poate folosi site-ul.
404 Site-ul sau scanarea nu există ori nu este vizibilă pentru tine.
409 edition_limit_reached Ediția Free: o scanare la cerere pe site pe zi UTC. Câmpul limit al răspunsului este wpscan_on_demand_daily.
429 wpscan_rate_limited Pro și Enterprise: o scanare la cerere pe site la fiecare 10 minute. Retry-After spune când poți reîncerca.
409 wpscan_unsupported_agent Agentul serverului nu suportă scanarea.

Erorile sunt problem details: decide după code.

Nu se trimite niciun eveniment webhook la sfârșitul unei scanări: interoghează scanarea ca la pasul 2. Alertele declanșate de regulile tale de alertă se trimit ca alert.firing și alert.resolved (lista evenimentelor).