Merge pull request 'v0.3.0: IPv6-Präfixe für DynDNS-Einträge und Dry-Run-Fix' (#4) from alpha-0.3.0 into main
Merge pull request 'v0.3.0: IPv6-Präfixe für DynDNS-Einträge und Dry-Run-Fix' (#4) from alpha-0.3.0 into main
This commit was merged in pull request #4.
This commit is contained in:
commit
f5b8750bd0
4 files changed
+189
-3
No files matched your search
@@ -27,6 +27,7 @@ Der **CrowdSec Manager** ist ein Bash-Script, das:
|
||||
| **Interaktives Menü** | Grafische Administration von CrowdSec via Menü |
|
||||
| **DNS-Auflösung** | Automatische Auflösung von Domains zu IPv4 und IPv6 |
|
||||
| **CIDR-Support** | Ganze Subnetze können allowgelistet werden |
|
||||
| **Dynamische IPv6-Präfixe** | `domain/56` allowlistet das ganze Netz hinter einem DynDNS-Namen (DHCPv6-PD) |
|
||||
| **Auto-Cleanup** | Entfernt IPs die nicht mehr zu konfigurierten Domains gehören |
|
||||
| **Decisions verwalten** | Anzeigen, Suchen, Hinzufügen, Entfernen von Decisions |
|
||||
| **Alerts verwalten** | Anzeigen, Inspizieren, Löschen von Alerts |
|
||||
@@ -151,9 +152,12 @@ ALLOWLIST_ENTRIES=(
|
||||
"203.0.113.50" # Einzelne IP
|
||||
"10.0.0.0/8" # CIDR-Bereich
|
||||
"2001:db8::1" # IPv6
|
||||
"home.example.com/56" # AAAA → ganzes /56 (wechselndes Präfix)
|
||||
)
|
||||
```
|
||||
|
||||
Details zu IPv6-Präfixen: [docs/CONFIGURATION.md](docs/CONFIGURATION.md#ipv6_prefix_length-und-ipv6_prefix_min-ab-v030)
|
||||
|
||||
### Benachrichtigungen
|
||||
|
||||
```bash
|
||||
|
||||
@@ -41,6 +41,10 @@ ALLOWLIST_REASON="allowlist-manager-auto"
|
||||
# - IPv6-Adressen: 2001:db8::1
|
||||
# - CIDR-Notation: 192.168.1.0/24
|
||||
# - CIDR IPv6: 2001:db8::/32
|
||||
# - Domain mit IPv6-Präfix: home.example.com/56
|
||||
# → AAAA-Records werden auf das Netz gekürzt (z. B. 2001:db8:abcd:1200::/56),
|
||||
# A-Records bleiben Einzeladressen. Nützlich für Anschlüsse mit
|
||||
# wechselndem IPv6-Präfix (DHCPv6-PD), siehe IPV6_PREFIX_LENGTH.
|
||||
|
||||
ALLOWLIST_ENTRIES=(
|
||||
# === Domains & Subdomains ===
|
||||
@@ -54,6 +58,9 @@ ALLOWLIST_ENTRIES=(
|
||||
# === CIDR-Bereiche ===
|
||||
# "10.0.0.0/8"
|
||||
# "2001:db8::/32"
|
||||
|
||||
# === Domains mit IPv6-Präfix (dynamisches Präfix) ===
|
||||
# "home.example.com/56"
|
||||
)
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
@@ -67,6 +74,17 @@ DNS_SERVER=""
|
||||
# IPv6-Adressen ebenfalls auflösen? (true/false)
|
||||
RESOLVE_IPV6=true
|
||||
|
||||
# Standard-Präfixlänge für aufgelöste IPv6-Adressen (AAAA)
|
||||
# 128 = nur die einzelne Adresse (Standard, bisheriges Verhalten)
|
||||
# 56 = das ganze /56 der Adresse allowlisten (z. B. Heimanschluss mit DHCPv6-PD)
|
||||
# Gilt für alle Domains ohne eigene Angabe. Einzelne Einträge können
|
||||
# das mit "domain/NN" überschreiben (siehe ALLOWLIST_ENTRIES).
|
||||
IPV6_PREFIX_LENGTH=128
|
||||
|
||||
# Kleinste erlaubte IPv6-Präfixlänge (Schutz vor zu großen Freigaben)
|
||||
# Einträge mit kürzerem Präfix (z. B. /32 = ganzer Provider) werden abgelehnt.
|
||||
IPV6_PREFIX_MIN=48
|
||||
|
||||
# DNS-Auflösungs-Timeout in Sekunden
|
||||
DNS_TIMEOUT=5
|
||||
|
||||
|
||||
+134
-3
@@ -17,7 +17,7 @@ set -euo pipefail
|
||||
# ----------------------------------------------------------------------------
|
||||
SCRIPT_NAME="$(basename "$0")"
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
SCRIPT_VERSION="0.2.2"
|
||||
SCRIPT_VERSION="0.3.0"
|
||||
CONFIG_FILE="${SCRIPT_DIR}/config/crowdsec-manager.conf"
|
||||
|
||||
# Farben (werden ggf. deaktiviert wenn nicht im Terminal)
|
||||
@@ -263,12 +263,109 @@ is_domain() {
|
||||
return 1
|
||||
}
|
||||
|
||||
# Domain mit IPv6-Präfixlänge, z. B. "home.example.com/56"
|
||||
# Die Präfixlänge gilt nur für die aufgelösten AAAA-Records.
|
||||
is_domain_with_prefix() {
|
||||
local entry="$1"
|
||||
[[ "$entry" =~ ^[^/]+/[0-9]{1,3}$ ]] || return 1
|
||||
is_domain "${entry%/*}"
|
||||
}
|
||||
|
||||
# Prüft eine IPv6-Präfixlänge gegen den erlaubten Bereich
|
||||
# (IPV6_PREFIX_MIN .. 128). Schützt vor zu großen Freigaben (z. B. /32).
|
||||
is_valid_ipv6_prefix_length() {
|
||||
local len="$1"
|
||||
local min="${IPV6_PREFIX_MIN:-48}"
|
||||
[[ "$len" =~ ^[0-9]{1,3}$ ]] || return 1
|
||||
(( len >= min && len <= 128 ))
|
||||
}
|
||||
|
||||
# Kürzt eine IPv6-Adresse auf ihr Netz und gibt "netz/länge" zurück.
|
||||
# Ausgabe im kanonischen Format nach RFC 5952 (klein, ohne führende Nullen,
|
||||
# längste Null-Folge als "::"), z. B. 2001:db8:abcd:1200::/56
|
||||
ipv6_to_prefix() {
|
||||
local ip="${1,,}"
|
||||
local len="$2"
|
||||
local -a groups=()
|
||||
local i
|
||||
|
||||
# "::" auf 8 Gruppen expandieren
|
||||
if [[ "$ip" == *"::"* ]]; then
|
||||
local head="${ip%%::*}" tail="${ip#*::}"
|
||||
local -a h=() t=()
|
||||
[[ -n "$head" ]] && IFS=':' read -ra h <<< "$head"
|
||||
[[ -n "$tail" ]] && IFS=':' read -ra t <<< "$tail"
|
||||
local missing=$(( 8 - ${#h[@]} - ${#t[@]} ))
|
||||
(( missing < 1 )) && return 1
|
||||
groups=("${h[@]}")
|
||||
for (( i = 0; i < missing; i++ )); do groups+=("0"); done
|
||||
groups+=("${t[@]}")
|
||||
else
|
||||
IFS=':' read -ra groups <<< "$ip"
|
||||
fi
|
||||
(( ${#groups[@]} == 8 )) || return 1
|
||||
|
||||
# Hostanteil ausmaskieren
|
||||
local -a net=()
|
||||
local bits remaining="$len"
|
||||
for (( i = 0; i < 8; i++ )); do
|
||||
[[ "${groups[$i]}" =~ ^[0-9a-f]{1,4}$ ]] || return 1
|
||||
local val=$(( 16#${groups[$i]} ))
|
||||
if (( remaining >= 16 )); then
|
||||
bits=16
|
||||
elif (( remaining <= 0 )); then
|
||||
bits=0
|
||||
else
|
||||
bits=$remaining
|
||||
fi
|
||||
local mask=$(( bits == 0 ? 0 : (0xFFFF << (16 - bits)) & 0xFFFF ))
|
||||
net+=( "$(( val & mask ))" )
|
||||
remaining=$(( remaining - 16 ))
|
||||
done
|
||||
|
||||
# Längste Folge von Null-Gruppen (mind. 2) für "::" suchen
|
||||
local best_start=-1 best_len=0 cur_start=-1 cur_len=0
|
||||
for (( i = 0; i < 8; i++ )); do
|
||||
if (( net[i] == 0 )); then
|
||||
(( cur_start < 0 )) && cur_start=$i
|
||||
cur_len=$(( cur_len + 1 ))
|
||||
if (( cur_len > best_len )); then
|
||||
best_start=$cur_start
|
||||
best_len=$cur_len
|
||||
fi
|
||||
else
|
||||
cur_start=-1
|
||||
cur_len=0
|
||||
fi
|
||||
done
|
||||
(( best_len < 2 )) && best_start=-1
|
||||
|
||||
local out=""
|
||||
for (( i = 0; i < 8; i++ )); do
|
||||
if (( i == best_start )); then
|
||||
out+="::"
|
||||
i=$(( i + best_len - 1 ))
|
||||
continue
|
||||
fi
|
||||
[[ -n "$out" && "$out" != *"::" ]] && out+=":"
|
||||
out+=$(printf '%x' "${net[$i]}")
|
||||
done
|
||||
|
||||
echo "${out}/${len}"
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# TEIL 3: DNS-AUFLÖSUNG
|
||||
# ============================================================================
|
||||
|
||||
resolve_domain() {
|
||||
local domain="$1"
|
||||
# Optionale IPv6-Präfixlänge (Standard: IPV6_PREFIX_LENGTH bzw. 128 = Einzeladresse)
|
||||
local v6_prefix="${2:-${IPV6_PREFIX_LENGTH:-128}}"
|
||||
if [[ "$v6_prefix" != "128" ]] && ! is_valid_ipv6_prefix_length "$v6_prefix"; then
|
||||
log "WARN" "Ungültige IPv6-Präfixlänge '$v6_prefix' für '$domain' (erlaubt: /${IPV6_PREFIX_MIN:-48} bis /128) - verwende Einzeladressen"
|
||||
v6_prefix=128
|
||||
fi
|
||||
local resolved_ips=()
|
||||
|
||||
log "DEBUG" "Löse Domain auf: $domain"
|
||||
@@ -299,8 +396,19 @@ resolve_domain() {
|
||||
if [[ -n "$ipv6_results" ]]; then
|
||||
while IFS= read -r ip; do
|
||||
if is_valid_ipv6 "$ip"; then
|
||||
resolved_ips+=("$ip")
|
||||
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip"
|
||||
if (( v6_prefix < 128 )); then
|
||||
local net
|
||||
if net=$(ipv6_to_prefix "$ip" "$v6_prefix"); then
|
||||
resolved_ips+=("$net")
|
||||
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip -> $net"
|
||||
else
|
||||
log "WARN" " IPv6 '$ip' von '$domain' konnte nicht auf /$v6_prefix gekürzt werden"
|
||||
STAT_ERRORS=$((STAT_ERRORS + 1))
|
||||
fi
|
||||
else
|
||||
resolved_ips+=("$ip")
|
||||
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip"
|
||||
fi
|
||||
fi
|
||||
done <<< "$ipv6_results"
|
||||
fi
|
||||
@@ -328,6 +436,21 @@ resolve_all_entries() {
|
||||
log "DEBUG" "Direkter Eintrag: $entry"
|
||||
echo "$entry" >> "$NEW_IPS_FILE"
|
||||
STAT_TOTAL_IPS=$((STAT_TOTAL_IPS + 1))
|
||||
elif is_domain_with_prefix "$entry"; then
|
||||
local domain="${entry%/*}" prefix="${entry##*/}"
|
||||
if ! is_valid_ipv6_prefix_length "$prefix"; then
|
||||
log "WARN" "Ungültige IPv6-Präfixlänge in '$entry' (erlaubt: /${IPV6_PREFIX_MIN:-48} bis /128) - wird übersprungen"
|
||||
STAT_ERRORS=$((STAT_ERRORS + 1))
|
||||
REPORT_MESSAGES+=("WARN: Präfixlänge außerhalb des erlaubten Bereichs: $entry")
|
||||
continue
|
||||
fi
|
||||
local resolved
|
||||
if resolved=$(resolve_domain "$domain" "$prefix"); then
|
||||
while IFS= read -r ip; do
|
||||
echo "$ip" >> "$NEW_IPS_FILE"
|
||||
STAT_TOTAL_IPS=$((STAT_TOTAL_IPS + 1))
|
||||
done <<< "$resolved"
|
||||
fi
|
||||
elif is_domain "$entry"; then
|
||||
local resolved
|
||||
if resolved=$(resolve_domain "$entry"); then
|
||||
@@ -1835,6 +1958,11 @@ load_config() {
|
||||
# shellcheck source=/dev/null
|
||||
source "$CONFIG_FILE"
|
||||
|
||||
# Kommandozeilen-Optionen haben Vorrang vor der Konfigurationsdatei
|
||||
# (sonst würde z. B. DRY_RUN=false aus der Config ein --dry-run aushebeln)
|
||||
[[ -n "${CLI_DRY_RUN:-}" ]] && DRY_RUN="$CLI_DRY_RUN"
|
||||
[[ -n "${CLI_LOG_LEVEL:-}" ]] && LOG_LEVEL="$CLI_LOG_LEVEL"
|
||||
|
||||
if [[ -n "${LOG_FILE:-}" ]]; then
|
||||
local log_dir
|
||||
log_dir="$(dirname "$LOG_FILE")"
|
||||
@@ -1886,14 +2014,17 @@ main() {
|
||||
;;
|
||||
-d|--dry-run)
|
||||
DRY_RUN=true
|
||||
CLI_DRY_RUN=true
|
||||
shift
|
||||
;;
|
||||
-v|--verbose)
|
||||
LOG_LEVEL="DEBUG"
|
||||
CLI_LOG_LEVEL="DEBUG"
|
||||
shift
|
||||
;;
|
||||
-q|--quiet)
|
||||
LOG_LEVEL="ERROR"
|
||||
CLI_LOG_LEVEL="ERROR"
|
||||
shift
|
||||
;;
|
||||
-l|--list)
|
||||
|
||||
@@ -169,6 +169,39 @@ RESOLVE_IPV6=true # IPv4 + IPv6
|
||||
RESOLVE_IPV6=false # Nur IPv4
|
||||
```
|
||||
|
||||
### `IPV6_PREFIX_LENGTH` und `IPV6_PREFIX_MIN` (ab v0.3.0)
|
||||
|
||||
Viele Heimanschlüsse bekommen ihr IPv6-Präfix per DHCPv6-PD und es wechselt regelmäßig (oft nachts). Die Clients dahinter nutzen wechselnde Privacy-Adressen in mehreren /64-Netzen. Eine einzelne aufgelöste Adresse reicht dann nicht, um das ganze Netz zu allowlisten.
|
||||
|
||||
Mit einer Präfixlänge wird jede aufgelöste AAAA-Adresse auf ihr Netz gekürzt und als CIDR eingetragen:
|
||||
|
||||
```bash
|
||||
IPV6_PREFIX_LENGTH=128 # Standard: nur die einzelne Adresse (bisheriges Verhalten)
|
||||
IPV6_PREFIX_MIN=48 # kürzere Präfixe werden abgelehnt
|
||||
```
|
||||
|
||||
Pro Eintrag geht das auch gezielt, ohne die anderen Domains zu verändern:
|
||||
|
||||
```bash
|
||||
ALLOWLIST_ENTRIES=(
|
||||
"vpn.example.com" # einzelne Adressen (A + AAAA)
|
||||
"home.example.com/56" # A einzeln, AAAA → z. B. 2001:db8:abcd:1200::/56
|
||||
)
|
||||
```
|
||||
|
||||
| Einstellung | Wirkung |
|
||||
|-------------|---------|
|
||||
| `domain` | AAAA mit `IPV6_PREFIX_LENGTH` (Standard 128 = Einzeladresse) |
|
||||
| `domain/NN` | AAAA auf `/NN` gekürzt, A-Records bleiben Einzeladressen |
|
||||
| `NN < IPV6_PREFIX_MIN` | Eintrag wird mit Warnung übersprungen |
|
||||
|
||||
**Hinweise:**
|
||||
|
||||
- Die Präfixlänge gilt nur für IPv6. Für IPv4-Bereiche weiterhin die CIDR-Notation (`10.0.0.0/8`) verwenden.
|
||||
- Der DNS-Name muss auf eine Adresse **innerhalb** des gewünschten Netzes zeigen, z. B. per DynDNS auf die WAN-Adresse des Routers bzw. der Firewall hinter dem Provider-Router. Die WAN-Adresse eines Providerrouters (z. B. myfritz) liegt oft in einem anderen Netz als die Clients.
|
||||
- Wechselt das Präfix, wird beim nächsten Sync das neue Netz eingetragen und das alte entfernt (bei `AUTO_CLEANUP=true`).
|
||||
- Die Ausgabe erfolgt im kanonischen Format nach RFC 5952 (`2001:db8:abcd:1200::/56`), damit der Abgleich mit der bestehenden Allowlist stabil bleibt.
|
||||
|
||||
### `DNS_TIMEOUT` und `DNS_RETRIES`
|
||||
|
||||
```bash
|
||||
|
||||
Reference in new issue
Block a user