Benutzerdefinierte Aktionen in RdpGuard

• Überblick über benutzerdefinierte Aktionen
• Unterstützte benutzerdefinierte Aktionen
• Eine benutzerdefinierte Aktion hinzufügen
• Eine benutzerdefinierte Aktion bearbeiten
• Benutzerdefinierte Aktionen löschen
• Ereigniseinstellungen für benutzerdefinierte Aktionen

Mit benutzerdefinierten Aktionen kann RdpGuard bei einem Ereignis E-Mail- und Telegram-Benachrichtigungen senden, HTTP-Endpunkte aufrufen oder Skripte ausführen. Senden Sie beispielsweise eine E-Mail, wenn eine IP-Adresse gesperrt wird oder sich ein Benutzer anmeldet.

Zum Konfigurieren oder Testen benutzerdefinierter Aktionen sind Administratorrechte erforderlich, da diese Programme mit SYSTEM-Rechten ausführen können. Weitere Informationen finden Sie unter Sicherheitskorrektur für benutzerdefinierte Aktionen.

Ereignisse

Folgende Ereignisse für benutzerdefinierte Aktionen werden unterstützt:

IP gesperrt und IP entsperrt Aktionen gelten für lokal erkannte Versuche. Eine ausschließlich durch IP Cloud gesperrte Adresse löst diese Ereignisse nicht aus.

Benutzerdefinierte Aktionen

Folgende benutzerdefinierte Aktionen werden unterstützt:

• E-Mail senden
• HTTP POST senden
• Programm ausführen
• An AbuseIPDB melden
• Telegram-Nachricht senden

Variablen

Sie können folgende Variablen im E-Mail-Betreff und -Text, im HTTP-POST-Endpunkt und -Text, in Telegram-Nachrichten oder als Argumente für die Programmausführung verwenden:

• %IP% - IP-Adresse
• %USER% - Benutzername
• %DOMAIN% - Windows-Domäne
• %BLOCK_DATE% - Datum und Uhrzeit der Sperrung in der lokalen Zeitzone des Servers
• %UNBLOCK_DATE% - Datum und Uhrzeit der Entsperrung in der lokalen Zeitzone des Servers
• %BLOCK_DATE_UTC% - Datum und Uhrzeit der Sperrung in UTC (ISO 8601)
• %UNBLOCK_DATE_UTC% - Datum und Uhrzeit der Entsperrung in UTC (ISO 8601)
• %PROTOCOL% - Protokoll (Grund)
• %TOTAL_IP_BLOCKED% - Gesamtzahl aktuell gesperrter IP-Adressen
• %HOSTNAME% - Hostname des Computers, auf dem RdpGuard installiert ist
• %NEW_VERSION_NUMBER% - Nummer der neuen Version
• %NEW_VERSION_LINK% - Download-Link der neuen Version
• %MAINTENANCE_DAYS% - Verbleibende Wartungstage

Die UTC-Variablen verwenden das feste ISO-8601-Format yyyy-MM-ddTHH:mm:ssZ, beispielsweise 2026-09-14T09:30:00Z. Das abschließende Z steht für UTC. Dieses Format hängt nicht von den Regionseinstellungen des Servers ab. Die vorhandenen %BLOCK_DATE% und %UNBLOCK_DATE% Variablen behalten ihre lokale Zeit und das regionale Datums- und Uhrzeitformat bei.

Beide Variablen für das Entsperrdatum geben den geplanten Zeitpunkt der automatischen Entsperrung an.

E-Mail senden

Diese benutzerdefinierte Aktion sendet eine E-Mail über einen vorkonfigurierten SMTP-Server.

Folgende Konfigurationsfelder sind verfügbar:

SMTP-Server - Wählen Sie in dieser Auswahlliste den SMTP-Server zum Senden von E-Mails aus.

Sie können SMTP-Server hinzufügen und bearbeiten mithilfe der ... Schaltfläche neben der Auswahlliste.

Von - E-Mail-Adresse des Absenders

An - E-Mail-Adresse des Empfängers

Betreff - Betreff der Nachricht; Sie können die oben beschriebenen Variablen verwenden.

Text - Nachrichtentext; Sie können die oben beschriebenen Variablen verwenden.

HTTP POST senden

Diese benutzerdefinierte Aktion sendet bei jedem Ereignis eine HTTP-POST-Anfrage an einen benutzerdefinierten Endpunkt.

Folgende Konfigurationsfelder sind verfügbar:

Endpunkt - Zielendpunkt der Anfrage. Sie können nach dem Servernamen mit einem Doppelpunkt auch den Port angeben, beispielsweise https://server.com:443/page.aspx

HTTP-Basisauthentifizierung aktivieren - Aktiviert den passwortgeschützten Zugriff auf den Endpunkt. Bei dieser Authentifizierungsart werden Benutzername und Passwort ohne eigene Verschlüsselung übertragen. Verwenden Sie deshalb bei aktivierter Option eine TLS/SSL-Verbindung.

Benutzername - Benutzername für die HTTP-Basisauthentifizierung

Passwort - Passwort für die HTTP-Basisauthentifizierung

POST-Text - HTTP-POST-Inhalt, den Sie auf dem Server empfangen möchten; Sie können die oben beschriebenen Variablen verwenden.

Programm ausführen

Führt beim ausgewählten Ereignis ein Programm oder Skript aus.

Folgende Konfigurationsfelder sind verfügbar:

Programm/Skript - Auszuführendes Programm oder Skript

Argumente - Programmargumente; Sie können die oben beschriebenen Variablen verwenden.

Zeitlimit (Sekunden) - Zeitlimit in Sekunden; 0 bedeutet unbegrenzt.

Programm bei Zeitüberschreitung beenden - Aktivieren Sie diese Option, damit RdpGuard beim Erreichen des Zeitlimits versucht, das Programm zu beenden. Andernfalls protokolliert RdpGuard die Zeitüberschreitung und wartet auf das Programmende.

Bis zu acht Programme können gleichzeitig ausgeführt werden. Andere benutzerdefinierte Aktionen verwenden eine separate Warteschlange, sodass langsame Programme Benachrichtigungen nicht aufhalten.

An AbuseIPDB melden

Meldet gesperrte IP-Adressen an AbuseIPDB. Diese Aktion ist nur für folgendes Ereignis verfügbar: IP gesperrt Ereignis.

Folgende Konfigurationsfelder sind verfügbar:

API-Schlüssel - Geben Sie Ihren AbuseIPDB-API-Schlüssel ein.

Telegram-Nachricht senden

Diese benutzerdefinierte Aktion sendet eine Nachricht an einen Telegram-Chat oder -Kanal.

Folgende Konfigurationsfelder sind verfügbar:

• Bot-Token - Geben Sie Ihr Telegram-Bot-Token ein
• Chat - Wählen Sie Ihren Telegram-Chat oder Kanal aus der Auswahlliste
• Nachricht - Geben Sie die zu sendende Nachricht ein. Sie können Variablen verwenden.

Folgen Sie der Anleitung , um einen Telegram-Bot zu erstellen und dessen Token zu erhalten.

Damit ein Chat in der Auswahlliste erscheint, starten Sie einen Chat mit dem Bot und klicken Sie anschließend auf Chats abrufen.

1. Klicken Sie auf Extras, Benutzerdefinierte Aktionen/Benachrichtigungen

   

   Das Dialogfeld Benutzerdefinierte Aktionen wird geöffnet:

   

2. Klicken Sie auf Hinzufügen (oder drücken Sie Einfg)

   Das Dialogfeld Neue benutzerdefinierte Aktion hinzufügen wird geöffnet:

   

3. Wählen Sie Ereignis:

4. Wählen Sie Aufgabe.

5. Konfigurieren Sie die benutzerdefinierte Aktion

6. Klicken Sie auf Aktion hinzufügen und danach auf Änderungen speichern im Dialogfeld Benutzerdefinierte Aktionen .

1. Klicken Sie auf Extras, Benutzerdefinierte Aktionen/Benachrichtigungen

   

   Das Dialogfeld Benutzerdefinierte Aktionen wird geöffnet:

   

2. Wählen Sie die zu bearbeitende benutzerdefinierte Aktion und klicken Sie auf Bearbeiten (oder drücken Sie F2)

   Das Dialogfeld Benutzerdefinierte Aktion bearbeiten wird geöffnet:

   

3. Bearbeiten benutzerdefinierte Aktion Parameter

4. Klicken Sie auf Änderungen speichern im Editor und anschließend erneut im Benutzerdefinierte Aktionen .

Um eine Aktion vorübergehend zu deaktivieren, entfernen Sie das Häkchen in der Tabelle und klicken Sie auf Änderungen speichern.

1. Klicken Sie auf Extras, Benutzerdefinierte Aktionen/Benachrichtigungen

   

   Das Dialogfeld Benutzerdefinierte Aktionen wird geöffnet:

   

2. Wählen Sie die zu löschenden benutzerdefinierten Aktionen und klicken Sie auf Löschen (oder drücken Sie Entf)

3. Klicken Sie auf Änderungen speichern im Dialogfeld Benutzerdefinierte Aktionen .

Einige Ereignisse benutzerdefinierter Aktionen sind konfigurierbar. Derzeit unterstützt das Benutzer angemeldet Ereignis zusätzliche Einstellungen.

Um die Einstellungen für das Benutzer angemeldet Ereignis zu konfigurieren, öffnen Sie das Dialogfeld Neue benutzerdefinierte Aktion hinzufügen, wählen Sie das Benutzer angemeldet Ereignis und klicken Sie auf Konfigurieren... rechts neben der Ereignisauswahlliste.

Das Dialogfeld Ausschlussregeln für erfolgreiche Anmeldungen wird geöffnet:

Hier können Sie Ausschlüsse für erfolgreiche Anmeldungen konfigurieren. Beachten Sie die Syntax der Ausschlussregeln für weitere Einzelheiten zur Regelsyntax.