API de plugins RdpGuard

Utilisez l'API de plugins pour détecter les échecs dans les journaux non pris en charge nativement. Votre plugin analyse les entrées ; RdpGuard surveille les fichiers, compte les échecs et bloque les IP selon vos paramètres.

Créez une bibliothèque de classes .NET Framework et référencez rdpguard-plugin-api.dll depuis le dossier RdpGuard. L'API et l'exemple ciblent .NET Framework 4.5.

Implémentez IExternalLogBasedEngine dans une classe publique avec constructeur sans paramètre. L'exemple ci-dessous en reçoit un automatiquement, car il ne déclare aucun constructeur.

Placez le plugin dans le sous-dossier Plugins de RdpGuard, par exemple C:\Program Files\RdpGuard\Plugins.

Voici l'interface du plugin :

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);
    }
}

Renvoyez true pour un échec et affectez une IP valide à _ip. Affectez _username à null si le journal ne contient pas de nom d'utilisateur. Renvoyez false pour les autres entrées.

Exemple d'implémentation :

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;
        }
    }
}

Compilez le plugin et copiez la DLL dans C:\Program Files\RdpGuard\Plugins (ou le sous-dossier Plugins de votre installation). Créez-le si nécessaire, puis redémarrez le service via Outils, Service RdpGuard, Redémarrer.

Sélectionnez le niveau Détaillé dans Outils, Options, Journaux et cliquez sur Enregistrer avant le redémarrage. Recherchez ce message :

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

Ce message confirme le démarrage du plugin. Pour tester la détection, provoquez de nouveaux échecs dans votre application et vérifiez leur enregistrement par RdpGuard.

Contactez-nous si vous avez besoin d'aide pour votre plugin.