Ein aus einer Demo übernommener Monitoring-Stack enthält oft GF_AUTH_ANONYMOUS_ORG_ROLE=Admin und GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin} in docker-compose.yml, eine Datenquelle mit ausgeschriebenem Passwort in provisioning/datasources/datasources.yml und den standardmäßigen secret_key, der alle gespeicherten Datenquellenpasswörter verschlüsselt. Jeder, der Port 3000 erreicht, kann dann Dashboards bearbeiten, sämtliche Datenquellen abfragen und die Zugangsdaten lesen. Dieser Skill findet diese und weitere häufige Grafana- und Prometheus-Fehler vor dem Produktivstart des Stacks und erklärt, wie Sie jeden davon beheben.

Ihr Agent führt einen Scanner für Ihr Projekt aus: grafana.ini und custom.ini, GF_*-Variablen des Grafana-Dienstes in Docker-Compose-Dateien, Grafana-Provisionierungs-YAML (Datenquellen, Kontaktpunkte für Warnmeldungen, ältere Benachrichtigungsdienste, Plugin-Apps) und prometheus.yml. Er liest INI-Dateien wie Grafana (; und # als Kommentare, """..."""-Werte, der letzte Wert hat Vorrang). Deshalb erhält die unveränderte, mit Grafana ausgelieferte grafana.ini, in der alle Einstellungen auskommentiert sind, das Ergebnis NOT FLAGGED. Ein Wert, der an beliebiger Stelle eine Referenz auf $__file{}, $__env{}, $ENV_NAME oder ${ENV_NAME} enthält (etwa Bearer ${LOKI_TOKEN}), oder eine GF_*__FILE-Variable gilt als aus der Datei ausgelagert; ein ausgeschriebener Ersatzwert wie ${VAR:-admin} dagegen nicht. Andere YAML-Dateien im Projekt, einschließlich Values-Dateien von Helm-Charts, werden ignoriert. Der Scanner startet Grafana oder Prometheus niemals und verbindet sich auch nicht damit. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und einem sichereren Vorgehen. Geheimnisse werden niemals ausgegeben.

Was geprüft wird

BLOCKIEREN (vor der Auslieferung beheben)

• G01: admin_password oder GF_SECURITY_ADMIN_PASSWORD mit dem Standardwert admin oder einem ausgeschriebenen Passwort, einschließlich eines Compose-Ersatzwerts wie ${VAR:-admin}

• G02: anonymer Zugriff mit der Rolle Editor oder Admin

• G03: Passwörter, Tokens und Schlüssel in Provisionierungsdateien: Datenquellenfelder password und basicAuthPassword, secureJsonData-Werte, Geheimnisse von Kontaktpunkten, Webhook-URLs für Slack, Discord, Teams und Google Chat sowie Passwörter in URLs

• G04: weitere Zugangsdaten in grafana.ini oder der Umgebung des Grafana-Dienstes: Datenbank- und SMTP-Passwörter, OAuth-client_secret, Passwörter für Cache-Verbindungen, Speicherschlüssel, Renderer-Tokens

PRÜFEN (vor der Veröffentlichung prüfen)

• G11: in der Datei ausgeschriebener secret_key, einschließlich des von Grafana veröffentlichten Standardwerts

• G12: deaktiviertes cookie_secure (oder HTTPS ohne diese Einstellung) und cookie_samesite mit none oder disabled

• G13: allow_embedding = true

• G14: offene Registrierung sowie GitHub-, GitLab- oder Google-Anmeldung ohne Beschränkung auf eine erlaubte Organisation, ein Team, eine Gruppe oder eine Domain

• G15: anonymer Viewer-Zugriff

• G16: Auth-Proxy ohne Whitelist

• G17: in prometheus.yml ausgeschriebene Prometheus-basic_auth-Passwörter, authorization-Zugangsdaten, Bearer-Tokens und Passwörter in URLs

• G18: deaktivierte TLS-Prüfung (insecure_skip_verify, tlsSkipVerify, tls_skip_verify_insecure, skip_verify)

• G19: deaktivierter Brute-Force-Schutz bei der Anmeldung

Lieferumfang

• Der Scanner (Python 3.9+, nur Standardbibliothek)

• Ein Regelhandbuch mit Begründung und sichererem Vorgehen zu jeder Regel

• Ein unsicherer und ein sicherer Beispiel-Monitoring-Stack (grafana.ini, docker-compose.yml, Provisionierung von Datenquellen und Kontaktpunkten, prometheus.yml) sowie der tatsächliche Scanner-Bericht für das unsichere Beispiel

Grenzen

Der Scanner liest jede Datei unverändert und bewertet sie einzeln. Values von Helm-Charts, außerhalb von Compose-Dateien gesetzte Umgebungsvariablen (Kubernetes, systemd, .env-Dateien), in der Grafana-Oberfläche geänderte Einstellungen oder SSO-Einstellungen, ldap.toml, die Alertmanager-Konfiguration und Inhalte von über $__file{} referenzierten Dateien werden nicht erfasst. Daher können andernorts überschriebene Einstellungen gemeldet oder übersehen werden. NOT FLAGGED ist keine Garantie.

Inhalt

Ein ZIP-Archiv mit 17 Dateien: SKILL.md, der Scanner in scripts/ (4 Python-Dateien), references/rules.md (jede Regel mit Begründung und sichererem Vorgehen) und examples/ (10 Beispieldateien sowie report.md, die tatsächliche Scanner-Ausgabe für das unsichere Beispiel).

Verwendung: Dies ist ein Agenten-Skill: ein Ordner mit einer Datei SKILL.md und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacken Sie das Archiv in den Skills-Ordner Ihres Agenten (für Claude Code: ~/.claude/skills/), und bitten Sie Ihren Agenten anschließend, Ihr Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich Ihre Dateien: kein Netzwerkzugriff, keine Datenübertragung.