Pattern-Hilfe
Verfügbare Platzhalter:
N: Ziffer 2–9
X: Ziffer 0–9
Z: Ziffer 1–9
[ ]: Definiert einen Bereich erlaubter Ziffern (z.B. [2-5])
'.': Mindestens eine beliebige Ziffer
'!': 0 oder mehr beliebige Ziffern
Ziffern (0–9) oder Zeichen (+,*,#) müssen exakt passen
Beispiel: NXX. bedeutet: Erste Ziffer 2–9, dann zwei Ziffern 0–9, dann mind. eine weitere beliebige Ziffer.
DE: Die Berechnung/Prüfung erfolgt direkt per JavaScript in Ihrem Browser. Es werden keine eingegebenen Daten an den Server übermittelt. EN: The calculation/validation is performed directly using JavaScript in your browser. No entered data is transmitted to the server.
Grundlagen der Match Patterns
Match Patterns sind essenzielle Regeln in FreePBX, die festlegen, wie eingehende und ausgehende Anrufe basierend auf den gewählten Nummern verarbeitet werden. Durch die korrekte Definition von Match Patterns können Sie sicherstellen, dass Anrufe effizient weitergeleitet, an die richtigen Abteilungen verteilt oder spezielle Dienste aktiviert werden.
Platzhalter und Sonderzeichen
FreePBX bietet eine Vielzahl von Platzhaltern und Sonderzeichen, die in Match Patterns verwendet werden, um flexible und präzise Regeln zu erstellen. Die folgende Tabelle gibt einen Überblick über die wichtigsten Platzhalter:
| Platzhalter | Bedeutung | Beschreibung |
|---|---|---|
N | Ziffer zwischen 2 und 9 | Erlaubt nur die Ziffern 2 bis 9 an dieser Position. |
Z | Ziffer zwischen 1 und 9 | Erlaubt nur die Ziffern 1 bis 9 an dieser Position. |
X | Jede Ziffer von 0 bis 9 | Erlaubt alle Ziffern (0-9) an dieser Position. |
. | Eine oder mehrere beliebige Ziffern | Erlaubt eine beliebige Anzahl von Ziffern oder Zeichen an dieser Stelle. |
! | Null oder mehr beliebige Ziffern | Erlaubt keine oder eine beliebige Anzahl von Ziffern oder Zeichen an dieser Stelle. |
[ ] | Bereich definierter Ziffern oder Zeichen | Definiert eine Gruppe von erlaubten Ziffern oder Zeichen, z.B. [2-5] erlaubt die Ziffern 2, 3, 4 und 5. |
| 1, 2, 3, 4, etc. | Ganze Zahl (genaugenommen kein Platzhalter) | Prüft, ob die Zahl an der jeweiligen Position des Patterns übereinstimmt. |
+, *, # | Feste Zeichen (genaugenommen kein Platzhalter) | Diese Zeichen müssen exakt übereinstimmen und sind feste Bestandteile des Musters. |
Warnung: Vermeidung von Mustern, die nur aus ! oder . bestehen
Die Verwendung von Mustern, die ausschließlich aus ! oder . bestehen, sollte vermieden werden. Solche Muster sind extrem breit gefasst und können unbeabsichtigte Anrufe zulassen oder blockieren, was zu Sicherheitsrisiken und unerwünschten Anrufweiterleitungen führen kann.
Gründe zur Warnung:
- Sicherheitsrisiko: Muster wie
!oder.können dazu führen, dass unerwünschte oder bösartige Anrufe ins System gelangen, da keine spezifischen Beschränkungen vorhanden sind. - Fehlende Kontrolle: Solche Muster bieten keine Kontrolle über die Anrufweiterleitung, was zu einer Überflutung des Systems mit Anrufen führen kann.
- Verwaltungsschwierigkeiten: Die Nachverfolgung und Verwaltung von Anrufen wird erschwert, da keine klaren Regeln definiert sind.
- Unerwünschte Weiterleitungen: Anrufe können an falsche oder unerwünschte Ziele weitergeleitet werden, was die Benutzererfahrung beeinträchtigt.
Empfehlung: Verwenden Sie stets spezifische Muster, die genau definieren, welche Nummern erlaubt oder blockiert werden sollen. Vermeiden Sie die Nutzung von ! oder . als alleinige Musterbestandteile, um die Sicherheit und Effizienz Ihres Telefonsystems zu gewährleisten.
Unterschied zwischen Match Patterns mit und ohne Unterstrich (_)
Der Unterstrich (_) spielt eine entscheidende Rolle bei der Definition von Match Patterns in FreePBX. Es ist wichtig zu verstehen, wann und wo dieser verwendet wird, um korrekte Anrufweiterleitungen und -steuerungen sicherzustellen.
Match Patterns ohne Unterstrich
In den Outbound Routes (ausgehende Routen) werden Match Patterns ohne den Unterstrich (_) eingegeben. FreePBX fügt den Unterstrich automatisch im Backend hinzu, wenn ein Pattern-Matching erforderlich ist. Dies erleichtert die Konfiguration, da der Administrator sich nicht manuell um den Unterstrich kümmern muss.
Beispiel:
Für lokale Nummern wird einfach NXXXXXXX verwendet, anstatt _NXXXXXXX.
Konfigurationsschritte:
- Navigieren zu Outbound Routes: Melden Sie sich im FreePBX-Dashboard an und gehen Sie zu Connectivity > Outbound Routes.
- Erstellen oder Bearbeiten einer Outbound Route: Klicken Sie auf Add Outbound Route oder wählen Sie eine bestehende Route aus.
- Festlegen des Match Patterns: Im Feld Dial Patterns geben Sie das Muster ohne Unterstrich ein, z.B.,
NXXXXXXX. - Set Destination definieren: Wählen Sie den gewünschten Trunk oder die Ziel-Destination für diese Route.
- Speichern und Anwenden: Klicken Sie auf Submit und dann auf Apply Config.
Match Patterns mit Unterstrich
In bestimmten Kontexten wie Caller ID (CID) Feldern oder benutzerdefinierten Dialplan-Skripten können Match Patterns mit einem Unterstrich (_) verwendet werden. Der Unterstrich signalisiert Asterisk, dass das folgende Muster als regulärer Ausdruck interpretiert werden soll.
Erstellung von Match Patterns in FreePBX
Die Erstellung von Match Patterns in FreePBX erfolgt über die Weboberfläche. Eine strukturierte Vorgehensweise stellt sicher, dass die Muster effektiv und sicher funktionieren.
Schritt-für-Schritt Anleitung
Anforderungen definieren:
Beginnen Sie mit einer gründlichen Analyse der benötigten Nummernarten. Bestimmen Sie, welche Arten von Nummern (z.B. lokale Nummern, interne Durchwahlen) behandelt werden sollen und identifizieren Sie die Zielgruppen.
Platzhalter auswählen:
Entscheiden Sie, welche Platzhalter am besten zu Ihren Anforderungen passen. Nutzen Sie N, Z, X entsprechend den Ziffernbeschränkungen und verwenden Sie [ ], um spezifische Gruppen zu definieren.
Ggf. feste Zeichen integrieren:
Fügen Sie feste Zeichen wie Zahlen oder das „+“ hinzu, wenn nötig.
Muster erstellen und testen:
Kombinieren Sie die ausgewählten Platzhalter und festen Zeichen zu einem vollständigen Muster. Testen Sie das Muster z.B. mit dem oben auf dieser Seite verfügbaren Prüftool und natürlich immer auch durch Simulation von Anrufen mit verschiedenen Nummern, um sicherzustellen, dass alles wie erwartet funktioniert.
Best Practices
Klarheit und Einfachheit:
Halten Sie die Muster so einfach wie möglich, um die Wartbarkeit zu gewährleisten. Komplexe Muster können schwer zu verstehen und zu verwalten sein.
Dokumentation:
Dokumentieren Sie jedes Muster und seine Funktion. Eine klare Dokumentation erleichtert die Nachvollziehbarkeit und zukünftige Anpassungen.
Spezifität statt Allgemeinheit:
Definieren Sie Muster so spezifisch wie möglich, um unerwünschte Übereinstimmungen zu vermeiden. Präzisere Muster reduzieren das Risiko von Fehlleitungen und Sicherheitslücken.
Verwendung von Kontexten:
Nutzen Sie unterschiedliche Inbound Routes, um verschiedene Muster für unterschiedliche Zwecke zu organisieren. Dies erhöht die Übersichtlichkeit und vereinfacht die Verwaltung.
Sicherheit berücksichtigen:
Begrenzen Sie die Anzahl der erlaubten Anrufnummern, um Missbrauch zu verhindern. Implementieren Sie Sicherheitsmaßnahmen wie Access Control Lists (ACLs) und Ratenbegrenzung.
Regelmäßige Überprüfung und Anpassung:
Überprüfen Sie die Muster regelmäßig und passen Sie sie an geänderte Anforderungen an. Eine kontinuierliche Überwachung und Anpassung stellt sicher, dass das System stets optimal funktioniert.
Offizielle Dokumentation:
