RdpGuard-Plugin-API

Mit der RdpGuard-Plugin-API können Sie fehlgeschlagene Anmeldeversuche in Anwendungsprotokollen erkennen, die RdpGuard nicht direkt unterstützt. Ihr Plugin wertet Protokolleinträge aus; RdpGuard überwacht die Dateien, zählt fehlgeschlagene Versuche und sperrt IP-Adressen gemäß Ihren Einstellungen.

Erstellen Sie eine .NET-Framework-Klassenbibliothek und fügen Sie einen Verweis auf rdpguard-plugin-api.dll aus Ihrem RdpGuard-Installationsordner hinzu. Die API und das Beispiel-Plugin verwenden .NET Framework 4.5.

Implementieren Sie IExternalLogBasedEngine in einer öffentlichen Klasse mit einem parameterlosen Konstruktor. Das folgende Beispiel erhält diesen Konstruktor automatisch, da es keine Konstruktoren deklariert.

Legen Sie Ihr Plugin im Ordner Plugins innerhalb des RdpGuard-Installationsordners ab, zum Beispiel C:\Program Files\RdpGuard\Plugins.

Die Plugin-Schnittstelle:

namespace rdpguard_plugin_api {

    public interface IExternalEngine {

        string Name { get; }
        string Protocol { get; }
    }

    public interface IExternalLogBasedEngine : IExternalEngine {

        string Directory { get; }
        string FileMask { get; }

        bool IsFailedLoginAttempt(string _line, out string _ip, out string _username);
    }
}

Geben Sie true für einen fehlgeschlagenen Anmeldeversuch zurück und setzen Sie _ip auf eine gültige IP-Adresse. Setzen Sie _username auf null , wenn das Protokoll keinen Benutzernamen enthält. Geben Sie false für andere Protokolleinträge zurück.

Eine Beispielimplementierung:

using rdpguard_plugin_api;

namespace rdpguard_test_plugin {

    public class MyEngine : IExternalLogBasedEngine {

        public string Name => "TestEngine";
        public string Protocol => "MyProto";

        public string Directory => @"C:\MyApp\Logs\";
        public string FileMask => "*.log";

        public bool IsFailedLoginAttempt(string _line, out string _ip, out string _username) {

            _ip = _username = null;

            // sample log line:
            // 2020-06-22 10:29:18 AUTH-ERROR admin 66.249.65.238 Invalid+username+or+password

            var parts = _line.Split(' ');

            if (parts.Length > 5 && "AUTH-ERROR" == parts[2]) {
                _username = parts[3];
                _ip = parts[4];
                return true;
            }

            return false;
        }
    }
}

Kompilieren Sie Ihr Plugin und kopieren Sie die erzeugte DLL nach C:\Program Files\RdpGuard\Plugins (oder in den Ordner Plugins in Ihrem gewählten Installationsverzeichnis). Erstellen Sie den Ordner bei Bedarf und starten Sie den RdpGuard-Dienst anschließend neu über Extras, RdpGuard-Dienst, Neu starten.

Wählen Sie Ausführlich unter Extras, Optionen, Protokollierung und klicken Sie auf Speichern vor dem Neustart des Dienstes. Suchen Sie im Protokoll nach dieser Meldung:

ExternalLogBasedEngine::TestEngine started (C:\MyApp\Logs\)

Diese Meldung bestätigt, dass das Plugin gestartet wurde. Erzeugen Sie zum Testen neue fehlgeschlagene Anmeldeversuche in Ihrer Anwendung und prüfen Sie, ob RdpGuard sie erfasst.

Kontaktieren Sie uns, wenn Sie Hilfe mit Ihrem Plugin benötigen.