API Discovery Overview
Elchi API Discovery builds an API inventory from Envoy access logs: confirmed endpoints, risk, PII and auth detection, spec coverage, drift and OpenAPI export.
Discovery Dashboards
The API Discovery dashboards: listeners, new APIs, auth coverage, bots, PII, zombie APIs, risk, security score, errors, drift, consumers, specs and teams.
Exploring Endpoints
The per-listener endpoints view in API Discovery: confirmed vs attack surface, path grouping, GraphQL operations, filters, two-axis risk scores and CSV export.
Risk Scoring: Threat vs Exposure
The API Discovery two-axis risk model: threat vs exposure, severity weights, active vs lifetime scores, the 0-100 Security Score and how to prioritize fixes.
Risk Flags Reference
Every API Discovery risk flag by class, with severity, risk axis, OWASP API Top 10 mapping, meaning and remediation, and how active and historical flags work.
PII, Auth & Consumers
How API Discovery detects PII in paths and query strings, infers auth schemes and consumers, and keeps a metadata-only privacy model with per-detector switches.
Consumers & Enumeration
Per-consumer API behaviour in API Discovery: machine vs human callers, new consumers, enumeration, scraping and auth-failure signals, BOLA and BFLA detectors.
Path Normalization
How API Discovery turns high-cardinality request paths into stable operations: built-in detectors, learned templating, the merge job and operator rules.
OpenAPI Export
Turn the traffic-derived API inventory into an OpenAPI 3.x document — and feed it into Shield's positive-security enforcement.
OpenAPI Specs & Coverage
Import OpenAPI or Swagger specs, scope them to listeners and paths, and compare them with observed traffic: undocumented, unused, deprecated-in-use and drift.
Drift & Snapshots
Daily snapshots of your confirmed API surface and the change feed against them: new and removed operations, auth downgrades, new PII, risk rises and zombies.
Ownership & Teams
Assign teams, owners, criticality, data classes and tags to discovered API endpoints with ordered rules and overrides, and see per-team risk on the Teams tab.
Suggest a Shield Policy
Turn a discovered API inventory into a draft Shield SecurityPolicy, the bridge from Elchi API Discovery to API security enforcement at the Envoy edge.
Collector Configuration
The elchi-collector runtime config: header policy, ingest exclusions, path normalization, PII switches, TLS proxies, GraphQL and detector thresholds.
Threat Intelligence & GeoIP
How the elchi-collector enriches API Discovery events: GeoIP country and ASN tags, User-Agent classification and threat-intel blocklist matches.
Collector Reference
Complete reference for the elchi-collector — bootstrap environment variables, ports, Prometheus metrics, ClickHouse and MongoDB schema, and Envoy ALS wiring.