# 1. Tailscale-API-Anmeldeinformationen festlegen
export TS_API_KEY="tskey-api-..."

# 2. Audit ausführen
tailsnitch

# 3. Nur Ergebnisse mit hohem Schweregrad anzeigen
tailsnitch --severity high

# 4. Probleme ~interaktiv~ im Yolo-Modus beheben
tailsnitch --fix

sudo xattr -rd com.apple.quarantine tailsnitch

go install github.com/Adversis/tailsnitch@latest

git clone https://github.com/Adversis/tailsnitch.git
cd tailsnitch
go build -o tailsnitch .

export TS_OAUTH_CLIENT_ID="..."
export TS_OAUTH_CLIENT_SECRET="tskey-client-..."

export TS_API_KEY="tskey-api-..."

# Vollständiges Audit ausführen
tailsnitch

# Auch bestandene Prüfungen anzeigen (ausführlich)
tailsnitch --verbose

# Ausgabe als JSON zur Weiterverarbeitung
tailsnitch --json

# Ein bestimmtes Tailnet auditieren (wenn der OAuth-Client Zugriff auf mehrere hat)
tailsnitch --tailnet mycompany.com

# Nur kritische und hohe Probleme anzeigen
tailsnitch --severity high

# Nach Kategorie filtern
tailsnitch --category access    # ACL-Probleme
tailsnitch --category auth      # Authentifizierung & Schlüssel
tailsnitch --category device    # Gerätesicherheit
tailsnitch --category network   # Netzwerkexposition
tailsnitch --category ssh       # SSH-Regeln
tailsnitch --category log       # Protokollierung & Verwaltung

# Nur bestimmte Prüfungen ausführen
tailsnitch --checks ACL-001,AUTH-001,DEV-010
tailsnitch --checks stale-devices,tailnet-lock-not-enabled

# Alle verfügbaren Prüfungen auflisten
tailsnitch --list-checks

# Interaktiver Korrekturmodus
tailsnitch --fix

# Vorschau, was behoben würde (Probelauf)
tailsnitch --fix --dry-run

# Sichere Korrekturen automatisch auswählen (erfordert dennoch Bestätigung)
tailsnitch --fix --auto

# Audit-Protokollierung von Korrekturaktionen deaktivieren
tailsnitch --fix --no-audit-log

# Als JSON exportieren
tailsnitch --soc2 json > soc2-evidence.json

# Als CSV exportieren (für Tabellenkalkulationen)
tailsnitch --soc2 csv > soc2-evidence.csv

resource_type,resource_id,resource_name,check_id,check_title,cc_codes,status,details,tested_at
device,node123,prod-server,DEV-001,Getaggte Geräte mit deaktiviertem Schlüsselablauf,CC6.1;CC6.3,PASS,Tags: [tag:server] Schlüsselablauf aktiviert,2025-01-05T10:30:00Z
key,tskey-auth-xxx,tskey-auth-xxx,AUTH-001,Wiederverwendbare Authentifizierungsschlüssel vorhanden,CC6.1;CC6.2;CC6.3,FAIL,Wiederverwendbarer Schlüssel läuft in 45 Tagen ab,2025-01-05T10:30:00Z

# .tailsnitch-ignore
# Informative Prüfungen ignorieren
ACL-008  # Wir verwenden absichtlich keine Gruppen
ACL-009  # Legacy-ACLs sind für unseren Anwendungsfall in Ordnung

# Bestimmte mittlere Prüfungen mit Begründung ignorieren
DEV-006  # Externe Geräte sind genehmigte Auftragnehmer
LOG-001  # Flow-Protokolle erfordern Enterprise-Plan

# Eine bestimmte Ignore-Datei verwenden
tailsnitch --ignore-file /pfad/zur/ignore

# Verarbeitung der Ignore-Datei vollständig deaktivieren
tailsnitch --no-ignore

# Vollständigen Bericht exportieren
tailsnitch --json > audit.json

# Fehlgeschlagene Prüfungen als TSV extrahieren
tailsnitch --json | jq -r '
  .suggestions
  | map(select(.pass == false))
  | .[]
  | [.id, .title, .severity, .remediation]
  | @tsv
' > findings.tsv

# Zusammenfassung nach Schweregrad
tailsnitch --json | jq '
  .suggestions
  | map(select(.pass == false))
  | group_by(.severity)
  | map({severity: .[0].severity, count: length})
'

# Kritische/hohe Probleme mit Admin-Links auflisten
tailsnitch --json | jq -r '
  .suggestions
  | map(select(.pass == false and (.severity == "CRITICAL" or .severity == "HIGH")))
  | .[]
  | "\(.id): \(.title)\n  Fix: \(.fix.admin_url // "manual")\n"
'

+=====================================================================+
|                    TAILSNITCH SICHERHEITSAUDIT                      |
|            Tailnet: example.com                                     |
|            Version: 1.0.0 (Build: abc123)                           |
+=====================================================================+

  Verwendete Ignore-Datei: .tailsnitch-ignore (3 Regeln)

=== ZUGRIFFSKONTROLLEN ===================================================

[KRITISCH] ACL-001: Standardrichtlinie 'allow all' aktiv
  Ihre ACL-Richtlinie enthält das Feld 'acls' nicht. Tailscale wendet
  eine Standardrichtlinie 'allow all' an, die allen Geräten vollen Zugriff gewährt.

  Abhilfe:
  Definieren Sie explizite ACL-Regeln nach dem Prinzip der geringsten Privilegien.

  Quelle: https://tailscale.com/kb/1192/acl-samples
----------------------------------------------------------------------

=== AUTHENTIFIZIERUNG & SCHLÜSSEL =============================================

[HOCH] AUTH-001: Wiederverwendbare Authentifizierungsschlüssel vorhanden
  2 wiederverwendbare Authentifizierungsschlüssel gefunden. Diese können bei Kompromittierung
  zum Hinzufügen mehrerer Geräte wiederverwendet werden.

  Details:
    - Schlüssel tskey-auth-xxx (läuft in 45 Tagen ab)
    - Schlüssel tskey-auth-yyy (läuft in 89 Tagen ab)

  Abhilfe:
  Bewahren Sie wiederverwendbare Schlüssel in einem Secrets-Manager auf. Bevorzugen Sie Einmalschlüssel.

  Quelle: https://tailscale.com/kb/1085/auth-keys
----------------------------------------------------------------------

ZUSAMMENFASSUNG
======================================================================
  Kritisch: 1  Hoch: 3  Mittel: 5  Niedrig: 2  Info: 8
  Gesamtergebnisse: 19  |  Bestanden: 33

# Bei Bedarf benutzerdefinierten Tailscale-Binärpfad angeben
tailsnitch --tailscale-path /opt/tailscale/bin/tailscale
## CI/CD-Integration

Führen Sie Tailsnitch in CI/CD-Pipelines aus, um Sicherheitsregressionen zu erkennen:

```yaml
# GitHub Actions-Beispiel
- name: Tailscale-Sicherheit auditieren
  env:
    TS_OAUTH_CLIENT_ID: ${{ secrets.TS_OAUTH_CLIENT_ID }}
    TS_OAUTH_CLIENT_SECRET: ${{ secrets.TS_OAUTH_CLIENT_SECRET }}
  run: |
    tailsnitch --json > audit.json
    # Fehlschlagen, wenn kritische oder hohe Probleme vorhanden sind
    if tailsnitch --severity high --json | jq -e '.summary.critical + .summary.high > 0' > /dev/null; then
      echo "Kritische oder hohe Probleme gefunden!"
      tailsnitch --severity high
      exit 1
    fi